Skip to main content

Czym jest MCP?

Model Context Protocol pozwala LLM wywoływać zewnętrzne narzędzia. Synapse udostępnia 79 narzędzi przez oficjalny serwer MCP.


Czym jest MCP?

Model Context Protocol (MCP) to otwarty standard Anthropic (2024), który pozwala LLM wywoływać zewnętrzne narzędzia w ustrukturyzowany sposób. Zamiast wklejać dokumentację API do promptu, rejestruje się narzędzia w serwerze MCP, a LLM wywołuje je w razie potrzeby — jak function calling, ale ustandaryzowane i niezależne od klienta.

Serwer Synapse MCP

Synapse dostarcza oficjalny serwer MCP (synapse-mcp-api na npm), który udostępnia 79 narzędzi obejmujących wszystkie funkcje Synapse:

Kategoria Narzędzia Liczba
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
Łącznie 79+

Jak to działa

┌──────────────────┐    MCP protocol    ┌──────────────────┐    HTTP    ┌──────────┐
│  LLM Client      │ ◀─────────────────▶│  Synapse MCP     │ ─────────▶ │ Synapse  │
│ (Claude/Cursor)  │   (stdio/SSE/WS)   │  Server          │            │ API      │
└──────────────────┘                    └──────────────────┘            └──────────┘
  1. Konfiguruje się klienta LLM (Claude Desktop, Cursor itp.) do używania serwera Synapse MCP
  2. Klient uruchamia serwer MCP (przez npx -y synapse-mcp-api@latest)
  3. Serwer MCP łączy się z API Synapse przy użyciu Mind Key
  4. LLM widzi wszystkie 79 narzędzi jako natywne funkcje, które może wywoływać
  5. Gdy LLM musi coś zapamiętać, wywołuje memory_store — serwer MCP tłumaczy to na POST /memory w Synapse

Transporty

Serwer Synapse MCP obsługuje trzy transporty:

stdio (lokalny, zalecany dla komputerów biurkowych)

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

HTTP/SSE (zdalny, wielodostępny)

Podłączyć klienta MCP do:

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

WebSocket (mobilny, duży ruch)

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

Profile narzędzi (v1.4.0)

Aby zmniejszyć narzut tokenów dla mniejszych LLM, serwer MCP obsługuje trzy profile narzędzi:

Profil Narzędzia Tokeny Najlepsze dla
minimal 8 (kompozytowe dyspozytor) około 500 Self-hostowane LLM z kontekstem ≤8k
standard 25 (nazwane) około 2 500 Średnie LLM (Claude Haiku, GPT-3.5)
full 119 (wszystkie) około 8 250 Duże LLM (Claude Sonnet/Opus, GPT-4) — domyślnie

Kontrola przez:

  • Zmienna środowiskowa: MCP_PROFILE=minimal|standard|full
  • Nagłówek: Mcp-Tool-Profile: minimal|standard|full

Obsługiwani klienci

Dlaczego używać MCP zamiast bezpośredniego API?

Podejście Zalety Wady
Bezpośrednie API Proste, bez dodatkowej warstwy LLM musi znać URL-e, nagłówki, autoryzację
MCP LLM widzi natywne narzędzia, bez zapamiętywania URL-i Dodatkowy proces serwera MCP

Dla większości przypadków użycia agentów LLM MCP jest lepszym wyborem — LLM nie musi pamiętać ścieżek API ani wzorców autoryzacji.

Następne kroki