Coroid предоставляет удаленный сервер протокола Model Context Protocol (MCP). Внешний помощник или агент, например Hermes, Codex или Claude Code, может использовать его для работы с Coroid через тот же реестр контролируемых инструментов, что и чат-ассистент.
Настройте параметры в разделе Настройки → Подключения → Coroid MCP сервер, где доступны Обзор, Настройка клиента, Токены доступа, Согласования и Политики автоматизации.
Эндпоинт
Сервер MCP работает на шлюзе API, по этому адресу:
https://api.coroid.ai/mcpТранспорт — это статeless Streamable HTTP. Аутентификация осуществляется через OAuth или персональный токен доступа.
Какие возможности включены
Coroid включает возможности MCP поэтапно, сразу для всех организаций.
| Возможность | На coroid.ai |
|---|---|
| Вход в систему через OAuth | Включено |
| Чтение инструментов | Включено |
| Персональные токены доступа | Включено |
| Инструменты, создающие, изменяющие, запускающие или передающие задачи | Включено |
| Административные инструменты, включая Настройки организации | Пока нет |
Пока возможность не будет включена, клиенты не увидят соответствующих инструментов, и 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_TOKENClaude 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Другие клиенты
Любой клиент, поддерживающий удаленные серверы MCP по протоколу Streamable HTTP, может подключиться. Coroid публикует метаданные OAuth для конечной точки и поддерживает динамическую регистрацию клиентов с использованием PKCE. Клиент без поддержки OAuth может отправлять токен доступа в виде маркера авторизации в этом заголовке: Authorization.
Прежде чем агент что-либо изменит, попросите его перечислить инструменты Coroid и прочитать этот ресурс: coroid://context. Он покажет, от имени кого действует агент, с какими областями доступа и проектами.
Токены доступа
Токены создаются и управляются в разделе Токены доступа. Как и любые другие учетные данные, они отображаются один раз и больше не возвращаются.
Выдавайте по одному токену на клиент, а не общий токен. Так отзыв доступа у конкретного клиента будет локальным действием, а не полной остановкой работы для всех.
Токен действует от имени человека, который его создал, и его может создать только пользователь, вошедший в портал. У каждого токена свои области доступа; он истекает через 30, 90 или 365 дней и охватывает все проекты или только выбранные вами проекты. Владелец также может привязать к нему политику автоматизации. Все токены начинаются с одного и того же префикса:
cmp_pat_.
Сохраните токен в среде вашего клиента или хранилище учетных данных. Никогда не помещайте его в репозиторий или запрос на ввод текста.
Области доступа и роли
Область доступа определяет возможные действия подключения. Ваша роль в организации задает ограничения: для работы инструмента необходимы как соответствующая область доступа, так и минимально допустимая роль. Coroid проверяет вашу текущую роль при каждом вызове, чтобы подключение не сохраняло права, которые у вас больше нет.
| Область доступа | Что открывается | Минимальная роль |
|---|---|---|
mcp.read | Чтение Проектов, Задач, Планов, Спринтов, Отчетов, зависимостей, загруженности, запусков агентов, полос Factory, продвижений и Релизов | Рецензент |
mcp.work.write | Создание и изменение Задач, Планов, Спринтов, зависимостей и Отчетов | Участник |
mcp.execute | Запуск, остановка, повторная попытка, приостановка, возобновление и отмена работы | Участник |
mcp.delivery | Согласование Планов, закрытие Спринтов, продвижения, валидация полос и Релизы | Участник |
mcp.projects.admin | Создание, обновление, архивирование и восстановление Проектов, а также версионирование Релизов | Администратор |
mcp.schedules.admin | Чтение, создание, обновление, запуск и удаление расписаний | Администратор |
mcp.integrations.admin | Чтение, тестирование, включение/отключение и удаление интеграций | Администратор |
mcp.secrets.write | Создание интеграций, хранящих учетные данные | Владелец |
mcp.organization.admin | Участники, приглашения, профиль организации и Настройки организации | Владелец |
mcp.billing.read | Зарезервировано. Пока ни один инструмент не использует эту функцию. | — |
mcp.billing.write | Зарезервировано. Пока ни один инструмент не использует эту функцию. | Владелец |
Только администратор или владелец могут предоставить область доступа с минимальной ролью «Администратор». Только владелец может предоставить область доступа с минимальной ролью «Владелец».
Подключение, ограниченное определенными Проектами, не может получить доступ к данным других Проектов, даже по идентификатору Задачи, Плана, Спринта, Отчета или Релиза. Оно также не может использовать инструменты общеорганизационного уровня, такие как: list_plans,
get_capacity_dashboard.
Инструменты
Ваш клиент отображает только те инструменты, которые включены и разрешены вашей областью доступа и ролью. Столбец «Согласование» указывает, что происходит при вызове инструмента:
| Согласование | Что происходит |
|---|---|
| Ничего | Инструмент запускается немедленно |
| Политика | Вызов ожидает согласования, если только это не покрыто политикой автоматизации |
| Всегда | Вызов всегда ожидает согласования от владельца или администратора |
Чтение
Для этих инструментов требуется роль «Рецензент» и следующая область доступа: mcp.read. Ни один из них не требует согласования.
| Область | Инструменты |
|---|---|
| Проекты | list_projects, get_project, get_project_dependencies, list_project_branches |
| Задачи | list_tasks, get_task, get_workflow_status, get_execution_status, check_task_can_start |
| Планы | list_plans, get_plan, get_plan_progress, list_plan_tasks |
| Спринты | list_sprints, get_sprint, get_sprint_status |
| Зависимости | analyze_dependencies, get_dependency_graph, get_global_dependency_graph, get_cross_project_blockers |
| Отчеты | list_reports, get_report, export_report, explain_report_execution, list_report_folders, list_report_subscriptions, list_report_templates |
| Загруженность и активность | get_capacity_dashboard, get_queue_eta, get_mission_control_activity, get_global_execution_stats, get_global_execution_actions, list_global_execution_runs |
| Запуск агентов | list_agent_executions, get_agent_execution, get_agent_execution_state, get_execution_conversation, list_tool_executions |
| Каналы Factory и продвижения | list_factory_lanes, get_factory_lane, list_factory_lane_tasks, get_factory_lane_gate_context, list_promotions, get_promotion |
| История кода | explain_code |
Подробнее о инструментах релизов — в разделе Релизы через MCP.
Создание и изменение работы
Для использования этих инструментов требуется роль Member и следующая область доступа: mcp.work.write.
| Область | Инструменты | Согласование |
|---|---|---|
| Задачи | create_task, update_task | Нет |
| Планы | create_plan, update_plan | Нет |
| Планы | delete_plan | Всегда |
| Спринты | create_sprint, plan_sprint, add_task_to_sprint | Нет |
| Спринты | remove_task_from_sprint | Всегда |
| Зависимости | create_dependency | Нет |
| Отчеты | create_report, update_report, create_report_folder, update_report_folder, create_report_subscription, update_report_subscription | Нет |
| Отчеты | batch_update_reports, delete_report, delete_report_folder, delete_report_subscription | Всегда |
Работа, созданная через MCP, не проходит этап проверки. Запрос размером плана, отправленный в инструмент задач, преобразуется в черновик плана, а не в задачу. Планы, созданные через MCP, изначально являются черновиками.
Выполнение работы
Для использования этих инструментов требуется роль Member и следующая область доступа: mcp.execute.
| Область | Инструменты | Согласование |
|---|---|---|
| Задачи | start_task_execution, retry_task_execution | Политика |
| Задачи | stop_task_execution | Всегда |
| Планы | start_planning_workflow, execute_plan, retry_plan_task_integration | Политика |
| Планы | cancel_plan | Всегда |
| Спринты | start_sprint | Политика |
| Отчеты | pause_report, resume_report, cancel_report, retry_report_generation | Политика |
| Factory | start_global_execution, pause_global_execution, resume_global_execution, pause_factory_lane, resume_factory_lane | Политика |
| Factory | cancel_global_execution, set_agent_execution_state | Всегда |
Доставка
Для использования этих инструментов требуется роль Member и следующая область доступа: mcp.delivery. Информация о релизах приведена ниже в отдельном разделе.
| Инструменты | Согласование |
|---|---|
approve_plan, close_sprint, create_promotion, approve_promotion, request_promotion_changes, validate_factory_lane | Политика |
force_merge_promotion | Всегда |
Администрирование
Эти инструменты определяют параметры настройки организации и её проектов.
| Инструменты | Область доступа | Самая низкая роль | Согласование |
|---|---|---|---|
create_project, update_project, restore_project | mcp.projects.admin | Администратор | Нет |
archive_project | mcp.projects.admin | Администратор | Всегда |
list_schedules, get_schedule, create_schedule, update_schedule | mcp.schedules.admin | Администратор | Нет |
trigger_schedule | mcp.schedules.admin | Администратор | Политика |
delete_schedule | mcp.schedules.admin | Администратор | Всегда |
list_integrations, get_integration | mcp.integrations.admin | Администратор | Нет |
test_integration | mcp.integrations.admin | Администратор | Политика |
set_integration_status, delete_integration | mcp.integrations.admin | Администратор | Всегда |
create_integration | mcp.secrets.write | Владелец | Всегда |
list_organization_members, list_organization_invitations | mcp.organization.admin | Владелец | Нет |
invite_organization_member, update_organization_member_role, remove_organization_member, revoke_organization_invitation, update_organization | mcp.organization.admin | Владелец | Всегда |
Настройки организации
Агент, такой как Hermes, может настроить организацию на основе скриншотов, файлов или описания. Он считывает формат настроек Coroid, записывает их в пакет, предварительно просматривает пакет и затем применяет его. Для работы с этими инструментами требуется роль Владельца и следующая область доступа: mcp.organization.admin.
| Инструмент | Назначение | Согласование |
|---|---|---|
describe_organization_settings_schema | Возвращает формат настроек, его разделы и подсказки по сопоставлению | Нет |
export_organization_settings | Экспортирует текущие настройки с плейсхолдерами для секретов | Нет |
preview_organization_settings_import | Показывает, какие изменения внесет пакет, не применяя их фактически | Нет |
apply_organization_settings_import | Применяет пакет, по умолчанию объединяя его с текущими настройками или заменяя их | Всегда |
Пакет содержит плейсхолдеры вместо значений секретов, и Coroid отклоняет пакет, если в нем присутствуют секреты. Подробнее — Экспорт и импорт настроек.
Релизы через MCP
Инструменты релизов такие же, как у чат-помощника, и они проходят через тот же релизный API, что и портал:
| Инструмент | Область применения | Согласование |
|---|---|---|
list_releases, get_release, list_release_commits, preview_release, get_release_settings, list_release_pull_requests | mcp.read | Нет |
create_release, update_release, run_release_checks, draft_release_notes | mcp.delivery | Нет |
approve_release, request_release_deployment, bundle_release_pull_requests | mcp.delivery | Всегда |
update_release_versioning | mcp.projects.admin | Нет |
create_release принимает полный хеш коммита, краткий хеш недавнего коммита или
latest, и оставляет версию на усмотрение источника версии проекта, если вы не укажете её явно. get_release отображает для каждой среды проверки, последнюю развёртку, версию, зафиксированную конвейером, и информацию о том, подтвердил ли Coroid рабочую версию. Токен, ограниченный определёнными проектами, не сможет получить доступ к релизам в других проектах. Релизный API всё равно применяет собственные правила согласования, поэтому согласование через MCP имеет тот же вес, что и согласование в портале.
list_release_pull_requests Coroid возвращает список открытых пулл-реквестов проекта в порядке, предложенном системой, с указанием причин исключения некоторых из них.
bundle_release_pull_requests создаёт из них релиз: ветку релиза
с объединёнными по порядку pull request и одним pull request релиза. Отправляет
ветку и открывает pull request, поэтому всегда ждёт действий человека. Не включайте
prNumbers Используйте выборку Coroid.
Согласования и политики автоматизации
Согласования — это очередь действий, ожидающих подтверждения человека. Политики автоматизации определяют, что должно попасть в эту очередь.
Именно этот механизм контроля имеет решающее значение. Внешний клиент, действующий от вашего имени, должен иметь возможность свободно выполнять рутинные операции, а для важных действий — требоваться согласие человека. Устанавливайте политики перед тем, как передать токен чему-либо, что работает автономно.
Если для вызова требуется согласование, клиент получает идентификатор согласования и ссылку, а не результат. Владелец или администратор проверяет точный набор инструментов и аргументов, после чего даёт либо одобрение, либо отказ. При одобрении вызов выполняется точно так, как был инициирован, и клиент не может его изменить впоследствии. Вызов, не согласованный никем в течение 10 минут, истекает.
Политика автоматизации позволяет токену доступа использовать инструменты, помеченные как Policy, без ожидания согласования. Политики создают только владельцы и привязывают их к токенам. В политике указываются конкретные инструменты, она может ограничиваться определёнными проектами и устанавливать лимиты на количество вызовов в час, в день и одновременно. Политика также может иметь срок действия. Отзыв политики влечёт за собой отзыв всех токенов, к ней привязанных. Инструменты, помеченные как Always, никогда не попадают под действие политики.
Соединение OAuth не может содержать политику. При использовании OAuth любой инструмент, помеченный как Policy, будет ожидать согласования.
Повторные попытки, операции и ресурсы
Для каждого инструмента, изменяющего данные, необходимо указать этот параметр: idempotencyKey.
Используйте новый ключ для каждого нового действия, и тот же ключ при повторной попытке. Coroid затем вернёт первый результат вместо двойного выполнения операции. Если ключ используется повторно с другими аргументами, запрос будет отклонён.
Каждое изменение также возвращает операцию, фиксирующую её статус и результат. Для любого соединения работают эти четыре инструмента:
| Инструмент | Назначение |
|---|---|
get_operation | Возвращает статус и результат операции |
wait_for_operation | Ждёт до 25 секунд изменения состояния операции |
cancel_operation | Отменяет операцию, которая ещё не началась |
get_approval | Возвращает статус и результат согласования |
Сервер также предоставляет следующие ресурсы:
| Ресурс | Содержимое |
|---|---|
coroid://context | Информация о том, от имени кого выполняется соединение, включая роль, области доступа и проекты |
coroid://capabilities | Список инструментов, доступных для этого соединения |
coroid://operations/{operationId} | Одна операция |
coroid://approvals/{approvalId} | Одно согласование |
Также доступны три подсказки: create_and_run_task, investigate_failure,
prepare_release.
Каждый инструмент имеет лимиты на количество вызовов в минуту, в час и в день. При превышении лимита вызов завершается ошибкой, и система указывает время ожидания перед повторной попыткой.
Что специально не предоставляется
Реестр инструментов находится под контролем, и такие исключения сделаны намеренно. Он не содержит следующего:
- оболочку
- доступ к Git
- файловую систему
- прямой доступ к базе данных
- произвольные внутренние HTTP-запросы
- собственные инструменты администрирования MCP от Coroid
Вы получаете возможность управлять задачами — создавать и просматривать задачи, планы, проекты и релизы — а не удаленной средой выполнения. Клиент MCP не может использовать Coroid для запуска произвольных команд.
Для чего это предназначено
Управляйте Coroid прямо из привычных инструментов — редактора, помощника или внутреннего приложения — без необходимости переходить в портал. Создавать задачу через терминал или запрашивать у помощника информацию о заблокированных элементах теперь можно как локальное действие.