Skip to main content

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?

  1. stdio (lokal, rekommenderas för skrivbord)
  2. HTTP/SSE (fjärr, multitenant)
  3. 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?

  1. Starta om Claude Desktop helt (Cmd+Q på macOS)
  2. Kontrollera att konfigurationsfilen är giltig JSON
  3. Verifiera att Node.js 18+ är installerat
  4. 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?

  1. Kör MCP-server manuellt: npx -y synapse-mcp-api@latest
  2. Kontrollera klientloggar (varierar per klient)
  3. Verifiera att Mind Key fungerar: curl -H "Authorization: Bearer mk_..." .../memory/recall
  4. 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-api

Hur 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

Se Anpassad MCP-klient.

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

Nästa steg