Skip to main content

Что такое MCP?

Model Context Protocol позволяет LLM вызывать внешние инструменты. Synapse предоставляет 79 инструментов через официальный MCP-сервер.


Что такое MCP?

Model Context Protocol (MCP) — открытый стандарт от Anthropic (2024), который позволяет LLM вызывать внешние инструменты структурированно. Вместо вставки документации API в промпт вы регистрируете инструменты на MCP-сервере, и LLM вызывает их по мере необходимости — как function calling, но стандартизировано и независимо от клиента.

MCP-сервер Synapse

Synapse поставляется с официальным MCP-сервером (synapse-mcp-api на npm), который предоставляет 79 инструментов, охватывающих все возможности Synapse:

Категория Инструменты Кол-во
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
Итого 79+

Как это работает

┌──────────────────┐    MCP protocol    ┌──────────────────┐    HTTP    ┌──────────┐
│  LLM Client      │ ◀─────────────────▶│  Synapse MCP     │ ─────────▶ │ Synapse  │
│ (Claude/Cursor)  │   (stdio/SSE/WS)   │  Server          │            │ API      │
└──────────────────┘                    └──────────────────┘            └──────────┘
  1. Вы настраиваете ваш LLM-клиент (Claude Desktop, Cursor и т. д.) на использование MCP-сервера Synapse
  2. Клиент запускает MCP-сервер (через npx -y synapse-mcp-api@latest)
  3. MCP-сервер подключается к Synapse API с использованием вашего Mind Key
  4. LLM видит все 79 инструментов как нативные функции, которые он может вызывать
  5. Когда LLM нужно что-то запомнить, он вызывает memory_store — MCP-сервер транслирует это в POST /memory на Synapse

Транспорты

MCP-сервер Synapse поддерживает три транспорта:

stdio (локально, рекомендуется для desktop)

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

HTTP/SSE (удалённо, multi-tenant)

Подключите ваш MCP-клиент к:

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

WebSocket (мобильные, высокий объём)

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

Tool Profiles (v1.4.0)

Для снижения нагрузки на токены для меньших LLM MCP-сервер поддерживает три профиля инструментов:

Профиль Инструменты Токены Лучше всего для
minimal 8 (составная диспетчеризация) ~500 Self-hosted LLM с контекстом ≤8k
standard 25 (именованные) ~2 500 LLM среднего размера (Claude Haiku, GPT-3.5)
full 119 (все) ~8 250 Большие LLM (Claude Sonnet/Opus, GPT-4) — по умолчанию

Управление через:

  • Переменную окружения: MCP_PROFILE=minimal|standard|full
  • Заголовок: Mcp-Tool-Profile: minimal|standard|full

Поддерживаемые клиенты

  • Claude Desktop — настольное приложение Anthropic
  • Claude Code — терминальный кодинг-агент
  • Cursor — AI-ориентированная IDE
  • Continue.dev — open-source AI-кодинг-ассистент
  • Cline — расширение VS Code
  • Любой MCP-совместимый клиент

Почему MCP вместо прямого API?

Подход Плюсы Минусы
Прямой API Просто, без дополнительного слоя LLM должен знать URL, заголовки, аутентификацию
MCP LLM видит нативные инструменты, без запоминания URL Дополнительный процесс MCP-сервера

Для большинства сценариев LLM-агентов MCP — лучший выбор: LLM не нужно помнить пути API или паттерны аутентификации.

Следующие шаги