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で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

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リポジトリ内の「」にはそれが記載されるため、変数として設定し、トークン自体は記載しないでください。

その他のクライアント#

Streamable HTTP経由でリモートMCPサーバーをサポートするあらゆるクライアントが接続できます。Coroidはエンドポイント用のOAuthメタデータを公開し、PKCEによる動的クライアント登録もサポートします。OAuth非対応のクライアントは、このヘッダーにビーアトークンとしてアクセストークンを送信できます：Authorization。

エージェントが何かを変更する前に、Coroidのツール一覧を表示させ、次のリソースを読み取らせてください：coroid://context」。これにより、エージェントが誰になりすまし、どのスコープとプロジェクトを利用できるかが分かります。

アクセストークン#

トークンは「アクセストークン」で作成および管理されます。他のあらゆる資格情報と同様に、一度だけ表示され、その後は再提示されません。

1つのトークンを複数のクライアントで共有するのではなく、クライアントごとに発行してください。そうすれば、単一クライアントのアクセスを無効にしても全体への影響を抑えられます。

トークンは作成したユーザーとして機能し、ポータルにログインしているユーザーのみが作成できます。各トークンには独自のスコープがあり、有効期間は30日、90日、または365日で、すべてのプロジェクトまたは選択したプロジェクトのみにアクセスできます。オーナーは自動化ポリシーを付与することも可能です。すべてのトークンは同じ接頭辞で始まります：cmp_pat_。

トークンはクライアントの環境または資格情報ストアに保管してください。決してリポジトリやプロンプトに記載しないでください。

スコープとロール#

スコープは接続が実行できる操作を定義します。組織内でのロールが制限となり、ツールを利用するにはそのスコープと最低限のロールの両方が必要です。Coroidは呼び出しのたびに現在のロールを確認するため、失われた権限が保持されることはありません。

最低ロールが管理者であるスコープを付与できるのは管理者またはオーナーのみです。最低ロールがオーナーであるスコープを付与できるのはオーナーのみです。

一部のプロジェクトに限定された接続では、タスク、プラン、スプリント、レポート、リリースのIDを介しても他のプロジェクト内のリソースにアクセスできません。また、以下のような組織全体で利用可能なツールも使用できません：list_plans、get_capacity_dashboard。

ツール#

クライアントには、有効化されており、スコープとロールで利用が許可されているツールのみが表示されます。承認列には、ツールが呼び出された際の処理内容が記載されています。

参照#

これらのツールを利用するには、レビュアーロールとこのスコープが必要です：mcp.read。いずれも承認は不要です。

リリースツールについては、こちらをご覧くださいMCP経由のリリース。

エディターからのアンチスロップルール#

この2つのアンチスロップツールにより、開発者自身のエージェントが、pull requestが存在する前から品質管理で適用される基準に従って作業を実施できます。

• anti_slop_rulesはプロジェクトで適用されるアンチスロップポリシーを返します：ルール、ブロック対象のルール、カスタムルール、隔離されたルール、Coroidがパブリックレジストリで参照できる新規依存関係、および以下のためのスニペット AGENTS.mdはローカルエージェント向けに同じルールを記述したものです。このスニペットを に貼り付けてくださいAGENTS.md、または のルールとして貼り付けてください.cursor/rulesCursor用
• anti_slop_scanは、Coroidが同期したブランチ、タグ、またはコミットをベース（別途指定がない限りデフォルトブランチ）と比較してチェックします。読み取りのみを行い、ファイルの変更、コマンドの実行、インストール、モデルの呼び出しは行いません。1分間に最大5回までの呼び出しに制限されています。

スキャンはプレビューに過ぎません。品質管理では引き続きpull requestをチェックし、その判定が最終的な結果となります。詳細はこちらをご覧くださいアンチスロップチェック。

作業の作成と変更#

これらのツールを利用するには、メンバーロールとこのスコープが必要です：mcp.work.write。

MCP経由で作成された作業は資格審査を経ません。タスクツールに送信されたプランサイズの要求は、タスクではなくドラフトプランとなります。MCP経由で作成されるプランは初期状態がドラフトです。

作業の実行#

これらのツールを利用するには、メンバーロールとこのスコープが必要です：mcp.execute。

デリバリー#

これらのツールを利用するには、メンバーロールとこのスコープが必要です：mcp.delivery。リリースについては下記に別途説明があります。

管理#

これらのツールは、組織およびそのプロジェクトの設定方法を変更します。

組織設定#

Hermesのようなエージェントは、スクリーンショット、ファイル、または説明から組織を設定できます。このエージェントはCoroidの設定フォーマットを読み取り、それをバンドルに書き込み、バンドルのプレビューを表示した後で適用します。これらのツールにはオーナー権限と以下のスコープが必要です：mcp.organization.admin。

バンドルにはシークレット値の代わりにプレースホルダーが含まれ、シークレットを含むバンドルはCoroidによって拒否されます。詳細はこちらをご覧ください。設定のエクスポートとインポート。

MCP経由でのリリース#

リリースツールはチャットアシスタントが使用するものと同じで、ポータルと同じRelease APIを通じて処理されます。

create_release完全なコミットSHA、最近のコミットの短いSHAを受け付けます。latestバージョンを指定しない場合は、プロジェクトのバージョンソースからバージョンが決定されます。get_release各環境ごとにチェック内容、最後のデプロイメント、パイプラインが報告したバージョン、およびCoroidが実行中のバージョンを検証したかどうかを報告します。一部のプロジェクトに限定されたトークンでは他のプロジェクトのリリースにアクセスできません。Release APIは独自の承認ルールを適用するため、MCP経由の承認もポータルでの承認と同等に扱われます。

list_release_pull_requestsCoroidが提案する順序で、プロジェクトの未解決なプルリクエストを返します。除外される理由も併せて示されます。bundle_release_pull_requestsこれらからリリースを作成します。つまり、プルリクエストを順番にマージしたリリースブランチとリリース pull requestを生成します。ブランチをプッシュしてpull requestを開くため、必ず人の介入を待ちます。除外する場合はprNumbersCoroidの選択を利用するにはこちらを指定してください。

承認と自動化ポリシー#

承認人間の介入を待つアクションのキューです。自動化ポリシーそのキューに何を入れるかを決定します。

これが最も重要な制御です。外部クライアントがあなたに代わって作業する場合、日常的な作業は自由に行え、重要な作業は人の承認が必要です。無人で実行されるシステムにトークンを渡す前に、ポリシーを設定してください。

承認が必要な呼び出しの場合、クライアントは結果ではなく承認IDとリンクを受け取ります。オーナーまたは管理者が正確なツールと引数を確認した後で、呼び出しを承認または拒否します。承認すると、呼び出しは元の通りに実行され、その後でクライアントが内容を変更することはできません。10分以内に誰も承認しない呼び出しは無効になります。

自動化ポリシーを使うと、Policyとマークされたツールを承認を待たずに実行できます。ポリシーを作成し、トークンに適用できるのはオーナーのみです。ポリシーでは具体的なツールを指定し、対象プロジェクトを限定し、1時間・1日あたりの実行回数や同時実行数を制限できます。有効期限を設定することも可能です。ポリシーを無効にすると、それに紐づくすべてのトークンも無効になります。Alwaysとマークされたツールはポリシーの対象外です。

OAuth接続ではポリシーを適用できません。OAuthを介すると、Policyとマークされたすべてのツールが承認を待ちます。

再試行、操作、およびリソース#

何かを変更するすべてのツールにはこのパラメーターが必要です：idempotencyKey新しいアクションごとに新しいキーを使用し、再試行時には同じキーを使います。そうするとCoroidは2度目の実行をせずに最初の結果を返します。異なる引数で同じキーを使用すると、要求は拒否されます。

変更にはそのステータスと結果を記録する操作も返されます。以下の4つのツールはすべての接続で利用できます：

サーバーは以下のリソースも提供します：

さらに3つのプロンプトも提供されます：create_and_run_task、investigate_failure、prepare_release。

各ツールには1分、1時間、1日あたりの制限があります。制限を超える呼び出しは失敗し、再試行までの待機時間が通知されます。

意図的に公開しない機能#

ツールレジストリは厳格に管理されており、除外は意図的なものです。以下の機能は提供されません：

• シェル
• Gitアクセス
• ファイルシステム
• 生のデータベースアクセス
• 任意の内部HTTP
• Coroid自身の送信側MCP管理ツール

管理機能を利用できるようになります。作業— タスク、計画、プロジェクト、リリースを作成・確認できます。これはリモート実行環境ではありません。MCPクライアントはCoroidを任意のコマンドを実行する手段として使用することはできません。

主な用途#

既に利用中のエディター、アシスタント、社内ツールからCoroidを操作でき、ポータルに切り替える必要がありません。ターミナルからタスクを作成したり、アシスタントにブロック要因を確認させたりするといった操作がローカルで行えます。

関連項目#

• 作業を開始する方法
• 設定のエクスポートとインポート
• 外部MCPサーバー
• チャットアシスタント
• 来歴