Skip to main content

Vad är MCP?

Model Context Protocol låter LLM:er anropa externa verktyg. Synapse exponerar 79 verktyg via officiell MCP-server.


Vad är MCP?

Model Context Protocol (MCP) är en öppen standard av Anthropic (2024) som låter LLM:er anropa externa verktyg på ett strukturerat sätt. Istället för att klistra in API-dokumentation i prompten registrerar ni verktyg hos MCP-servern, och LLM:en anropar dem vid behov — som funktionsanrop, men standardiserat och klientoberoende.

Synapse MCP-server

Synapse levererar en officiell MCP-server (synapse-mcp-api på npm) som exponerar 79 verktyg som täcker alla Synapse-funktioner:

Kategori Verktyg Antal
Memory recall, list, store, search, semantic-search, update, delete, bulk-delete, stats, unverified, contradictions, audit, related, by-tag, diff, expiring, health, sync, embed-batch, verify, unverify, mind-export 22
Chat poll, reply, status, history, unread, send, upload 7
Scheduler cron_list, cron_create, cron_delete, cron_toggle, var_list, var_get, var_set, var_delete 8
Tasks task_list, task_get, task_create, task_update 4
Scripts script_list, script_get, script_info, script_store, script_delete 5
Computers computer_list, computer_get, install_code, screenshot, command_queue, command_status, commands_list, disable, delete 9
Push vapid_public_key, subscribe, unsubscribe, test 4
User/Mind register, login, minds_list, mind_create, mind_delete 5
Utility time, calc, random 3
Visualization graph, tags, compact 3
Sharing share, list, revoke 3
Webhooks register, list, get, update, delete 5
Browser new, navigate, click, type, screenshot, close 6
Totalt 79+

Hur det fungerar

┌──────────────────┐    MCP protocol    ┌──────────────────┐    HTTP    ┌──────────┐
│  LLM Client      │ ◀─────────────────▶│  Synapse MCP     │ ─────────▶ │ Synapse  │
│ (Claude/Cursor)  │   (stdio/SSE/WS)   │  Server          │            │ API      │
└──────────────────┘                    └──────────────────┘            └──────────┘
  1. Ni konfigurerar er LLM-klient (Claude Desktop, Cursor etc.) för att använda Synapse MCP-server
  2. Klienten startar MCP-servern (via npx -y synapse-mcp-api@latest)
  3. MCP-servern ansluter till Synapse API med er Mind Key
  4. LLM:en ser alla 79 verktyg som inbyggda funktioner den kan anropa
  5. När LLM:en behöver minna något anropar den memory_store — MCP-servern översätter detta till POST /memory på Synapse

Transporter

Synapse MCP-server stöder tre transporter:

stdio (lokal, rekommenderas för skrivbord)

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

HTTP/SSE (fjärr, multitenant)

Anslut er MCP-klient till:

URL: https://synapse-mcp.schaefer.zone/sse
Headers: Authorization: Bearer YOUR_MIND_KEY

WebSocket (mobil, hög volym)

URL: wss://synapse-mcp.schaefer.zone/ws?mind_key=YOUR_MIND_KEY

Verktygsprofiler (v1.4.0)

För att minska token-overhead för mindre LLM:er stöder MCP-servern tre verktygsprofiler:

Profil Verktyg Tokens Bäst för
minimal 8 (sammansatt dispatch) ~500 Egenvärd LLM:er med ≤8k kontext
standard 25 (namngivna) ~2 500 Medelstora LLM:er (Claude Haiku, GPT-3.5)
full 119 (alla) ~8 250 Stora LLM:er (Claude Sonnet/Opus, GPT-4) — standard

Styr via:

  • Miljövariabel: MCP_PROFILE=minimal|standard|full
  • Header: Mcp-Tool-Profile: minimal|standard|full

Klienter som stöds

Varför använda MCP istället för direkt API?

Ansats Fördelar Nackdelar
Direkt API Enkelt, inget extra lager LLM behöver veta URL:er, headers, auth
MCP LLM ser inbyggda verktyg, ingen URL-memorering Extra MCP-serverprocess

För de flesta LLM-agent-användningsområden är MCP det bättre valet — LLM:en behöver inte minnas API-sökvägar eller auth-mönster.

Nästa steg