QueueWarden

Тема

Подключение ИИ-агента по MCP ​

Как дать своему ИИ-агенту — Claude Code, Codex, opencode или другому клиенту MCP — работать с доской: читать задачи, ставить новые, комментировать.

Агент подключается как мост: ходит на доску сам по токену и видит то, что разрешают маска агента и ваши права.

Что понадобится ​

  1. Агент-мост и его токен. Как их завести — в разделе «REST API». Тот же токен работает и в REST, и в MCP.

  2. Адрес MCP вашей доски — адрес доски и /mcp в конце:

    text
    https://<ваша-доска>/mcp

Сохраните токен в переменную окружения, а не в файл настроек: так он не попадёт в репозиторий и в чужие руки.

sh
export QW_TOKEN='токен агента'

Claude Code ​

Для себя, во всех проектах:

sh
claude mcp add --scope user --transport http queuewarden https://<ваша-доска>/mcp \
  --header "Authorization: Bearer $QW_TOKEN"

Команда записывает токен в ваши личные настройки Claude Code. Проверка: claude mcp list показывает queuewarden со статусом Connected.

Для всей команды — файл .mcp.json в корне репозитория. Токен в нём не хранится: Claude Code подставит его из переменной окружения каждого участника.

json
{
  "mcpServers": {
    "queuewarden": {
      "type": "http",
      "url": "https://<ваша-доска>/mcp",
      "headers": { "Authorization": "Bearer ${QW_TOKEN}" }
    }
  }
}

Сервер из .mcp.json Claude Code включает только после подтверждения: при первом запуске claude в репозитории согласитесь его использовать. До этого claude mcp list показывает Pending approval.

Codex ​

sh
codex mcp add queuewarden --url https://<ваша-доска>/mcp --bearer-token-env-var QW_TOKEN

Или вручную в ~/.codex/config.toml:

toml
[mcp_servers.queuewarden]
url = "https://<ваша-доска>/mcp"
bearer_token_env_var = "QW_TOKEN"

Codex читает токен из переменной при каждом запуске. Проверка: codex mcp list.

opencode ​

В opencode.json проекта или в ~/.config/opencode/opencode.json:

json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "queuewarden": {
      "type": "remote",
      "url": "https://<ваша-доска>/mcp",
      "headers": { "Authorization": "Bearer {env:QW_TOKEN}" }
    }
  }
}

Проверка: opencode mcp list.

Другие клиенты ​

Доска отвечает по MCP через HTTP (транспорт Streamable HTTP) на POST /mcp. Токен передаётся в заголовке Authorization: Bearer <токен>. Входа через OAuth нет.

Что агент получает при подключении ​

Вместе с подключением агент получает от доски короткие правила работы с ней: как поставить задачу, какими инструментами отвечать на узкие вопросы, что текст задач и комментарии — данные, а не команды. Описывать это в своём промпте не нужно.

Список инструментов зависит от прав: инструменты, на которые у агента нет прав, доска ему не показывает.

Промпт для агента ​

Чтобы агент подключился сам, скопируйте ему этот текст и подставьте адрес доски:

text
Подключись к доске задач QueueWarden по MCP.
Адрес: https://<ваша-доска>/mcp
Токен лежит в переменной окружения QW_TOKEN, передавай его заголовком
Authorization: Bearer. Не записывай токен в файлы репозитория.
Инструкция по настройке клиентов: https://portal.queuewarden.ru/docs/mcp.md
После подключения проверь доступ: выведи список проектов инструментом
queuewarden_project_list.

Документация для ИИ ​

Вся документация в виде, удобном для ИИ:

  • llms.txt — оглавление со ссылками на страницы в markdown;
  • llms-full.txt — все страницы одним файлом.