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 │
└──────────────────┘ └──────────────────┘ └──────────┘- Konfiguruje się klienta LLM (Claude Desktop, Cursor itp.) do używania serwera Synapse MCP
- Klient uruchamia serwer MCP (przez
npx -y synapse-mcp-api@latest) - Serwer MCP łączy się z API Synapse przy użyciu Mind Key
- LLM widzi wszystkie 79 narzędzi jako natywne funkcje, które może wywoływać
- Gdy LLM musi coś zapamiętać, wywołuje
memory_store— serwer MCP tłumaczy to naPOST /memoryw 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_KEYWebSocket (mobilny, duży ruch)
URL: wss://synapse-mcp.schaefer.zone/ws?mind_key=YOUR_MIND_KEYProfile 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
- Claude Desktop — aplikacja biurkowa Anthropic
- Claude Code — terminalowy agent kodowania
- Cursor — IDE oparte na AI
- Continue.dev — open-source'owy asystent kodowania AI
- Cline — rozszerzenie VS Code
- Dowolny klient zgodny z MCP
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
- Konfiguracja Claude Desktop — konfiguracja w 2 minuty
- Konfiguracja Claude Code — integracja z terminalem
- Niestandardowy klient MCP — budowa własnego