# Что такое 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)

```json
{
  "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](/docs/mcp/claude-desktop) — настольное приложение Anthropic
- [Claude Code](/docs/mcp/claude-code) — терминальный кодинг-агент
- [Cursor](/docs/mcp/cursor) — AI-ориентированная IDE
- [Continue.dev](/docs/mcp/continue) — open-source AI-кодинг-ассистент
- [Cline](/docs/mcp/claude-code) — расширение VS Code
- Любой MCP-совместимый клиент

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

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

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

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

- [Настройка Claude Desktop](/docs/mcp/claude-desktop) — конфигурация за 2 минуты
- [Настройка Claude Code](/docs/mcp/claude-code) — интеграция с терминалом
- [Кастомный MCP-клиент](/docs/mcp/custom-client) — создайте свой