CoroidはリモートのModel Context Protocol (MCP) サーバーを提供します。Hermes、Codex、Claude Codeなどの外部アシスタントやエージェントは、チャットアシスタントが使用するのと同じ管理されたツールレジストリを通じて、Coroidと連携できます。
設定は設定 → 接続 → Coroid MCPサーバー、これには概要、クライアント設定、アクセストークン、承認および自動化ポリシー。
エンドポイント
MCPサーバーはAPIゲートウェイ上で稼働し、次のアドレスからアクセスできます：
https://api.coroid.ai/mcp通信プロトコルはステートレスなStreamable HTTPです。OAuthまたは個人用アクセストークンで認証します。
有効になっている機能
Coroidでは、各組織に対してMCP機能が段階的に有効になります。
| 機能 | coroid.ai上 |
|---|---|
| OAuthログイン | 有効 |
| ツールの読み取り | 有効 |
| パーソナルアクセストークン | 有効 |
| 作業の作成、変更、実行、配信を行うツール | 有効 |
| 組織設定を含む管理ツール | まだ利用不可 |
機能が有効になるまで、クライアントには該当するツールが表示されず、Coroidもそれらの呼び出しを拒否します。このページの残りの部分では全ての機能について説明します。
クライアントを接続する
クライアントがOAuthをサポートしている場合は、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 headerHermesがトークンを要求した際に渡してください。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で2番目のコマンドを入力し、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その他のクライアント
Streamable HTTP経由でリモートMCPサーバーに対応するあらゆるクライアントが接続可能です。Coroidはエンドポイント用のOAuthメタデータを公開し、PKCEによる動的クライアント登録もサポートしています。OAuth非対応のクライアントは、次のヘッダーにビーアトークンとしてアクセストークンを送信できます：Authorization。
エージェントが何かを変更する前に、Coroidのツール一覧を表示させ、以下のリソースを読み取らせてください：coroid://context。これにより、エージェントが誰になりすまし、どのスコープとプロジェクトを持っているかが確認できます。
アクセストークン
トークンの作成や管理はアクセストークンで行います。他の認証情報と同様に、一度だけ表示され、以降は再取得できません。
1つのクライアントにつき1つのトークンを発行し、共有しないでください。そうすれば、特定のクライアントのアクセスを無効にするだけで済み、全ユーザーに影響を与えることはありません。
トークンは作成したユーザーとして動作し、ポータルにログインしているユーザーのみが作成できます。各トークンには独自のスコープがあり、有効期間は30日、90日、または365日で、利用可能なプロジェクトは全てまたは選択したプロジェクトのみです。オーナーは自動化ポリシーを付与することも可能です。すべてのトークンは同じ接頭辞で始まります：cmp_pat_。
クライアントの環境変数または認証情報ストアにトークンを保存してください。決してリポジトリやプロンプト内に記載しないでください。
スコープとロール
スコープとは、接続が実行できる操作を定義します。組織内でのロールがその制限を決定します。ツールにはスコープと最低限のロールの両方が必要です。Coroidは呼び出しごとに現在のロールを確認するため、失効した権限が保持されることはありません。
| スコープ | 利用可能な機能 | 最低ロール |
|---|---|---|
mcp.read | プロジェクト、タスク、プラン、スプリント、レポート、依存関係、キャパシティ、エージェント実行、ファクトリーレーン、プロモーション、リリースの参照 | レビュアー |
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 | 予約済み。現時点では使用するツールはありません。 | オーナー |
最低ロールが管理者であるスコープを付与できるのは管理者またはオーナーのみです。最低ロールがオーナーであるスコープを付与できるのはオーナーのみです。
特定のプロジェクトに限定された接続は、タスク、プラン、スプリント、レポート、リリースのIDを通じても他のプロジェクトのデータにアクセスできません。また、以下のような組織全体で利用可能なツールも使用できません：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 |
| ファクトリーのレーンとプロモーション | 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 | ポリシー |
| ファクトリー | start_global_execution、pause_global_execution、resume_global_execution、pause_factory_lane、resume_factory_lane | ポリシー |
| ファクトリー | 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経由のリリース
リリースツールはチャットアシスタントが使用するものと同じで、ポータルと同じRelease 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完全なコミットSHA、最近のコミットの短いSHA、またはlatestを指定でき、バージョンを指定しない場合はプロジェクトのバージョンソースに従います。get_releaseは各環境ごとにチェック内容、最新のデプロイメント状況、パイプラインが報告したバージョン、Coroidが実行中のバージョンを検証したかどうかを報告します。一部のプロジェクトに限定されたトークンでは他のプロジェクトのリリースにアクセスできません。Release APIは独自の承認ルールを適用するため、MCP経由の承認もポータルでの承認と同等に扱われます。
list_release_pull_requestsCoroidはプロジェクト内の未マージのプルリクエストを、提案された順序で返却し、除外される理由も併せて示します。bundle_release_pull_requestspull requestはこれらのプルリクエストからリリースを作成します。つまり、プルリクエストを順番にマージしたリリースブランチと1つのリリースpull requestが生成されます。ブランチがプッシュされてpull requestが開かれるため、常に人の承認を待機します。prNumbersCoroidの選定結果を利用するにはこちらを指定してください。
承認と自動化ポリシー
承認とは、人間の承認を待つアクションのキューです。自動化ポリシーそのキューに何を入れるかを決定します。
これが最も重要な制御機能です。代わりに作業を行う外部クライアントは、日常的な作業は自由に行え、重要な作業は人の承認が必要です。無人で実行されるものにトークンを渡す前に、ポリシーを設定してください。
承認が必要な呼び出しの場合、クライアントには結果ではなく承認IDとリンクが渡されます。オーナーまたは管理者が該当するツールと引数を確認した後、呼び出しを承認または拒否します。承認されると、呼び出しは元の通りに実行され、その後でクライアントが内容を変更することはできません。10分以内に誰も承認しない呼び出しは無効になります。
自動化ポリシーを使うと、Policyとマークされたツールを承認を待たずにアクセストークンで実行できます。ポリシーを作成し、トークンに適用できるのはオーナーのみです。ポリシーでは具体的なツールを指定し、対象となるプロジェクトを限定したり、1時間・1日あたりの実行回数や同時実行数に上限を設けたり、有効期限を設定したりできます。ポリシーを無効にすると、それに紐付くすべてのトークンも無効になります。Alwaysとマークされたツールはポリシーの対象外です。
OAuth接続ではポリシーを適用できません。OAuth経由では、Policyとマークされたツールはすべて承認を待ちます。
再試行、操作、リソース
何かを変更するすべてのツールには、このパラメーターが必要です：idempotencyKey新しいアクションごとに新しいキーを使用し、再試行時には同じキーを使います。そうするとCoroidは2度実行せずに最初の結果を返します。異なる引数で同じキーを使用すると、要求は拒否されます。
変更処理では、ステータスと結果を記録する操作も返されます。以下の4つのツールはすべての接続で利用できます：
| ツール | 機能 |
|---|---|
get_operation | 操作のステータスと結果を返す |
wait_for_operation | 操作の状態が変化するまで最大25秒間待機する |
cancel_operation | まだ開始されていない操作をキャンセルする |
get_approval | 承認のステータスと結果を返す |
サーバーでは以下のリソースも提供されます：
| リソース | 内容 |
|---|---|
coroid://context | 接続が操作を実行する際の役割、スコープ、プロジェクト |
coroid://capabilities | この接続で利用できるツール |
coroid://operations/{operationId} | 1つの操作 |
coroid://approvals/{approvalId} | 1件の承認 |
さらに3つのプロンプトも提供されます：create_and_run_task、investigate_failure、prepare_release。
各ツールには1分、1時間、1日あたりの利用制限があります。制限を超える呼び出しは失敗し、再試行までの待機時間が通知されます。
意図的に公開しない機能
ツールレジストリは管理されており、除外されている機能は意図的なものです。以下の機能は提供されません：
- シェル
- Gitアクセス
- ファイルシステム
- 生のデータベースアクセス
- 任意の内部HTTP
- Coroid自身の外部MCP管理ツール
利用できるのは作業の管理 — タスク、計画、プロジェクト、リリースの作成や確認 — です。リモート実行環境ではありません。MCPクライアントがCoroidを使って任意のコマンドを実行することはできません。
利用用途
既に利用中のエディターやアシスタント、社内ツールからCoroidを操作でき、ポータルに切り替える必要はありません。ターミナルからタスクを作成したり、アシスタントにブロックされている作業を確認させたりするのも、ローカルで行える操作です。