MCP для ИИ-ассистентов

MCP (Model Context Protocol) — способ дать ИИ-ассистенту наши данные. Подключите сервер datool.ru, и ассистент сам найдёт канал, посмотрит его статистику и посты и ответит на вопрос вроде «как рос канал @rbc в октябре».

Адрес и ключ

• Адрес сервера: https://api.datool.ru/v1/mcp/ (MCP поверх HTTP, «Streamable HTTP»).
• Ключ — тот же, что для API: заголовок Authorization: Bearer dtk_ваш_ключ. Ключ создаётся на странице «API-ключи» в кабинете.

Claude Code

# добавить сервер datool в Claude Code; ключ — со страницы «API-ключи» в кабинете
claude mcp add --transport http datool https://api.datool.ru/v1/mcp/ \
  --header "Authorization: Bearer dtk_ваш_ключ"

Cursor и другие клиенты

Добавьте сервер в настройки MCP (в Cursor — файл .cursor/mcp.json):

{
  "mcpServers": {
    "datool": {
      "url": "https://api.datool.ru/v1/mcp/",
      "headers": { "Authorization": "Bearer dtk_ваш_ключ" }
    }
  }
}

Claude Desktop и другим клиентам, которые умеют только запускать программу у себя, поможет переходник mcp-remote (нужен Node.js). В Claude Desktop настройка — файл claude_desktop_config.json (Settings → Developer → Edit Config). Ключ передаётся через переменную окружения: пробел внутри аргумента ломает настройку в Windows.

{
  "mcpServers": {
    "datool": {
      "command": "npx",
      "args": ["mcp-remote", "https://api.datool.ru/v1/mcp/",
               "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer dtk_ваш_ключ" }
    }
  }
}

Инструменты

Инструменты — это методы API, которые читают данные, с теми же именами и параметрами, что в справочнике методов:

Изменять что-либо через MCP нельзя — например, вебхуки управляются только через API ключом «чтение и запись».

Как это устроено внутри

Свой клиент MCP можно написать и без готовых программ: сервер принимает JSON-RPC 2.0 запросом POST и отвечает JSON.

# список инструментов (бесплатно)
curl -X POST https://api.datool.ru/v1/mcp/ \
  -H "Authorization: Bearer dtk_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}'

# вызвать инструмент: карточка канала @citynews (стоит как метод API — 1 единица)
curl -X POST https://api.datool.ru/v1/mcp/ \
  -H "Authorization: Bearer dtk_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": {"name": "max_channels_retrieve", "arguments": {"channel": "citynews"}}}'

Ответ на вызов инструмента — ответ метода API текстом (content) и объектом (structuredContent):

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [{"type": "text", "text": "{\"id\": 4821, \"title\": \"Городские новости\", …}"}],
    "structuredContent": {"id": 4821, "title": "Городские новости", "subscribers": 128450},
    "isError": false
  }
}

Сеансов и потока событий нет: каждый запрос самостоятельный, GET на адрес сервера — 405.

Если ассистент пишет об ошибке

Ошибка метода приходит ассистенту текстом с кодом, например 403 tariff_required — посты закрыты на «API.Max Тест», или 429 quota_exceeded — запросы за период закончились. Коды — на странице «Ошибки».