{"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":537,"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":"ru","translated":true,"requested_lang":"ru","content_markdown":"\n# Что такое MCP?\n\n**Model Context Protocol (MCP)** — открытый стандарт от Anthropic (2024), который\nпозволяет LLM вызывать внешние инструменты структурированно. Вместо вставки\nдокументации API в промпт вы регистрируете инструменты на MCP-сервере, и LLM\nвызывает их по мере необходимости — как 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 (локально, рекомендуется для desktop)\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 (удалённо, multi-tenant)\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## Tool Profiles (v1.4.0)\n\nДля снижения нагрузки на токены для меньших LLM MCP-сервер поддерживает три\nпрофиля инструментов:\n\n| Профиль | Инструменты | Токены | Лучше всего для |\n|---------|-------|--------|----------|\n| `minimal` | 8 (составная диспетчеризация) | ~500 | Self-hosted 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) — AI-ориентированная IDE\n- [Continue.dev](/docs/mcp/continue) — open-source 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-сервере, и LLM\nвызывает их по мере необходимости — как 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 нужно что-то запомнить, он вызывает <code>memory_store</code> — MCP-сервер транслирует это в <code>POST /memory</code> на Synapse</li>\n</ol>\n<h2>Транспорты</h2>\n<p>MCP-сервер Synapse поддерживает три транспорта:</p>\n<h3>stdio (локально, рекомендуется для desktop)</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 (удалённо, multi-tenant)</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>Tool Profiles (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>Self-hosted 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> — AI-ориентированная IDE</li>\n<li><a href=\"/docs/mcp/continue\">Continue.dev</a> — open-source 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 видит нативные инструменты, без запоминания URL</td>\n<td>Дополнительный процесс MCP-сервера</td>\n</tr>\n</tbody></table>\n<p>Для большинства сценариев LLM-агентов MCP — лучший выбор: LLM не нужно помнить\nпути 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"]}