{"title":"MCP en Claude Desktop","slug":"claude-desktop","category":"mcp","summary":"Conecte Synapse a Claude Desktop en 2 minutos. Claude obtiene 79 herramientas de Synapse de forma nativa.","audience":["human","llm"],"tags":["mcp","claude","desktop","integration"],"difficulty":"beginner","updated":"2026-06-27","word_count":437,"read_minutes":2,"llm_context":"Config file: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)\n %APPDATA%\\Claude\\claude_desktop_config.json (Windows)\nMCP server command: npx -y synapse-mcp-api@latest\nEnv vars: SYNAPSE_MIND_KEY (required), SYNAPSE_URL (optional, default https://synapse.schaefer.zone)\nAfter config: restart Claude Desktop, check for 🔌 icon with \"79 tools\"\nTest: type \"memory_recall aufrufen\" in a new chat\nTroubleshooting: Node.js ≥ 18, check Mind Key, see /docs/mcp/troubleshooting\n","lang":"es","translated":true,"requested_lang":"es","content_markdown":"\n# MCP en Claude Desktop\n\nClaude Desktop es la app de escritorio de Anthropic para macOS y Windows. Con\nel servidor MCP de Synapse configurado, Claude obtiene acceso nativo a las 79\nherramientas de Synapse — puede almacenar memorias, recuperarlas, gestionar\ntareas, chatear con usted y más.\n\n## Requisitos previos\n\n- App Claude Desktop (macOS o Windows)\n- Node.js 18+ instalado (`node --version`)\n- Su Mind Key de Synapse\n\n## Paso 1: Abrir el archivo de configuración\n\n- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\nSi el archivo no existe, créelo.\n\n## Paso 2: Añadir el servidor MCP de Synapse\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> [!TIP]\n> Si ya tiene otros servidores MCP configurados, simplemente añada el bloque\n> `\"synapse\"` dentro del objeto `\"mcpServers\"` existente.\n\n## Paso 3: Reiniciar Claude Desktop\n\n1. Cierre Claude Desktop completamente (Cmd+Q en macOS, no solo cerrar la ventana)\n2. Vuelva a abrir Claude Desktop\n3. Inicie un nuevo chat\n4. Busque el icono de enchufe 🔌 en la parte inferior izquierda — debería decir \"79 tools\"\n\n## Paso 4: Probarlo\n\nEn un nuevo chat, escriba:\n\n```\nmemory_recall aufrufen\n```\n\nClaude debería llamar a la herramienta `memory_recall` y responder con un\nresumen de sus memorias almacenadas (o \"No memories yet\" si su mind está\nvacío).\n\n## Herramientas disponibles (selección)\n\n| Herramienta | Descripción |\n|------|-------------|\n| `memory_recall` | Recupera todas las memorias |\n| `memory_store` | Almacena una nueva memoria |\n| `memory_search` | Busca memorias |\n| `task_list` | Lista tareas |\n| `task_create` | Crea una tarea |\n| `chat_poll` | Comprueba si hay mensajes nuevos |\n| `chat_reply` | Responde a un mensaje |\n| `browser_new` | Abre una pestaña del navegador |\n| `computer_list` | Lista las computadoras registradas |\n\nLista completa: [¿Qué es MCP?](/docs/mcp/what-is-mcp)\n\n## Solución de problemas\n\n### No aparecen herramientas en Claude Desktop\n\n1. Verifique la versión de Node.js: `node --version` (debe ser ≥ 18)\n2. Compruebe que el archivo de configuración es JSON válido (sin comas finales)\n3. Reinicie Claude Desktop completamente (Cmd+Q, no solo cerrar)\n4. Revise los logs de Claude Desktop: `~/Library/Logs/Claude/mcp.log` (macOS)\n\n### Error \"Mind Key invalid\"\n\n- Verifique que `SYNAPSE_MIND_KEY` empieza por `mk_`\n- Obtenga una nueva clave vía `POST /minds` (requiere JWT de `/login`)\n- Sin comillas alrededor de la clave en el JSON\n\n### npx no encontrado\n\n- Instale Node.js 18+: \n- Reinicie el terminal tras la instalación\n- En macOS con Homebrew: `brew install node`\n\n### Las herramientas aparecen pero las llamadas fallan\n\n- Compruebe que `SYNAPSE_URL` es alcanzable: `curl https://synapse.schaefer.zone/health`\n- Verifique que su Mind Key funciona: `curl -H \"Authorization: Bearer mk_...\" https://synapse.schaefer.zone/memory/recall`\n- Consulte [Solución de problemas de MCP](/docs/mcp/troubleshooting)\n\n## Tool Profiles (ahorro de tokens)\n\nSi está usando un LLM más pequeño o quiere ahorrar tokens de contexto,\nestablezca un tool profile:\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_...\",\n \"SYNAPSE_URL\": \"https://synapse.schaefer.zone\",\n \"MCP_PROFILE\": \"standard\"\n }\n }\n }\n}\n```\n\nPerfiles: `minimal` (8 herramientas), `standard` (25), `full` (119,\npredeterminado).\n\n## Próximos pasos\n\n- [Configuración de Claude Code](/docs/mcp/claude-code)\n- [Configuración de Cursor](/docs/mcp/cursor)\n- [Solución de problemas de MCP](/docs/mcp/troubleshooting)\n","content_html":"

MCP en Claude Desktop

\n

Claude Desktop es la app de escritorio de Anthropic para macOS y Windows. Con\nel servidor MCP de Synapse configurado, Claude obtiene acceso nativo a las 79\nherramientas de Synapse — puede almacenar memorias, recuperarlas, gestionar\ntareas, chatear con usted y más.

\n

Requisitos previos

\n\n

Paso 1: Abrir el archivo de configuración

\n\n

Si el archivo no existe, créelo.

\n

Paso 2: Añadir el servidor MCP de Synapse

\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}
Si ya tiene otros servidores MCP configurados, simplemente añada el bloque\n`\"synapse\"` dentro del objeto `\"mcpServers\"` existente.

Paso 3: Reiniciar Claude Desktop

\n
    \n
  1. Cierre Claude Desktop completamente (Cmd+Q en macOS, no solo cerrar la ventana)
    2. \n
  2. Vuelva a abrir Claude Desktop
    3. \n
  3. Inicie un nuevo chat
    4. \n
  4. Busque el icono de enchufe 🔌 en la parte inferior izquierda — debería decir "79 tools"
    5. \n
\n

Paso 4: Probarlo

\n

En un nuevo chat, escriba:

\n
memory_recall aufrufen

Claude debería llamar a la herramienta memory_recall y responder con un\nresumen de sus memorias almacenadas (o "No memories yet" si su mind está\nvacío).

\n

Herramientas disponibles (selección)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
HerramientaDescripción
memory_recallRecupera todas las memorias
memory_storeAlmacena una nueva memoria
memory_searchBusca memorias
task_listLista tareas
task_createCrea una tarea
chat_pollComprueba si hay mensajes nuevos
chat_replyResponde a un mensaje
browser_newAbre una pestaña del navegador
computer_listLista las computadoras registradas
\n

Lista completa: ¿Qué es MCP?

\n

Solución de problemas

\n

No aparecen herramientas en Claude Desktop

\n
    \n
  1. Verifique la versión de Node.js: node --version (debe ser ≥ 18)
    2. \n
  2. Compruebe que el archivo de configuración es JSON válido (sin comas finales)
    3. \n
  3. Reinicie Claude Desktop completamente (Cmd+Q, no solo cerrar)
    4. \n
  4. Revise los logs de Claude Desktop: ~/Library/Logs/Claude/mcp.log (macOS)
    5. \n
\n

Error "Mind Key invalid"

\n\n

npx no encontrado

\n\n

Las herramientas aparecen pero las llamadas fallan

\n\n

Tool Profiles (ahorro de tokens)

\n

Si está usando un LLM más pequeño o quiere ahorrar tokens de contexto,\nestablezca un tool profile:

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

Perfiles: minimal (8 herramientas), standard (25), full (119,\npredeterminado).

\n

Próximos pasos

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