MCP-сервер

Claude Code и Cursor подключаются к задачам воркспейса по адресу MCP. Тот же личный токен, что и у API: что можно человеку, то можно ассистенту, и ничего сверх.

Базовый адрес https://ahora.team/mcp

Что можно сделать с API

Подключение

Токен

В «Настройки воркспейса → API и интеграции» создайте токен. Для вопросов ассистенту хватит tasks:read. Чтобы он создавал и менял задачи, добавьте tasks:write.

Секрет показывается один раз. В конфиг клиента он попадает в заголовок Authorization, как в обычном запросе к API.

OAuth нет. Клиент, который не умеет передать свой заголовок, подключиться не сможет. Так устроены коннекторы Claude в браузере и в Claude Desktop — им Ahora пока не подключить.

Cursor и Claude Code

Адрес один: https://ahora.team/mcp. Это Streamable HTTP, сессии нет, каждый запрос идёт со своим токеном.

Токен только на чтение не показывает инструменты записи. Прямой вызов всё равно получит отказ.

Лимит общий с API: 300 запросов в минуту на токен.

Cursor

{
  "mcpServers": {
    "ahora": {
      "url": "https://ahora.team/mcp",
      "headers": {
        "Authorization": "Bearer ahr_ws_…"
      }
    }
  }
}

Claude Code

claude mcp add --transport http ahora https://ahora.team/mcp \
  --header "Authorization: Bearer ahr_ws_…"

Инструменты

Задачи

Описания инструментов на английском, сами задачи — как в воркспейсе. У задачи в ответе есть ссылка, чтобы открыть её в Ahora. Даты — ISO 8601.

Инструмент	Право	Что делает
get_context	чтение	Кто я и какой воркспейс
list_boards	чтение	Доски
list_statuses	чтение	Статусы доски
find_members	чтение	Участники, можно по части имени
list_tasks	чтение	Задачи с теми же фильтрами, что у API. По умолчанию 20
get_task	чтение	Задача, комментарии и чек-лист
create_task	запись	Новая задача. externalId не задваивает её
update_task	запись	Правка. ifMatch — ETag task-<id>-v<version>
add_comment	запись	Комментарий
set_checklist_item	запись	Добавить пункт или отметить. Удаления нет
assign	запись	Назначить исполнителя
unassign	запись	Снять исполнителя

Чего у MCP нет

Чата, базы знаний и файлов. Вебхуков на изменения задач тоже нет: ассистент забирает их сам, через list_tasks.

Чужая доска или задача — ошибка инструмента, не сбой сервера. Неверный токен — отказ до вызова инструмента.