{"title":"MCP en Claude Code","slug":"claude-code","category":"mcp","summary":"Use las herramientas de Synapse desde el agente de terminal Claude Code — memoria persistente para sesiones de codificación.","audience":["human","llm"],"tags":["mcp","claude-code","terminal","coding"],"difficulty":"intermediate","updated":"2026-06-27","word_count":243,"read_minutes":1,"llm_context":"Claude Code config: ~/.claude/config.json (or via `claude mcp add` command)\nCommand: npx -y synapse-mcp-api@latest\nEnv: SYNAPSE_MIND_KEY (required), SYNAPSE_URL (optional)\nAlternative: `claude mcp add synapse -- npx -y synapse-mcp-api@latest`\nThen: set SYNAPSE_MIND_KEY env var in your shell\nTest: in claude code, type \"recall all my memories\"\n","lang":"es","translated":true,"requested_lang":"es","content_markdown":"\n# MCP en Claude Code\n\nClaude Code es el agente de codificación basado en terminal de Anthropic. Con\nSynapse MCP, Claude Code gana memoria persistente entre sesiones de codificación\n— recuerda el contexto del proyecto, decisiones pasadas y patrones del\ncodebase.\n\n## Configuración\n\n### Método 1: Comando CLI (recomendado)\n\n```bash\n# Add Synapse as an MCP server\nclaude mcp add synapse -- npx -y synapse-mcp-api@latest\n\n# Set your Mind Key as env var (add to ~/.bashrc or ~/.zshrc)\nexport SYNAPSE_MIND_KEY=\"mk_YOUR_MIND_KEY_HERE\"\nexport SYNAPSE_URL=\"https://synapse.schaefer.zone\" # optional, defaults to synapse.schaefer.zone\n```\n\n### Método 2: Editar archivo de configuración\n\nEdite `~/.claude/config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"synapse\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"synapse-mcp-api@latest\"],\n \"env\": {\n \"SYNAPSE_MIND_KEY\": \"mk_YOUR_MIND_KEY_HERE\",\n \"SYNAPSE_URL\": \"https://synapse.schaefer.zone\"\n }\n }\n }\n}\n```\n\n## Verifique que funciona\n\nInicie Claude Code:\n\n```bash\nclaude\n```\n\nEn el prompt de Claude Code, escriba:\n\n```\nrecall all my memories\n```\n\nClaude debería llamar a `memory_recall` y responder con sus memorias\nalmacenadas.\n\n## Patrones comunes\n\n### Persistencia del contexto del proyecto\n\nAl inicio de una sesión de codificación:\n\n```\nrecalling my memories — what projects am I working on?\n```\n\nClaude llama a `memory_recall`, ve su lista de proyectos y continúa el trabajo\ndonde lo dejó.\n\n### Decisiones del codebase\n\nCuando tome una decisión arquitectónica:\n\n```\nstore this: \"We chose PostgreSQL over SQLite because of concurrent write\nperformance. Decision made on 2026-06-27.\"\n```\n\nClaude llama a `memory_store` con la categoría `project`, prioridad `high`.\n\n### Evitar errores pasados\n\n```\nwhat mistakes have I made with this codebase?\n```\n\nClaude busca memorias con categoría `mistake` y le recuerda los errores\npasados.\n\n### Seguimiento de tareas\n\n```\ncreate a task: \"Refactor auth module to use JWT refresh tokens\"\n```\n\nClaude llama a `task_create`, y la tarea persiste entre sesiones.\n\n## Tool Profiles\n\nPara sesiones de codificación donde no necesita las 119 herramientas:\n\n```bash\n# Set profile via env var\nexport MCP_PROFILE=\"standard\" # 25 tools, ~2500 tokens\n\n# Or in config.json\n\"env\": {\n \"SYNAPSE_MIND_KEY\": \"mk_...\",\n \"MCP_PROFILE\": \"standard\"\n}\n```\n\n## Solución de problemas\n\n### El servidor MCP no arranca\n\n```bash\n# Test the MCP server manually\nnpx -y synapse-mcp-api@latest\n\n# Should print:\n# [info] synapse-mcp Streamable HTTP server ready\n# [info] MCP: http://localhost:13100/mcp\n```\n\n### Mind Key no reconocido\n\n```bash\n# Verify env var is set\necho $SYNAPSE_MIND_KEY\n\n# Test directly\ncurl -H \"Authorization: Bearer $SYNAPSE_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/recall\n```\n\n### Claude Code no ve las herramientas\n\n- Reinicie Claude Code tras cambios de configuración\n- Compruebe `claude mcp list` para verificar que Synapse está registrado\n- Consulte [Solución de problemas de MCP](/docs/mcp/troubleshooting)\n\n## Próximos pasos\n\n- [Configuración de Claude Desktop](/docs/mcp/claude-desktop)\n- [Configuración de Cursor](/docs/mcp/cursor)\n- [Guía de agente LLM persistente](/docs/guides/persistent-llm-agent)\n","content_html":"

MCP en Claude Code

\n

Claude Code es el agente de codificación basado en terminal de Anthropic. Con\nSynapse MCP, Claude Code gana memoria persistente entre sesiones de codificación\n— recuerda el contexto del proyecto, decisiones pasadas y patrones del\ncodebase.

\n

Configuración

\n

Método 1: Comando CLI (recomendado)

\n
# Add Synapse as an MCP server\nclaude mcp add synapse -- npx -y synapse-mcp-api@latest\n\n# Set your Mind Key as env var (add to ~/.bashrc or ~/.zshrc)\nexport SYNAPSE_MIND_KEY="mk_YOUR_MIND_KEY_HERE"\nexport SYNAPSE_URL="https://synapse.schaefer.zone"  # optional, defaults to synapse.schaefer.zone

Método 2: Editar archivo de configuración

\n

Edite ~/.claude/config.json:

\n
{\n  "mcpServers": {\n    "synapse": {\n      "command": "npx",\n      "args": ["-y", "synapse-mcp-api@latest"],\n      "env": {\n        "SYNAPSE_MIND_KEY": "mk_YOUR_MIND_KEY_HERE",\n        "SYNAPSE_URL": "https://synapse.schaefer.zone"\n      }\n    }\n  }\n}

Verifique que funciona

\n

Inicie Claude Code:

\n
claude

En el prompt de Claude Code, escriba:

\n
recall all my memories

Claude debería llamar a memory_recall y responder con sus memorias\nalmacenadas.

\n

Patrones comunes

\n

Persistencia del contexto del proyecto

\n

Al inicio de una sesión de codificación:

\n
recalling my memories — what projects am I working on?

Claude llama a memory_recall, ve su lista de proyectos y continúa el trabajo\ndonde lo dejó.

\n

Decisiones del codebase

\n

Cuando tome una decisión arquitectónica:

\n
store this: "We chose PostgreSQL over SQLite because of concurrent write\nperformance. Decision made on 2026-06-27."

Claude llama a memory_store con la categoría project, prioridad high.

\n

Evitar errores pasados

\n
what mistakes have I made with this codebase?

Claude busca memorias con categoría mistake y le recuerda los errores\npasados.

\n

Seguimiento de tareas

\n
create a task: "Refactor auth module to use JWT refresh tokens"

Claude llama a task_create, y la tarea persiste entre sesiones.

\n

Tool Profiles

\n

Para sesiones de codificación donde no necesita las 119 herramientas:

\n
# Set profile via env var\nexport MCP_PROFILE="standard"  # 25 tools, ~2500 tokens\n\n# Or in config.json\n"env": {\n  "SYNAPSE_MIND_KEY": "mk_...",\n  "MCP_PROFILE": "standard"\n}

Solución de problemas

\n

El servidor MCP no arranca

\n
# Test the MCP server manually\nnpx -y synapse-mcp-api@latest\n\n# Should print:\n# [info] synapse-mcp Streamable HTTP server ready\n# [info]   MCP:      http://localhost:13100/mcp

Mind Key no reconocido

\n
# Verify env var is set\necho $SYNAPSE_MIND_KEY\n\n# Test directly\ncurl -H "Authorization: Bearer $SYNAPSE_MIND_KEY" \\\n     https://synapse.schaefer.zone/memory/recall

Claude Code no ve las herramientas

\n\n

Próximos pasos

\n\n","urls":{"html":"/docs/mcp/claude-code","text":"/docs/mcp/claude-code?format=text","json":"/docs/mcp/claude-code?format=json","llm":"/docs/mcp/claude-code?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}