{"title":"Що таке MCP?","slug":"what-is-mcp","category":"mcp","summary":"Model Context Protocol дозволяє LLM викликати зовнішні інструменти. Synapse викриває 79 інструментів через офіційний MCP-сервер.","audience":["human","llm"],"tags":["mcp","intro","overview"],"difficulty":"beginner","updated":"2026-06-27","word_count":539,"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":"uk","translated":true,"requested_lang":"uk","content_markdown":"\n# Що таке MCP?\n\n**Model Context Protocol (MCP)** — це відкритий стандарт від Anthropic (2024),\nякий дозволяє LLM викликати зовнішні інструменти структурованим чином. Замість\nвставлення API-документації у промпт, ви реєструєте інструменти на MCP-сервері,\nа LLM викликає їх за потреби — як function calling, але стандартизовано та\nнезалежно від клієнта.\n\n## MCP-сервер Synapse\n\nSynapse постачається з офіційним MCP-сервером (`synapse-mcp-api` на npm), що викриває\n**79 інструментів**, які покривають усі можливості Synapse:\n\n| Категорія | Інструменти | Кількість |\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| **Усього** | | **79+** |\n\n## Як це працює\n\n```\n┌──────────────────┐    MCP protocol    ┌──────────────────┐    HTTP    ┌──────────┐\n│  LLM Client      │ ◀─────────────────▶│  Synapse MCP     │ ─────────▶ │ Synapse  │\n│ (Claude/Cursor)  │   (stdio/SSE/WS)   │  Server          │            │ API      │\n└──────────────────┘                    └──────────────────┘            └──────────┘\n```\n\n1. Ви налаштовуєте ваш LLM-клієнт (Claude Desktop, Cursor тощо) на використання MCP-сервера Synapse\n2. Клієнт запускає MCP-сервер (через `npx -y synapse-mcp-api@latest`)\n3. MCP-сервер підключається до Synapse API за допомогою вашого Mind Key\n4. LLM бачить усі 79 інструментів як нативні функції, які він може викликати\n5. Коли LLM має щось запам'ятати, він викликає `memory_store` — MCP-сервер транслює це у `POST /memory` на Synapse\n\n## Транспорти\n\nMCP-сервер Synapse підтримує три транспорти:\n\n### stdio (локально, рекомендовано для десктопа)\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 (віддалено, мультитенантно)\n\nПідключіть ваш MCP-клієнт до:\n\n```\nURL: https://synapse-mcp.schaefer.zone/sse\nHeaders: Authorization: Bearer YOUR_MIND_KEY\n```\n\n### WebSocket (мобільні, великий обсяг)\n\n```\nURL: wss://synapse-mcp.schaefer.zone/ws?mind_key=YOUR_MIND_KEY\n```\n\n## Профілі інструментів (v1.4.0)\n\nЩоб зменшити витрату токенів для менших LLM, MCP-сервер підтримує три\nпрофілі інструментів:\n\n| Профіль | Інструменти | Токени | Найкраще для |\n|---------|-------|--------|----------|\n| `minimal` | 8 (композитна диспетчеризація) | ~500 | Самохостовані LLM із контекстом ≤8k |\n| `standard` | 25 (іменовані) | ~2,500 | Середні LLM (Claude Haiku, GPT-3.5) |\n| `full` | 119 (усі) | ~8,250 | Великі LLM (Claude Sonnet/Opus, GPT-4) — за замовчуванням |\n\nКерування через:\n\n- Змінну середовища: `MCP_PROFILE=minimal|standard|full`\n- Заголовок: `Mcp-Tool-Profile: minimal|standard|full`\n\n## Підтримувані клієнти\n\n- [Claude Desktop](/docs/mcp/claude-desktop) — десктоп-додаток Anthropic\n- [Claude Code](/docs/mcp/claude-code) — термінальний агент програмування\n- [Cursor](/docs/mcp/cursor) — IDE на основі AI\n- [Continue.dev](/docs/mcp/continue) — AI-асистент програмування з відкритим кодом\n- [Cline](/docs/mcp/claude-code) — розширення VS Code\n- Будь-який MCP-сумісний клієнт\n\n## Чому варто використовувати MCP замість прямого API?\n\n| Підхід | Плюси | Мінуси |\n|----------|------|------|\n| Прямий API | Простий, без зайвого шару | LLM має знати URL, заголовки, автентифікацію |\n| MCP | LLM бачить нативні інструменти, не треба запам'ятовувати URL | Додатковий процес MCP-сервера |\n\nДля більшості сценаріїв використання LLM-агентів MCP — кращий вибір, адже LLM\nне повинен запам'ятовувати API-шляхи чи шаблони автентифікації.\n\n## Наступні кроки\n\n- [Налаштування Claude Desktop](/docs/mcp/claude-desktop) — конфігурація за 2 хвилини\n- [Налаштування Claude Code](/docs/mcp/claude-code) — термінальна інтеграція\n- [Власний MCP-клієнт](/docs/mcp/custom-client) — створіть свій\n","content_html":"<h1>Що таке MCP?</h1>\n<p><strong>Model Context Protocol (MCP)</strong> — це відкритий стандарт від Anthropic (2024),\nякий дозволяє LLM викликати зовнішні інструменти структурованим чином. Замість\nвставлення API-документації у промпт, ви реєструєте інструменти на MCP-сервері,\nа LLM викликає їх за потреби — як function calling, але стандартизовано та\nнезалежно від клієнта.</p>\n<h2>MCP-сервер Synapse</h2>\n<p>Synapse постачається з офіційним MCP-сервером (<code>synapse-mcp-api</code> на npm), що викриває\n<strong>79 інструментів</strong>, які покривають усі можливості Synapse:</p>\n<table>\n<thead>\n<tr>\n<th>Категорія</th>\n<th>Інструменти</th>\n<th>Кількість</th>\n</tr>\n</thead>\n<tbody><tr>\n<td>Memory</td>\n<td>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</td>\n<td>22</td>\n</tr>\n<tr>\n<td>Chat</td>\n<td>poll, reply, status, history, unread, send, upload</td>\n<td>7</td>\n</tr>\n<tr>\n<td>Scheduler</td>\n<td>cron_list, cron_create, cron_delete, cron_toggle, var_list, var_get, var_set, var_delete</td>\n<td>8</td>\n</tr>\n<tr>\n<td>Tasks</td>\n<td>task_list, task_get, task_create, task_update</td>\n<td>4</td>\n</tr>\n<tr>\n<td>Scripts</td>\n<td>script_list, script_get, script_info, script_store, script_delete</td>\n<td>5</td>\n</tr>\n<tr>\n<td>Computers</td>\n<td>computer_list, computer_get, install_code, screenshot, command_queue, command_status, commands_list, disable, delete</td>\n<td>9</td>\n</tr>\n<tr>\n<td>Push</td>\n<td>vapid_public_key, subscribe, unsubscribe, test</td>\n<td>4</td>\n</tr>\n<tr>\n<td>User/Mind</td>\n<td>register, login, minds_list, mind_create, mind_delete</td>\n<td>5</td>\n</tr>\n<tr>\n<td>Utility</td>\n<td>time, calc, random</td>\n<td>3</td>\n</tr>\n<tr>\n<td>Visualization</td>\n<td>graph, tags, compact</td>\n<td>3</td>\n</tr>\n<tr>\n<td>Sharing</td>\n<td>share, list, revoke</td>\n<td>3</td>\n</tr>\n<tr>\n<td>Webhooks</td>\n<td>register, list, get, update, delete</td>\n<td>5</td>\n</tr>\n<tr>\n<td>Browser</td>\n<td>new, navigate, click, type, screenshot, close</td>\n<td>6</td>\n</tr>\n<tr>\n<td><strong>Усього</strong></td>\n<td></td>\n<td><strong>79+</strong></td>\n</tr>\n</tbody></table>\n<h2>Як це працює</h2>\n<pre><code class=\"hljs language-plaintext\">┌──────────────────┐    MCP protocol    ┌──────────────────┐    HTTP    ┌──────────┐\n│  LLM Client      │ ◀─────────────────▶│  Synapse MCP     │ ─────────▶ │ Synapse  │\n│ (Claude/Cursor)  │   (stdio/SSE/WS)   │  Server          │            │ API      │\n└──────────────────┘                    └──────────────────┘            └──────────┘</code></pre><ol>\n<li>Ви налаштовуєте ваш LLM-клієнт (Claude Desktop, Cursor тощо) на використання MCP-сервера Synapse</li>\n<li>Клієнт запускає MCP-сервер (через <code>npx -y synapse-mcp-api@latest</code>)</li>\n<li>MCP-сервер підключається до Synapse API за допомогою вашого Mind Key</li>\n<li>LLM бачить усі 79 інструментів як нативні функції, які він може викликати</li>\n<li>Коли LLM має щось запам&#39;ятати, він викликає <code>memory_store</code> — MCP-сервер транслює це у <code>POST /memory</code> на Synapse</li>\n</ol>\n<h2>Транспорти</h2>\n<p>MCP-сервер Synapse підтримує три транспорти:</p>\n<h3>stdio (локально, рекомендовано для десктопа)</h3>\n<pre><code class=\"hljs language-json\"><span class=\"hljs-punctuation\">{</span>\n  <span class=\"hljs-attr\">&quot;mcpServers&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-punctuation\">{</span>\n    <span class=\"hljs-attr\">&quot;synapse&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-punctuation\">{</span>\n      <span class=\"hljs-attr\">&quot;command&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;npx&quot;</span><span class=\"hljs-punctuation\">,</span>\n      <span class=\"hljs-attr\">&quot;args&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-punctuation\">[</span><span class=\"hljs-string\">&quot;-y&quot;</span><span class=\"hljs-punctuation\">,</span> <span class=\"hljs-string\">&quot;synapse-mcp-api@latest&quot;</span><span class=\"hljs-punctuation\">]</span><span class=\"hljs-punctuation\">,</span>\n      <span class=\"hljs-attr\">&quot;env&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-punctuation\">{</span>\n        <span class=\"hljs-attr\">&quot;SYNAPSE_MIND_KEY&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;mk_...&quot;</span><span class=\"hljs-punctuation\">,</span>\n        <span class=\"hljs-attr\">&quot;SYNAPSE_URL&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;https://synapse.schaefer.zone&quot;</span>\n      <span class=\"hljs-punctuation\">}</span>\n    <span class=\"hljs-punctuation\">}</span>\n  <span class=\"hljs-punctuation\">}</span>\n<span class=\"hljs-punctuation\">}</span></code></pre><h3>HTTP/SSE (віддалено, мультитенантно)</h3>\n<p>Підключіть ваш MCP-клієнт до:</p>\n<pre><code class=\"hljs language-plaintext\">URL: https://synapse-mcp.schaefer.zone/sse\nHeaders: Authorization: Bearer YOUR_MIND_KEY</code></pre><h3>WebSocket (мобільні, великий обсяг)</h3>\n<pre><code class=\"hljs language-plaintext\">URL: wss://synapse-mcp.schaefer.zone/ws?mind_key=YOUR_MIND_KEY</code></pre><h2>Профілі інструментів (v1.4.0)</h2>\n<p>Щоб зменшити витрату токенів для менших LLM, MCP-сервер підтримує три\nпрофілі інструментів:</p>\n<table>\n<thead>\n<tr>\n<th>Профіль</th>\n<th>Інструменти</th>\n<th>Токени</th>\n<th>Найкраще для</th>\n</tr>\n</thead>\n<tbody><tr>\n<td><code>minimal</code></td>\n<td>8 (композитна диспетчеризація)</td>\n<td>~500</td>\n<td>Самохостовані LLM із контекстом ≤8k</td>\n</tr>\n<tr>\n<td><code>standard</code></td>\n<td>25 (іменовані)</td>\n<td>~2,500</td>\n<td>Середні LLM (Claude Haiku, GPT-3.5)</td>\n</tr>\n<tr>\n<td><code>full</code></td>\n<td>119 (усі)</td>\n<td>~8,250</td>\n<td>Великі LLM (Claude Sonnet/Opus, GPT-4) — за замовчуванням</td>\n</tr>\n</tbody></table>\n<p>Керування через:</p>\n<ul>\n<li>Змінну середовища: <code>MCP_PROFILE=minimal|standard|full</code></li>\n<li>Заголовок: <code>Mcp-Tool-Profile: minimal|standard|full</code></li>\n</ul>\n<h2>Підтримувані клієнти</h2>\n<ul>\n<li><a href=\"/docs/mcp/claude-desktop\">Claude Desktop</a> — десктоп-додаток Anthropic</li>\n<li><a href=\"/docs/mcp/claude-code\">Claude Code</a> — термінальний агент програмування</li>\n<li><a href=\"/docs/mcp/cursor\">Cursor</a> — IDE на основі AI</li>\n<li><a href=\"/docs/mcp/continue\">Continue.dev</a> — AI-асистент програмування з відкритим кодом</li>\n<li><a href=\"/docs/mcp/claude-code\">Cline</a> — розширення VS Code</li>\n<li>Будь-який MCP-сумісний клієнт</li>\n</ul>\n<h2>Чому варто використовувати MCP замість прямого API?</h2>\n<table>\n<thead>\n<tr>\n<th>Підхід</th>\n<th>Плюси</th>\n<th>Мінуси</th>\n</tr>\n</thead>\n<tbody><tr>\n<td>Прямий API</td>\n<td>Простий, без зайвого шару</td>\n<td>LLM має знати URL, заголовки, автентифікацію</td>\n</tr>\n<tr>\n<td>MCP</td>\n<td>LLM бачить нативні інструменти, не треба запам&#39;ятовувати URL</td>\n<td>Додатковий процес MCP-сервера</td>\n</tr>\n</tbody></table>\n<p>Для більшості сценаріїв використання LLM-агентів MCP — кращий вибір, адже LLM\nне повинен запам&#39;ятовувати API-шляхи чи шаблони автентифікації.</p>\n<h2>Наступні кроки</h2>\n<ul>\n<li><a href=\"/docs/mcp/claude-desktop\">Налаштування Claude Desktop</a> — конфігурація за 2 хвилини</li>\n<li><a href=\"/docs/mcp/claude-code\">Налаштування Claude Code</a> — термінальна інтеграція</li>\n<li><a href=\"/docs/mcp/custom-client\">Власний MCP-клієнт</a> — створіть свій</li>\n</ul>\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"]}