{"title":"Czym jest MCP?","slug":"what-is-mcp","category":"mcp","summary":"Model Context Protocol pozwala LLM wywoływać zewnętrzne narzędzia. Synapse udostępnia 79 narzędzi przez oficjalny serwer MCP.","audience":["human","llm"],"tags":["mcp","intro","overview"],"difficulty":"beginner","updated":"2026-06-27","word_count":555,"read_minutes":3,"llm_context":"MCP = Model Context Protocol (Anthropic, 2024). Open standard for LLM-tool integration.\nSynapse has official MCP server: synapse-mcp-api (npm package, npx -y synapse-mcp-api@latest)\n79 tools exposed: 22 memory, 7 chat, 8 scheduler, 4 tasks, 5 scripts, 9 computers, 4 push, 5 user, 3 utility\n3 transports: stdio (local), HTTP/SSE (remote), WebSocket (mobile)\nSupported clients: Claude Desktop, Claude Code, Cursor, Continue, Cline, any MCP-compatible client\nTool Profiles (v1.4.0): minimal (8 tools), standard (25), full (119) — controlled via MCP_PROFILE env or Mcp-Tool-Profile header\n","lang":"pl","translated":true,"requested_lang":"pl","content_markdown":"\n# Czym jest MCP?\n\n**Model Context Protocol (MCP)** to otwarty standard Anthropic (2024), który\npozwala LLM wywoływać zewnętrzne narzędzia w ustrukturyzowany sposób. Zamiast\nwklejać dokumentację API do promptu, rejestruje się narzędzia w serwerze MCP, a\nLLM wywołuje je w razie potrzeby — jak function calling, ale ustandaryzowane i\nniezależne od klienta.\n\n## Serwer Synapse MCP\n\nSynapse dostarcza oficjalny serwer MCP (`synapse-mcp-api` na npm), który\nudostępnia **79 narzędzi** obejmujących wszystkie funkcje Synapse:\n\n| Kategoria | Narzędzia | Liczba |\n|----------|-------|-------|\n| 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 |\n| Chat | poll, reply, status, history, unread, send, upload | 7 |\n| Scheduler | cron_list, cron_create, cron_delete, cron_toggle, var_list, var_get, var_set, var_delete | 8 |\n| Tasks | task_list, task_get, task_create, task_update | 4 |\n| Scripts | script_list, script_get, script_info, script_store, script_delete | 5 |\n| Computers | computer_list, computer_get, install_code, screenshot, command_queue, command_status, commands_list, disable, delete | 9 |\n| Push | vapid_public_key, subscribe, unsubscribe, test | 4 |\n| User/Mind | register, login, minds_list, mind_create, mind_delete | 5 |\n| Utility | time, calc, random | 3 |\n| Visualization | graph, tags, compact | 3 |\n| Sharing | share, list, revoke | 3 |\n| Webhooks | register, list, get, update, delete | 5 |\n| Browser | new, navigate, click, type, screenshot, close | 6 |\n| **Łącznie** | | **79+** |\n\n## Jak to działa\n\n```\n┌──────────────────┐ MCP protocol ┌──────────────────┐ HTTP ┌──────────┐\n│ LLM Client │ ◀─────────────────▶│ Synapse MCP │ ─────────▶ │ Synapse │\n│ (Claude/Cursor) │ (stdio/SSE/WS) │ Server │ │ API │\n└──────────────────┘ └──────────────────┘ └──────────┘\n```\n\n1. Konfiguruje się klienta LLM (Claude Desktop, Cursor itp.) do używania serwera Synapse MCP\n2. Klient uruchamia serwer MCP (przez `npx -y synapse-mcp-api@latest`)\n3. Serwer MCP łączy się z API Synapse przy użyciu Mind Key\n4. LLM widzi wszystkie 79 narzędzi jako natywne funkcje, które może wywoływać\n5. Gdy LLM musi coś zapamiętać, wywołuje `memory_store` — serwer MCP tłumaczy to na `POST /memory` w Synapse\n\n## Transporty\n\nSerwer Synapse MCP obsługuje trzy transporty:\n\n### stdio (lokalny, zalecany dla komputerów biurkowych)\n\n```json\n{\n \"mcpServers\": {\n \"synapse\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"synapse-mcp-api@latest\"],\n \"env\": {\n \"SYNAPSE_MIND_KEY\": \"mk_...\",\n \"SYNAPSE_URL\": \"https://synapse.schaefer.zone\"\n }\n }\n }\n}\n```\n\n### HTTP/SSE (zdalny, wielodostępny)\n\nPodłączyć klienta MCP do:\n\n```\nURL: https://synapse-mcp.schaefer.zone/sse\nHeaders: Authorization: Bearer YOUR_MIND_KEY\n```\n\n### WebSocket (mobilny, duży ruch)\n\n```\nURL: wss://synapse-mcp.schaefer.zone/ws?mind_key=YOUR_MIND_KEY\n```\n\n## Profile narzędzi (v1.4.0)\n\nAby zmniejszyć narzut tokenów dla mniejszych LLM, serwer MCP obsługuje trzy\nprofile narzędzi:\n\n| Profil | Narzędzia | Tokeny | Najlepsze dla |\n|---------|-------|--------|----------|\n| `minimal` | 8 (kompozytowe dyspozytor) | około 500 | Self-hostowane LLM z kontekstem ≤8k |\n| `standard` | 25 (nazwane) | około 2 500 | Średnie LLM (Claude Haiku, GPT-3.5) |\n| `full` | 119 (wszystkie) | około 8 250 | Duże LLM (Claude Sonnet/Opus, GPT-4) — domyślnie |\n\nKontrola przez:\n\n- Zmienna środowiskowa: `MCP_PROFILE=minimal|standard|full`\n- Nagłówek: `Mcp-Tool-Profile: minimal|standard|full`\n\n## Obsługiwani klienci\n\n- [Claude Desktop](/docs/mcp/claude-desktop) — aplikacja biurkowa Anthropic\n- [Claude Code](/docs/mcp/claude-code) — terminalowy agent kodowania\n- [Cursor](/docs/mcp/cursor) — IDE oparte na AI\n- [Continue.dev](/docs/mcp/continue) — open-source'owy asystent kodowania AI\n- [Cline](/docs/mcp/claude-code) — rozszerzenie VS Code\n- Dowolny klient zgodny z MCP\n\n## Dlaczego używać MCP zamiast bezpośredniego API?\n\n| Podejście | Zalety | Wady |\n|----------|------|------|\n| Bezpośrednie API | Proste, bez dodatkowej warstwy | LLM musi znać URL-e, nagłówki, autoryzację |\n| MCP | LLM widzi natywne narzędzia, bez zapamiętywania URL-i | Dodatkowy proces serwera MCP |\n\nDla większości przypadków użycia agentów LLM MCP jest lepszym wyborem — LLM nie\nmusi pamiętać ścieżek API ani wzorców autoryzacji.\n\n## Następne kroki\n\n- [Konfiguracja Claude Desktop](/docs/mcp/claude-desktop) — konfiguracja w 2 minuty\n- [Konfiguracja Claude Code](/docs/mcp/claude-code) — integracja z terminalem\n- [Niestandardowy klient MCP](/docs/mcp/custom-client) — budowa własnego\n","content_html":"

Czym jest MCP?

\n

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

\n

Serwer Synapse MCP

\n

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

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
KategoriaNarzędziaLiczba
Memoryrecall, 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-export22
Chatpoll, reply, status, history, unread, send, upload7
Schedulercron_list, cron_create, cron_delete, cron_toggle, var_list, var_get, var_set, var_delete8
Taskstask_list, task_get, task_create, task_update4
Scriptsscript_list, script_get, script_info, script_store, script_delete5
Computerscomputer_list, computer_get, install_code, screenshot, command_queue, command_status, commands_list, disable, delete9
Pushvapid_public_key, subscribe, unsubscribe, test4
User/Mindregister, login, minds_list, mind_create, mind_delete5
Utilitytime, calc, random3
Visualizationgraph, tags, compact3
Sharingshare, list, revoke3
Webhooksregister, list, get, update, delete5
Browsernew, navigate, click, type, screenshot, close6
Łącznie79+
\n

Jak to działa

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

Transporty

\n

Serwer Synapse MCP obsługuje trzy transporty:

\n

stdio (lokalny, zalecany dla komputerów biurkowych)

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

HTTP/SSE (zdalny, wielodostępny)

\n

Podłączyć klienta MCP do:

\n
URL: https://synapse-mcp.schaefer.zone/sse\nHeaders: Authorization: Bearer YOUR_MIND_KEY

WebSocket (mobilny, duży ruch)

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

Profile narzędzi (v1.4.0)

\n

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

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ProfilNarzędziaTokenyNajlepsze dla
minimal8 (kompozytowe dyspozytor)około 500Self-hostowane LLM z kontekstem ≤8k
standard25 (nazwane)około 2 500Średnie LLM (Claude Haiku, GPT-3.5)
full119 (wszystkie)około 8 250Duże LLM (Claude Sonnet/Opus, GPT-4) — domyślnie
\n

Kontrola przez:

\n\n

Obsługiwani klienci

\n\n

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

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
PodejścieZaletyWady
Bezpośrednie APIProste, bez dodatkowej warstwyLLM musi znać URL-e, nagłówki, autoryzację
MCPLLM widzi natywne narzędzia, bez zapamiętywania URL-iDodatkowy proces serwera MCP
\n

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

\n

Następne kroki

\n\n","urls":{"html":"/docs/mcp/what-is-mcp","text":"/docs/mcp/what-is-mcp?format=text","json":"/docs/mcp/what-is-mcp?format=json","llm":"/docs/mcp/what-is-mcp?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}