Що таке 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 │
└──────────────────┘ └──────────────────┘ └──────────┘- Ви налаштовуєте ваш LLM-клієнт (Claude Desktop, Cursor тощо) на використання MCP-сервера Synapse
- Клієнт запускає MCP-сервер (через
npx -y synapse-mcp-api@latest) - MCP-сервер підключається до Synapse API за допомогою вашого Mind Key
- LLM бачить усі 79 інструментів як нативні функції, які він може викликати
- Коли LLM має щось запам'ятати, він викликає
memory_store— MCP-сервер транслює це уPOST /memoryна Synapse
Транспорти
MCP-сервер Synapse підтримує три транспорти:
stdio (локально, рекомендовано для десктопа)
{
"mcpServers": {
"synapse": {
"command": "npx",
"args": ["-y", "synapse-mcp-api@latest"],
"env": {
"SYNAPSE_MIND_KEY": "mk_...",
"SYNAPSE_URL": "https://synapse.schaefer.zone"
}
}
}
}HTTP/SSE (віддалено, мультитенантно)
Підключіть ваш MCP-клієнт до:
URL: https://synapse-mcp.schaefer.zone/sse
Headers: Authorization: Bearer YOUR_MIND_KEYWebSocket (мобільні, великий обсяг)
URL: wss://synapse-mcp.schaefer.zone/ws?mind_key=YOUR_MIND_KEYПрофілі інструментів (v1.4.0)
Щоб зменшити витрату токенів для менших LLM, MCP-сервер підтримує три профілі інструментів:
| Профіль | Інструменти | Токени | Найкраще для |
|---|---|---|---|
minimal |
8 (композитна диспетчеризація) | ~500 | Самохостовані 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 — IDE на основі AI
- Continue.dev — AI-асистент програмування з відкритим кодом
- Cline — розширення VS Code
- Будь-який MCP-сумісний клієнт
Чому варто використовувати MCP замість прямого API?
| Підхід | Плюси | Мінуси |
|---|---|---|
| Прямий API | Простий, без зайвого шару | LLM має знати URL, заголовки, автентифікацію |
| MCP | LLM бачить нативні інструменти, не треба запам'ятовувати URL | Додатковий процес MCP-сервера |
Для більшості сценаріїв використання LLM-агентів MCP — кращий вибір, адже LLM не повинен запам'ятовувати API-шляхи чи шаблони автентифікації.
Наступні кроки
- Налаштування Claude Desktop — конфігурація за 2 хвилини
- Налаштування Claude Code — термінальна інтеграція
- Власний MCP-клієнт — створіть свій