Внешний ИИ по MCP

Как подключить своего ассистента к доскам аккаунта. Страница совпадает с сервером POST /mcp.

Кнопка ИИ на самой доске — отдельный путь: она спрашивает модель по тексту холста. Этот документ — про внешний клиент.

Кому доступно

Тариф Безлимитный (500 ₽) и социальный безлимит после проверки документов. На бесплатном и начальном сервер отвечает 402.

ИИ видит только доски организации, чей токен передан. Текст объектов, не картинку холста.

Адрес

POST https://table-api.astar-it.com/mcp

Заголовки на каждый запрос:

Authorization: Bearer <JWT>
Content-Type: application/json

Проверка, что сервис жив, без токена:

GET https://table-api.astar-it.com/mcp

Ответ: name = astar-board, protocol = 2024-11-05, docs — ссылка на эту страницу.

Это JSON-RPC 2.0 на один адрес. Отдельной сессии и SSE нет: каждый вызов — отдельный POST с тем же токеном.

Токен

Токен выдаёт вход:

POST https://table-auth.astar-it.com/api/auth/login
Content-Type: application/json

{"email":"you@example.com","password":"secret"}

В ответе поле token. Его и кладите в Authorization. Пароль в запросы к /mcp не передаётся.

Рукопожатие

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {}
}

В result.serverInfo.name будет astar-board, в result.protocolVersion — 2024-11-05.

Дальше клиент может послать notifications/initialized или ping. Оба отвечают пустым result.

Инструменты

tools/list возвращает два инструмента.

list_boards

Аргументы не нужны. В result.content[0].text — JSON, до 50 досок: id, name, updatedAt. Удалённые не входят.

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": { "name": "list_boards", "arguments": {} }
}

read_board

Аргумент boardId — id из списка. В тексте ответа первая строка — название доски, дальше подписи и текст объектов.

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "read_board",
    "arguments": { "boardId": "BOARD_ID" }
  }
}

Чужой или удалённый boardId даёт текст Доска не найдена и isError: true.

Неизвестный инструмент — HTTP 400 и JSON-RPC код -32602. Неизвестный метод — код -32601.

Ошибки доступа

Ответ	Когда
401	Нет или протух токен
402	Тариф не Безлимитный и не социальный безлимит
400	Метод или инструмент не из этого списка