API-токены

Встроенный MCP-сервер даёт AI-ассистенту (Claude Desktop, Claude Code, opencode и другим MCP-клиентам) читать и менять ваш план — команды, кварталы, задачи, роли, загрузку, отпуска, план/факт — от вашего имени и с вашими правами.

Что умеет MCP-сервер

Ассистент работает через набор инструментов. Все изменения идут через то же ядро, что и веб-интерфейс: те же правила прав доступа (full/edit/view), нормализации и мягкого удаления, а открытые вкладки браузера обновляются в реальном времени.

Загрузка списка инструментов…

Спринты в аргументах и ответах нумеруются с 1. Роли в set_allocation, add_vacation и т.п. можно указывать по коду (например BA) или по id.

Проще всего: вход через браузер (OAuth)

Клиенты с поддержкой OAuth — Claude Code, Claude Desktop, Cursor и другие — подключаются без токена: достаточно указать адрес сервера. При первом подключении клиент откроет браузер, вы войдёте и нажмёте «Разрешить доступ». Например, в Claude Code:

claude mcp add --transport http planning-tool http://localhost:3000/api/mcp

Подключённые так клиенты видны в блоке «Подключённые приложения» ниже — там же доступ можно отключить. Если клиент OAuth не умеет, используйте персональный токен (шаги ниже).

Шаг 1. Создайте токен

В блоке выше нажмите «Создать токен» и скопируйте значение (оно показывается один раз). Токен выглядит как pt_….

Шаг 2. Убедитесь, что приложение доступно

MCP-сервер работает по адресу http://localhost:3000/api/mcp — он поднимается вместе с приложением, отдельный процесс запускать не нужно. Приложение должно быть запущено и доступно по этому адресу с той машины, где работает агент (тот же Wi-Fi / VPN / публичный адрес).

Шаг 3. Пропишите сервер в конфиг агента

Claude Desktop / Claude Code и другие клиенты с конфигом в стиле mcpServers:

{
  "mcpServers": {
    "planning-tool": {
      "type": "http",
      "url": "http://localhost:3000/api/mcp",
      "headers": { "Authorization": "Bearer pt_ВАШ_ТОКЕН" }
    }
  }
}

opencode (файл opencode.json, блок mcp) — тип remote:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "planning-tool": {
      "type": "remote",
      "url": "http://localhost:3000/api/mcp",
      "enabled": true,
      "headers": { "Authorization": "Bearer pt_ВАШ_ТОКЕН" }
    }
  }
}

Замените pt_ВАШ_ТОКЕН на созданный токен. Заголовок Authorization: Bearer <токен> обязателен — по нему сервер понимает, от чьего имени работать.

Шаг 4. Проверьте подключение

Перезапустите агента и попросите его показать команды (инструмент list_teams) или остаточную загрузку квартала (get_residual). Если инструменты появились — всё готово.

Если не подключается

• 401 Unauthorized — токен не задан, неверный или отозван. Создайте новый и обновите Authorization. Клиент с OAuth в этом случае сам предложит войти заново.
• Не удаётся подключиться / таймаут — приложение не запущено или недоступно по http://localhost:3000/api/mcp с машины агента (проверьте адрес, порт, firewall).

Список выше приходит от самого сервера, поэтому всегда полный. Подробнее о возможностях — в инструкции пользователя.