# 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?](/docs/mcp/what-is-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?](/docs/mcp/what-is-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](/docs/mcp/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`:

```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](/docs/mcp/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](/docs/mcp/troubleshooting).

## ¿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](/docs/mcp/troubleshooting).

## ¿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í:

```bash
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](/docs/mcp/custom-client).

## ¿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?](/docs/mcp/what-is-mcp)
- [Configuración de Claude Desktop](/docs/mcp/claude-desktop)
- [Solución de problemas de MCP](/docs/mcp/troubleshooting)