Claude и MCP

Подключите Claude Code, Cursor или VS Code к Doska по MCP, чтобы ИИ-агент читал доски, рисовал диаграммы, писал документы и отвечал на комментарии.

В Doska встроен сервер Model Context Protocol. Подключите Claude Code (или другой MCP-клиент, например Cursor или VS Code), и агент сможет читать ваши доски и документы, рисовать и обновлять диаграммы, добавлять стикеры и отвечать на комментарии. Он действует от вашего имени и с правами выданного токена.

Адрес сервера — https://getdoska.top/api/mcp (транспорт Streamable HTTP). На стороне Doska ничего устанавливать не нужно.

#Быстрый старт

1. В Doska откройте меню под своим именем внизу боковой панели и выберите Настройки и API-токены.

2. В разделе Токены доступа нажмите Создать токен. Выберите уровень доступа, проекты и срок (подробнее ниже) и нажмите Создать токен.

3. Скопируйте команду из блока Подключить к Claude Code и выполните её в терминале:

   bashКопировать

   claude mcp add --transport http doska https://getdoska.top/api/mcp --header "Authorization: Bearer dsk_…"

   С --scope user сервер будет доступен в любой папке, без него — только в текущем проекте.

4. Запустите claude и проверьте подключение командой /mcp.

Токен показывается один раз. Скопируйте его, прежде чем закрыть панель.

#Другие MCP-клиенты

Подойдёт любой клиент, который умеет передавать HTTP-заголовок. Укажите тот же адрес и заголовок Authorization: Bearer dsk_…. Например, в Cursor (mcp.json):

{
  "mcpServers": {
    "doska": {
      "url": "https://getdoska.top/api/mcp",
      "headers": { "Authorization": "Bearer dsk_…" }
    }
  }
}

В VS Code (.vscode/mcp.json):

{
  "servers": {
    "doska": {
      "type": "http",
      "url": "https://getdoska.top/api/mcp",
      "headers": { "Authorization": "Bearer dsk_…" }
    }
  }
}

#Создание токена

Токен личный: он действует от вашего имени и никогда не даёт больше прав, чем есть у вас сейчас. Если вас убрали из проекта или организации, токен тоже теряет туда доступ.

Ещё несколько правил:

• Наблюдатель остаётся наблюдателем. Токен с уровнем «Редактирование» не даст менять доски, где у вас роль наблюдателя.
• Управление недоступно. Через токен нельзя удалять доски и проекты, управлять участниками и ролями, менять доступ и создавать другие токены.
• Только API и MCP. Токен работает для /api/v1/* и /api/mcp, остальные адреса отвечают 403.
• Хранится как хеш. Doska хранит только хеш токена. Префикс dsk_ помогает сканерам секретов находить утёкшие токены.

У каждого токена в списке видны уровень, проекты, срок и время последнего использования. Чтобы отозвать токен, нажмите на значок корзины: подключённые клиенты сразу теряют доступ.

#Для администраторов организации

В разделе Участники и настройки → Токены доступа владельцы и администраторы задают правило Участники и гости могут создавать токены: Без ограничений, Чтение и комментарии, Только чтение или Токены отключены. Правило действует сразу, в том числе для уже выданных токенов. Администраторов и владельцев оно не ограничивает.

Там же виден список всех токенов организации с их владельцами, и любой из них можно отозвать.

#Что умеет агент

Клиент видит только инструменты своего уровня доступа: токену на чтение инструменты правки даже не показываются.

#Чтение

#Комментарии

#Редактирование

Элементы диаграмм принадлежат коду, поэтому агент меняет их только через put_diagram. Ручные позиции и стили сохраняются так же, как при правке кода в редакторе. Подробнее — в разделах Диаграммы как код и Инфраструктура.

#Готовые промпты

Doska даёт агенту и готовые запросы. В Claude Code они появляются как команды после / (например, /mcp__doska__present-board); другие клиенты показывают их по-своему.

#Примеры запросов

• «Какие доски есть в проекте DevOps?»
• «Прочитай доску „Архитектура“ и объясни, как запрос идёт от пользователя до базы».
• «Нарисуй на доске „Платежи“ схему этого сервиса по коду из репозитория».
• «Напиши runbook по деплою этого сервиса новым документом в проекте Ops».
• «Сделай презентацию из доски „Платежи“ для архитектурного ревью, в теме Midnight, и покажи путь запроса по шагам».
• «Ответь на открытые комментарии на доске „Ревью“».
• «Импортируй наш Terraform-план на доску „Сеть“ и скажи, какие порты открыты в интернет».

После изменений агент даёт ссылку на доску. Если доска у кого-то открыта, правки появляются у него сразу.

#Безопасность

• Версия перед изменениями. Перед первой правкой через токен Doska сохраняет копию доски в истории версий с подписью «Перед изменениями через токен «…»». Правки в течение следующих 15 минут продолжают ту же сессию. Чтобы отменить всё, что сделал агент, восстановите эту версию в панели История версий.
• Видно, кто что менял. Ревизии диаграмм через MCP подписаны «Имя · MCP», а комментарии агента помечены «через MCP».
• Prompt injection. Агент читает стикеры и комментарии, которые написали другие люди, и в них могут оказаться «инструкции». Doska сообщает клиенту, что содержимое доски — это данные, а не команды. Самая надёжная защита — минимальные права:
  • для вопросов и разбора схем хватает уровня «Чтение»;
  • токены с «Редактированием» ограничьте нужными проектами и задайте им срок.
• Лимиты. Не больше 300 запросов к MCP в минуту с одного адреса, 200 элементов и 100 удалений за вызов.

#Если не работает

• 401 или «Нужен действующий API-токен Doska». Токен отозван, истёк или отключён правилом организации. Проверьте, что заголовок передаётся точно как Authorization: Bearer dsk_….
• «Доска не найдена». Доска лежит в проекте, который не входит в токен, или в другой организации.

Проверить сервер без клиента:

curl -s https://getdoska.top/api/mcp \
  -H "Authorization: Bearer $DOSKA_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  --data '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Для CI и скриптов используйте те же токены с REST API.