FAQ de MCP

Preguntas comunes sobre el servidor MCP de Synapse.

¿Qué es MCP?

MCP (Model Context Protocol) es un estándar abierto de Anthropic para la integración de LLM con herramientas. En lugar de pegar documentación de la API en los prompts, registra herramientas con un servidor MCP, y el LLM las llama como funciones nativas.

Consulte ¿Qué es MCP?.

¿Cuántas herramientas expone Synapse MCP?

79 herramientas en 12 categorías: memory, chat, scheduler, tasks, scripts, computers, push, user, utility, visualization, sharing, webhooks, browser.

Consulte ¿Qué es MCP? para la lista completa.

¿Qué clientes MCP son compatibles?

• Claude Desktop (macOS, Windows)
• Claude Code (terminal)
• Cursor (IDE)
• Continue.dev (VS Code, JetBrains)
• Cline (VS Code)
• Cualquier cliente compatible con MCP

Consulte Configuración de Claude Desktop para ejemplos de configuración.

¿Qué transportes se admiten?

1. stdio (local, recomendado para escritorio)
2. HTTP/SSE (remoto, multi-tenant)
3. WebSocket (móvil, alto volumen)

¿Cómo configuro Claude Desktop?

Edite claude_desktop_config.json:

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

Consulte Configuración de Claude Desktop.

¿Por qué no aparecen las herramientas en Claude Desktop?

1. Reinicie Claude Desktop completamente (Cmd+Q en macOS)
2. Compruebe que el archivo de configuración es JSON válido
3. Verifique Node.js 18+ instalado
4. Revise los logs MCP: ~/Library/Logs/Claude/mcp.log

Consulte Solución de problemas de MCP.

¿Cómo uso un mind diferente?

Cambie SYNAPSE_MIND_KEY en su configuración MCP y reinicie el cliente.

Para múltiples minds, ejecute múltiples instancias del servidor MCP con diferentes Mind Keys.

¿Puedo limitar qué herramientas se exponen?

Sí, use Tool Profiles:

• minimal: 8 herramientas compuestas (~500 tokens)
• standard: 25 herramientas (~2.500 tokens)
• full: 119 herramientas (~8.250 tokens, predeterminado)

Establézcalo vía la variable de entorno MCP_PROFILE o la cabecera Mcp-Tool-Profile.

¿Cómo depuro problemas de MCP?

1. Ejecute el servidor MCP manualmente: npx -y synapse-mcp-api@latest
2. Revise los logs del cliente (varía según el cliente)
3. Verifique que el Mind Key funciona: curl -H "Authorization: Bearer mk_..." .../memory/recall
4. Compruebe la salud de Synapse: curl https://synapse.schaefer.zone/health

Consulte Solución de problemas de MCP.

¿El servidor MCP es gratuito?

Sí. El paquete npm synapse-mcp-api es de código abierto. El servidor MCP alojado en synapse-mcp.schaefer.zone es gratuito para uso público.

¿Puedo autoalojar el servidor MCP?

Sí:

npm install -g synapse-mcp-api
SYNAPSE_URL=https://your-synapse-instance.com \
SYNAPSE_MIND_KEY=mk_... \
synapse-mcp-api

¿En qué se diferencia MCP de las llamadas directas a la API?

Aspecto	API directa	MCP
El LLM necesita conocer	URLs, cabeceras, auth	Solo nombres de herramientas
Gestión de auth	Manual	Automática (variable de entorno)
Descubrimiento de herramientas	Leer /endpoints	Automático vía protocolo MCP
Manejo de errores	Manual	Estandarizado
Mejor para	Integraciones personalizadas	Agentes LLM

¿Puedo construir mi propio cliente MCP?

Sí. Use el SDK oficial de MCP:

• TypeScript: @modelcontextprotocol/sdk
• Python: mcp

Consulte Cliente MCP personalizado.

¿Cómo reporto bugs de MCP?

Abra un issue: https://gitlab.com/schaefer-services/synapse-mcp/-/issues

Incluya:

• Versión del servidor MCP
• Nombre y versión del cliente
• Sistema operativo
• Logs relevantes
• Pasos para reproducir

Próximos pasos

• ¿Qué es MCP?
• Configuración de Claude Desktop
• Solución de problemas de MCP