# FAQ по MCP

Типовые вопросы по MCP-серверу Synapse.

## Что такое MCP?

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

См. [Что такое MCP?](/docs/mcp/what-is-mcp).

## Сколько инструментов предоставляет Synapse MCP?

**79 инструментов** в 12 категориях: memory, chat, scheduler, tasks, scripts,
computers, push, user, utility, visualization, sharing, webhooks, browser.

Полный список см. в [Что такое MCP?](/docs/mcp/what-is-mcp).

## Какие MCP-клиенты поддерживаются?

- Claude Desktop (macOS, Windows)
- Claude Code (терминал)
- Cursor (IDE)
- Continue.dev (VS Code, JetBrains)
- Cline (VS Code)
- Любой MCP-совместимый клиент

Примеры конфигурации см. в [Настройка Claude Desktop](/docs/mcp/claude-desktop).

## Какие транспорты поддерживаются?

1. **stdio** (локально, рекомендуется для desktop)
2. **HTTP/SSE** (удалённо, multi-tenant)
3. **WebSocket** (мобильные устройства, высокий объём)

## Как настроить Claude Desktop?

Отредактируйте `claude_desktop_config.json`:

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

См. [Настройка Claude Desktop](/docs/mcp/claude-desktop).

## Почему инструменты не появляются в Claude Desktop?

1. **Полностью перезапустите Claude Desktop** (Cmd+Q на macOS)
2. **Проверьте, что файл конфигурации — валидный JSON**
3. **Убедитесь, что установлен Node.js 18+**
4. **Проверьте логи MCP**: `~/Library/Logs/Claude/mcp.log`

См. [Устранение проблем MCP](/docs/mcp/troubleshooting).

## Как использовать другой mind?

Измените `SYNAPSE_MIND_KEY` в конфигурации MCP и перезапустите клиент.

Для нескольких mind запустите несколько экземпляров MCP-сервера с разными
Mind Key.

## Можно ли ограничить набор инструментов?

Да, используйте **Tool Profiles**:

- `minimal`: 8 составных инструментов (~500 токенов)
- `standard`: 25 инструментов (~2 500 токенов)
- `full`: 119 инструментов (~8 250 токенов, по умолчанию)

Задаётся через переменную окружения `MCP_PROFILE` или заголовок `Mcp-Tool-Profile`.

## Как отлаживать проблемы MCP?

1. **Запустите MCP-сервер вручную**: `npx -y synapse-mcp-api@latest`
2. **Проверьте логи клиента** (зависит от клиента)
3. **Убедитесь, что Mind Key работает**: `curl -H "Authorization: Bearer mk_..." .../memory/recall`
4. **Проверьте здоровье Synapse**: `curl https://synapse.schaefer.zone/health`

См. [Устранение проблем MCP](/docs/mcp/troubleshooting).

## MCP-сервер бесплатен?

Да. npm-пакет `synapse-mcp-api` имеет открытый исходный код. Хостинговый
MCP-сервер на `synapse-mcp.schaefer.zone` бесплатен для публичного использования.

## Можно ли хостить MCP-сервер самому?

Да:

```bash
npm install -g synapse-mcp-api
SYNAPSE_URL=https://your-synapse-instance.com \
SYNAPSE_MIND_KEY=mk_... \
synapse-mcp-api
```

## Чем MCP отличается от прямых вызовов API?

| Аспект | Прямой API | MCP |
|--------|-----------|-----|
| Что нужно знать LLM | URL, заголовки, аутентификацию | Только имена инструментов |
| Аутентификация | Вручную | Автоматически (env var) |
| Обнаружение инструментов | Чтение /endpoints | Автоматически через протокол MCP |
| Обработка ошибок | Вручную | Стандартизированная |
| Лучше всего для | Кастомных интеграций | LLM-агентов |

## Можно ли создать свой MCP-клиент?

Да. Используйте официальный SDK MCP:

- TypeScript: `@modelcontextprotocol/sdk`
- Python: `mcp`

См. [Кастомный MCP-клиент](/docs/mcp/custom-client).

## Как сообщить об ошибках MCP?

Создайте issue: <https://gitlab.com/schaefer-services/synapse-mcp/-/issues>

Включите:

- Версию MCP-сервера
- Имя и версию клиента
- Операционную систему
- Соответствующие логи
- Шаги для воспроизведения

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

- [Что такое MCP?](/docs/mcp/what-is-mcp)
- [Настройка Claude Desktop](/docs/mcp/claude-desktop)
- [Устранение проблем MCP](/docs/mcp/troubleshooting)