MCP FAQ
Vanliga frågor om MCP-integration — verktyg, transporter, felsökning.
MCP FAQ
Vanliga frågor om Synapse MCP-server.
Vad är MCP?
MCP (Model Context Protocol) är en öppen standard av Anthropic för LLM-verktygsintegration. Istället för att klistra in API-dokumentation i prompter registrerar ni verktyg hos en MCP-server, och LLM:en anropar dem som inbyggda funktioner.
Se Vad är MCP?.
Hur många verktyg exponerar Synapse MCP?
79 verktyg i 12 kategorier: minne, chatt, schemaläggare, uppgifter, skript, datorer, push, användare, verktyg, visualisering, delning, webhooks, webbläsare.
Se Vad är MCP? för fullständig lista.
Vilka MCP-klienter stöds?
- Claude Desktop (macOS, Windows)
- Claude Code (terminal)
- Cursor (IDE)
- Continue.dev (VS Code, JetBrains)
- Cline (VS Code)
- Vilken MCP-kompatibel klient som helst
Se Claude Desktop-konfiguration för konfigurationsexempel.
Vilka transporter stöds?
- stdio (lokal, rekommenderas för skrivbord)
- HTTP/SSE (fjärr, multitenant)
- WebSocket (mobil, hög volym)
Hur konfigurerar jag Claude Desktop?
Redigera 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"
}
}
}
}Se Claude Desktop-konfiguration.
Varför visas inte verktyg i Claude Desktop?
- Starta om Claude Desktop helt (Cmd+Q på macOS)
- Kontrollera att konfigurationsfilen är giltig JSON
- Verifiera att Node.js 18+ är installerat
- Kontrollera MCP-loggar:
~/Library/Logs/Claude/mcp.log
Se MCP-felsökning.
Hur använder jag en annan mind?
Ändra SYNAPSE_MIND_KEY i er MCP-konfiguration och starta om klienten.
För flera minds, kör flera MCP-serverinstanser med olika Mind Keys.
Kan jag begränsa vilka verktyg som exponeras?
Ja, använd verktygsprofiler:
minimal: 8 sammansatta verktyg (~500 tokens)standard: 25 verktyg (~2 500 tokens)full: 119 verktyg (~8 250 tokens, standard)
Sätt via MCP_PROFILE-miljövariabel eller Mcp-Tool-Profile-header.
Hur felsöker jag MCP-problem?
- Kör MCP-server manuellt:
npx -y synapse-mcp-api@latest - Kontrollera klientloggar (varierar per klient)
- Verifiera att Mind Key fungerar:
curl -H "Authorization: Bearer mk_..." .../memory/recall - Kontrollera Synapse-hälsa:
curl https://synapse.schaefer.zone/health
Se MCP-felsökning.
Är MCP-servern gratis?
Ja. npm-paketet synapse-mcp-api är öppen källkod. Den värdhostade
MCP-servern på synapse-mcp.schaefer.zone är gratis för offentligt bruk.
Kan jag köra MCP-servern egenvärd?
Ja:
npm install -g synapse-mcp-api
SYNAPSE_URL=https://your-synapse-instance.com \
SYNAPSE_MIND_KEY=mk_... \
synapse-mcp-apiHur skiljer sig MCP från direkta API-anrop?
| Aspekt | Direkt API | MCP |
|---|---|---|
| LLM behöver veta | URL:er, headers, auth | Bara verktygsnamn |
| Auth-hantering | Manuell | Automatisk (miljövariabel) |
| Verktygsupptäckt | Läs /endpoints | Automatisk via MCP-protokoll |
| Felhantering | Manuell | Standardiserad |
| Bäst för | Anpassade integrationer | LLM-agenter |
Kan jag bygga en egen MCP-klient?
Ja. Använd det officiella MCP-SDK:et:
- TypeScript:
@modelcontextprotocol/sdk - Python:
mcp
Hur rapporterar jag MCP-buggar?
Öppna ett ärende: https://gitlab.com/schaefer-services/synapse-mcp/-/issues
Inkludera:
- MCP-serverversion
- Klientnamn och version
- Operativsystem
- Relevanta loggar
- Steg för att reproducera