# FAQ MCP

Questions courantes sur le serveur MCP Synapse.

## Qu'est-ce que MCP ?

MCP (Model Context Protocol) est un standard ouvert d'Anthropic pour l'intégration
LLM-outil. Au lieu de coller la documentation de l'API dans les prompts, vous
enregistrez des outils auprès d'un serveur MCP, et le LLM les appelle comme des
fonctions natives.

Voir [Qu'est-ce que MCP ?](/docs/mcp/what-is-mcp).

## Combien d'outils le MCP Synapse expose-t-il ?

**79 outils** répartis en 12 catégories : memory, chat, scheduler, tasks, scripts,
computers, push, user, utility, visualization, sharing, webhooks, browser.

Voir [Qu'est-ce que MCP ?](/docs/mcp/what-is-mcp) pour la liste complète.

## Quels clients MCP sont pris en charge ?

- Claude Desktop (macOS, Windows)
- Claude Code (terminal)
- Cursor (IDE)
- Continue.dev (VS Code, JetBrains)
- Cline (VS Code)
- Tout client compatible MCP

Voir [Configuration Claude Desktop](/docs/mcp/claude-desktop) pour des exemples de
configuration.

## Quels transports sont pris en charge ?

1. **stdio** (local, recommandé pour desktop)
2. **HTTP/SSE** (distant, multi-tenant)
3. **WebSocket** (mobile, haut volume)

## Comment configurer Claude Desktop ?

Éditez `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"
      }
    }
  }
}
```

Voir [Configuration Claude Desktop](/docs/mcp/claude-desktop).

## Pourquoi les outils n'apparaissent-ils pas dans Claude Desktop ?

1. **Redémarrez Claude Desktop complètement** (Cmd+Q sur macOS)
2. **Vérifiez que le fichier de config est du JSON valide**
3. **Vérifiez Node.js 18+** installé
4. **Consultez les logs MCP** : `~/Library/Logs/Claude/mcp.log`

Voir [Dépannage MCP](/docs/mcp/troubleshooting).

## Comment utiliser un mind différent ?

Changez `SYNAPSE_MIND_KEY` dans votre config MCP et redémarrez le client.

Pour plusieurs minds, exécutez plusieurs instances du serveur MCP avec différentes
Mind Keys.

## Puis-je limiter les outils exposés ?

Oui, utilisez les **Tool Profiles** :

- `minimal` : 8 outils composites (~500 tokens)
- `standard` : 25 outils (~2 500 tokens)
- `full` : 119 outils (~8 250 tokens, par défaut)

Définissez via la variable d'environnement `MCP_PROFILE` ou l'en-tête
`Mcp-Tool-Profile`.

## Comment déboguer les problèmes MCP ?

1. **Exécutez le serveur MCP manuellement** : `npx -y synapse-mcp-api@latest`
2. **Consultez les logs client** (varie selon le client)
3. **Vérifiez que la Mind Key fonctionne** : `curl -H "Authorization: Bearer mk_..." .../memory/recall`
4. **Vérifiez la santé de Synapse** : `curl https://synapse.schaefer.zone/health`

Voir [Dépannage MCP](/docs/mcp/troubleshooting).

## Le serveur MCP est-il gratuit ?

Oui. Le paquet npm `synapse-mcp-api` est open source. Le serveur MCP hébergé sur
`synapse-mcp.schaefer.zone` est gratuit pour un usage public.

## Puis-je auto-héberger le serveur MCP ?

Oui :

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

## En quoi MCP diffère-t-il des appels API directs ?

| Aspect | API directe | MCP |
|--------|-----------|-----|
| Le LLM doit connaître | URLs, en-têtes, auth | Juste les noms d'outils |
| Gestion de l'auth | Manuelle | Automatique (var d'env) |
| Découverte des outils | Lire /endpoints | Automatique via protocole MCP |
| Gestion des erreurs | Manuelle | Standardisée |
| Idéal pour | Intégrations personnalisées | Agents LLM |

## Puis-je construire mon propre client MCP ?

Oui. Utilisez le SDK MCP officiel :

- TypeScript : `@modelcontextprotocol/sdk`
- Python : `mcp`

Voir [Client MCP personnalisé](/docs/mcp/custom-client).

## Comment signaler des bugs MCP ?

Ouvrez un ticket : <https://gitlab.com/schaefer-services/synapse-mcp/-/issues>

Incluez :

- Version du serveur MCP
- Nom et version du client
- Système d'exploitation
- Logs pertinents
- Étapes pour reproduire

## Prochaines étapes

- [Qu'est-ce que MCP ?](/docs/mcp/what-is-mcp)
- [Configuration Claude Desktop](/docs/mcp/claude-desktop)
- [Dépannage MCP](/docs/mcp/troubleshooting)