Coroid в качестве сервера MCP

Coroid предоставляет удалённый сервер протокола Model Context Protocol (MCP). Внешний помощник или агент, такой как Hermes, Codex, Claude Code или Cursor, может использовать его для работы с Coroid через тот же реестр управляемых инструментов, что и чат-ассистент.

Настройте параметры в разделе Настройки → Подключения → Coroid MCP сервер, который охватывает Обзор, Настройка клиента, Токены доступа, Согласования и Политики автоматизации.

Конечная точка#

Сервер MCP работает на шлюзе API, по этому адресу:

https://api.coroid.ai/mcp

Транспорт — это бесконтекстный Streamable HTTP. Аутентифицируйтесь с помощью OAuth или персонального токена доступа.

Что включено#

Coroid включает возможности MCP поэтапно, сразу для всех организаций.

Пока возможность не будет включена, клиенты не увидят её инструменты, и Coroid отклонит вызовы к ним. Остальная часть этой страницы описывает полный набор возможностей.

Подключите клиент#

Используйте OAuth, если ваш клиент его поддерживает. Вы утверждаете подключение в браузере и можете отозвать его в любой момент. Токены доступа действуют 15 минут, а токены обновления — 30 дней; каждое обновление заменяет токен обновления.

При подключении клиент запрашивает области доступа. Перед утверждением вы видите эти области и выбираете, может ли клиент получить доступ ко всем проектам или только к некоторым. Клиент, который не запрашивает областей доступа, получает только права чтения, поэтому запрашивайте нужные области, как в примере с Codex.

Hermes#

hermes mcp add coroid --url https://api.coroid.ai/mcp --auth oauth
hermes mcp login coroid
hermes mcp test coroid

Вместо этого используйте токен доступа:

hermes mcp add coroid --url https://api.coroid.ai/mcp --auth header

Передайте токен Hermes, когда он его запросит. Храните его в хранилище учётных данных Hermes, а не в конфигурационном файле.

Codex#

codex mcp add coroid --url https://api.coroid.ai/mcp
codex mcp login coroid --scopes mcp.read,mcp.work.write,mcp.execute,mcp.delivery

Вместо этого используйте токен доступа:

export COROID_MCP_TOKEN="cmp_pat_…"
codex mcp add coroid --url https://api.coroid.ai/mcp --bearer-token-env-var COROID_MCP_TOKEN

Claude Code#

claude mcp add --transport http --scope user coroid https://api.coroid.ai/mcp
/mcp

Выполните первую команду в терминале. Затем введите вторую в Claude Code, выберите Coroid и войдите в систему через браузер.

Вместо этого используйте токен доступа:

export COROID_MCP_TOKEN="cmp_pat_…"
claude mcp add --transport http --scope user --header "Authorization: Bearer $COROID_MCP_TOKEN" coroid https://api.coroid.ai/mcp

Cursor#

Добавьте Coroid в ~/.cursor/mcp.json, или в .cursor/mcp.json в репозитории, чтобы поделиться настройкой со всеми участниками проекта:

{
  "mcpServers": {
    "coroid": {
      "url": "https://api.coroid.ai/mcp"
    }
  }
}

Cursor входит в систему через OAuth: утвердите подключение в браузере при запросе. Проверьте области доступа на экране, так как подключение без прав на запись позволяет только чтение.

Вместо этого используйте токен доступа:

{
  "mcpServers": {
    "coroid": {
      "url": "https://api.coroid.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${env:COROID_MCP_TOKEN}"
      }
    }
  }
}

Установите COROID_MCP_TOKEN в среде, из которой запускается Cursor. .cursor/mcp.json в репозитории сохраняется вместе с ним, поэтому размещайте переменную там, а не сам токен.

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

Любой клиент, поддерживающий удалённые серверы MCP по протоколу Streamable HTTP, может подключиться. Coroid публикует метаданные OAuth для конечной точки и поддерживает динамическую регистрацию клиентов с использованием PKCE. Клиент без поддержки OAuth может отправлять токен доступа как маркер авторизации в этом заголовке: Authorization.

Прежде чем агент что-либо изменит, попросите его перечислить инструменты Coroid и прочитать этот ресурс: coroid://context. Он покажет, от имени кого действует агент, какие у него области доступа и проекты.

Токены доступа#

Токены создаются и управляются в разделе Токены доступа. Как и все остальные учётные данные, они отображаются один раз и больше не возвращаются.

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

Токен действует от имени человека, который его создал, и его может создать только пользователь, вошедший в портал. У каждого токена свои области доступа; он истекает через 30, 90 или 365 дней и охватывает все проекты или только выбранные вами проекты. Владелец также может привязать политику автоматизации. Все токены начинаются с одного и того же префикса: cmp_pat_.

Храните токен в среде клиента или в хранилище учётных данных. Никогда не размещайте его в репозитории или в запросе на ввод текста.

Области доступа и роли#

Область доступа определяет, что может делать подключение. Ваша роль в организации задаёт ограничения: для работы с инструментом нужны как соответствующая область доступа, так и достаточная роль. Coroid проверяет вашу текущую роль при каждом вызове, чтобы подключение не сохраняло права, которые вы уже потеряли.

Только администратор или владелец могут предоставить область доступа с минимальной ролью «Администратор». Только владелец может предоставить область доступа с минимальной ролью «Владелец».

Подключение, ограниченное определенными проектами, не может получить доступ к данным других проектов, даже по идентификатору задачи, плана, спринта, отчета или релиза. Оно также не может использовать инструменты на уровне всей организации, такие как: list_plans, get_capacity_dashboard.

Инструменты#

Ваш клиент отображает только те инструменты, которые включены и разрешены вашей областью доступа и ролью. В столбце «Утверждение» указано, что происходит при вызове инструмента:

Чтение#

Для этих инструментов требуется роль «Рецензент» и следующая область доступа: mcp.read. Ни для одного из них не требуется утверждение.

Инструкции по использованию инструментов релизов см. здесь: Релизы через MCP.

Правила анти-шлака из вашего редактора#

Два инструмента анти-шлака позволяют агенту разработчика соответствовать стандартам Quality Control, применяемым ко всем pull request еще до их существования.

• anti_slop_rules возвращает опубликованную политику анти-шлака проекта: правила, какие из них блокируют действия, пользовательские правила, правила карантина, какие новые зависимости Coroid может искать в публичных реестрах, а также фрагмент кода для AGENTS.md — фрагмент кода, описывающий те же правила для локального агента. Вставьте этот фрагмент в AGENTS.md, или в правило в .cursor/rules для Cursor.
• anti_slop_scan проверяет ветку, тег или коммит, которые Coroid синхронизировал с базовой версией — стандартной веткой, если не указана другая. Он только читает: не меняет файлы, не запускает команды, ничего не устанавливает и не вызывает модель. Допустимо не более 5 вызовов в минуту.

Сканирование — это предварительный просмотр. Quality Control все равно проверяет pull request, и именно его вердикт имеет решающее значение. См. Проверки анти-шлака.

Создание и изменение работы#

Для этих инструментов требуется роль «Участник» и следующая область доступа: mcp.work.write.

Работа, созданная через MCP, не проходит этап Qualification. Запрос размером с план, отправленный в инструмент задач, превращается в черновик плана, а не в задачу. Планы, созданные через MCP, изначально являются черновиками.

Выполнение работы#

Для этих инструментов требуется роль «Участник» и следующая область доступа: mcp.execute.

Доставка#

Для этих инструментов требуется роль «Участник» и следующая область доступа: mcp.delivery. Информация о релизах приведена в отдельном разделе ниже.

Администрирование#

Эти инструменты изменяют настройки организации и ее проектов.

Настройки организации#

Агент вроде Hermes может настроить организацию на основе скриншотов, файлов или описания. Он считывает формат настроек Coroid, записывает их в пакет, предварительно просматривает пакет и затем применяет его. Для работы этих инструментов требуется роль Владелец и следующая область доступа: mcp.organization.admin.

В пакете используются плейсхолдеры вместо значений секретов, а Coroid отклоняет пакет, содержащий секретные данные. Подробнее см. Экспорт и импорт настроек.

Релизы через MCP#

Инструменты для релизов — те же, что и у чат-ассистента, и они проходят через тот же механизм Согласования API, что и в портале:

create_release Принимает полный хеш коммита, краткий хеш недавнего коммита или latest, и оставляет версию на усмотрение источника версий проекта, если вы не укажете её явно. get_release Выводит по каждой среде данные о проверках, последней развёртке, версии, указанной конвейером, и информацию о том, подтвердил ли Coroid корректность запущенной версии. Токен, ограниченный определёнными проектами, не сможет получить доступ к релизам в других проектах. Механизм Согласования API всё равно применяет собственные правила, поэтому согласование через MCP имеет такую же силу, как и в портале.

list_release_pull_requests Возвращает открытые pull request проекта в порядке, предложенном Coroid, с указанием причин исключения некоторых из них. bundle_release_pull_requests Создаёт релиз на их основе: ветку релиза с объединёнными в нужном порядке pull request и pull request релиза. Система создаёт ветку и открывает заявку на Согласование pull request, поэтому всегда ожидает решения человека. Исключите prNumbers чтобы использовать выборку Coroid.

Согласования и политики автоматизации#

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

Это ключевой элемент управления. Внешний клиент, действующий от вашего имени, должен иметь возможность свободно выполнять рутинные операции, а для значимых действий — получать одобрение человека. Установите политику перед тем, как передать токен любому процессу, работающему автономно.

Если для вызова требуется согласование, клиент получает ID согласования и ссылку вместо результата. Владелец или администратор проверяет точные параметры инструмента и аргументы, после чего согласует или отклоняет вызов. При согласовании вызов выполняется точно так, как был сделан, и клиент не может его изменить позже. Вызов, не согласованный в течение 10 минут, истекает.

Политика автоматизации позволяет токену доступа запускать инструменты, помеченные как Policy, без ожидания согласования. Политики создают только владельцы и привязывают их к токенам. В политике указываются конкретные инструменты, она может быть ограничена определёнными проектами и устанавливать лимиты на количество вызовов в час, в день и одновременно. Политика также может иметь срок действия. Отзыв политики влечёт за собой отзыв всех токенов, к ней привязанных. Инструменты, помеченные как Always, никогда не попадают под действие политики.

Подключение OAuth не может содержать политику. Через OAuth любой инструмент, помеченный как Policy, ожидает согласования.

Повторные попытки, операции и ресурсы#

Для каждого инструмента, изменяющего данные, требуется этот параметр: idempotencyKey. Используйте новый ключ для каждого нового действия и тот же ключ при повторной попытке. Coroid затем вернёт первый результат вместо повторного выполнения действия. Ключ, использованный с другими аргументами, будет отклонён.

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

Сервер также предоставляет следующие ресурсы:

Также предусмотрены три подсказки: create_and_run_task, investigate_failure, prepare_release.

Каждый инструмент имеет лимиты на количество вызовов в минуту, в час и в день. Вызов, превышающий лимит, завершается ошибкой с указанием времени ожидания перед повторной попыткой.

Что намеренно не предоставляется#

Реестр инструментов контролируется, и исключения сделаны осознанно. Он не предоставляет следующее:

• оболочка
• Доступ к Git
• файловая система
• прямой доступ к базе данных
• произвольные внутренние HTTP-запросы
• Собственные инструменты Coroid для управления MCP-администрированием

Вы получаете возможность управлять работой — создавать и проверять задачи, планы, проекты и релизы — это не среда удаленного выполнения. Клиент MCP не может использовать Coroid для запуска произвольных команд.

Для чего это предназначено#

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

Сопутствующие материалы#

• Способы начать работу
• Экспорт и импорт настроек
• Внешние MCP-серверы
• Ассистент Чат
• Происхождение