CoRoidコネクターは、ご自身のマシン上で動作するコーディングエージェントがCoRoidのために作業を行うためのプログラムです(詳細はご自身のマシン上で動作するコーディングエージェント)。このコネクターはApache-2.0ライセンスの下でオープンソースであり、その完全なソースコードはgithub.com/COROID-AI/coroid-connectorにあります。 このページは、組織内のマシンで本コネクターを実行できるかどうかを判断する方のためのものです。
データの流れ
あなたのマシン
CoRoidコネクター
オープンソース。新しい空のディレクトリでエージェントを起動し、終了後に停止させます。
あなたのコーディングエージェント
使用するエージェントは、あなたのアカウントでサインインし、自身のツールは無効化されています。
- 1作業を依頼します。 各要求の処理時間は最大25秒で、コネクターは3秒ごとにエージェントの発言を報告します。
- 2その役割のツールを呼び出します。 この処理専用のトークンが使用され、処理終了と同時に無効になります。
- 3自身のモデルに問い合わせます。 CoRoidがなければ通常通りの動作となります。CoRoidはそのサインイン情報を一切参照しません。
CoRoid
オーケストレーター
タスクを開始した人のマシンに、役割に応じた作業を割り当てます(1)。
その役割が利用するツール
タスクのサンドボックス内で実行され、あなたのコードはそこに保持されます(2)。
エージェントのプロバイダー
あなたのアカウントでサインインし、ご自身のプランに基づいてエージェントのモデル要求に応答します(3)。
マシン内に侵入することはありません:コネクターはポートを開放せず、ファイルを送信せず、自身のコマンドを実行しません。
マシン内には、エージェントへのあなたのサインイン情報と、処理中にエージェントが保持するデータのみが残ります。
- 送信のみ。コネクターはポートを開くことはありませんが、一瞬だけ
127.0.0.1ログイン時には例外となります。コネクターはHTTPS経由でCoRoidに作業を依頼します。各リクエストは最大25秒間保持され、その後再び依頼されるため、これによりCoRoidはマシンが接続されていることを把握できます。 - ご自身のコードはCoRoid内に留まります。リポジトリは決してマシンにコピーされません。ロールのツール(ファイルの読み取り、テストの実行、コードの変更)はCoRoid内のタスク用サンドボックスで実行されます。マシンに届くのは、ロールの指示と、それらのツールが返す結果、例えばエージェントが読み取ったファイルの内容やテスト実行の出力などです。
- エージェントのモデルへのリクエストはプロバイダーに送信されます、これらはご自身のログイン情報とご利用のプランに基づき、CoRoidを使用しない場合と同様に処理されます。エージェントがモデルに送信する内容にはロールのツールが返した結果が含まれるため、そのプロバイダーとの契約が適用されます。
- 作業は開始した人のみに割り当てられます。ロールがマシン上で実行されるのは、その割り当てでエージェントが指定されており、タスクを開始した人が該当組織内で接続済みのマシンを持ち、かつ組織のポリシーでそのエージェントの使用が許可されている場合のみです。自動化処理など、誰も開始していない作業はそのモデル上で実行されます。
コネクターが行う処理
- ログインブラウザ上でOAuth 2.1およびPKCEを使用して、1つのスコープで行います(
connector.turns)。アクセストークンの有効期間は15分、リフレッシュトークンは30日で、使用するたびに更新されます。切断はご自身のマシンで両方のトークンが無効化されます。 - これらのトークンを保持しますmacOSのキーチェーンまたはLinuxデスクトップのSecret Serviceに保存し、標準入力経由でこれらのツールに渡します。これらの環境が存在しない場合のみ、ご自身のみが読み取れるファイルに保存されます。
coroid-connector statusではトークンの保存場所を確認できます。 - CoRoidに通知します最初のリクエスト時に、マシン名、オペレーティングシステム、自身のバージョン、各エージェントのバージョン・状態・提供するモデルを伝えます。
- 1回の処理を実行します:エージェントを新しい空のディレクトリで起動し、エージェント自身のツールは無効化します。その処理用のツールセット(その回のロール用ツール)を与え、エージェントの発言を中継し、これらのツールへの呼び出し以外の権限要求は拒否し、その後エージェントを停止します。最後にそのディレクトリを削除します。
コネクターが行わない処理
- ご自身のファイルを読み取ったり送信したり、自身のコマンドを実行したりしません。自身のファイル以外で読み取るのはCursorの設定ファイルのみで、Cursorの使用可否を決定する2つの値を確認するためです(制限事項を参照)。これらのデータはマシンから外に出ることはありません。
- エージェントにシェル、ファイル編集、ウェブ検索、自身のMCPサーバーやコネクターの使用を許可しません。各エージェントは試験済みのバージョンにおいて、自身の対応スイッチが有効な状態で起動されます。別のバージョンのエージェントは一覧に表示されるのみで使用されません。
- 他者がアクセス可能なポートを開いたり、開いた接続経由でCoRoid以外から指示を受け付けたりしません。
- 実行中に何かをダウンロードすることもありません。
coroid-connector addエージェントのアダプターは一度のみインストールされ、リリースのlockfileに記載されたパッケージ(バージョンとSHA-512で固定)からインストールされ、インストールスクリプトは無効化されます。
送信するリクエスト
| 宛先 | タイミング | 目的 |
|---|---|---|
CoRoidのAPI(https://api.coroid.ai) | ログインとログアウト | コネクターの登録、トークンの交換・更新・無効化(/oauth/…) |
| CoRoidのAPI | 実行中 | 作業を依頼するため(/connector/v1/poll)および処理結果を報告するため(/connector/v1/turns/…/events) |
| npmレジストリ | 実行中のみcoroid-connector add | アダプターはリリースのlockfileに記載されたパッケージを使用します |
エージェントではなくコネクターが、ロールのツール(
下のアドレスにある/connector/v1/turns/、その回のトークンを用いて)および自身のプロバイダーを呼び出します。
耐えうる仕様
| もし | その場合 |
|---|---|
| 他者があなたになりすましてマシンの接続を依頼した場合 | 承認処理は、ご自身のブラウザでログインした状態で行われ、サインインはそれを開始したマシン上でのみ完了します(127.0.0.1、PKCEを使用)。直前に開始したコネクターのみを承認してください。 |
| コネクターのトークンが盗まれる場合 | アクセス範囲は1つだけで、その人物の作業内容を照会し、報告するためのものです。アクセストークンは15分以内に有効期限が切れ、『切断』操作により両方とも無効化されます。 |
| あるターンのトークンが再利用される場合 | その動作はそのターン中のみ有効で、ターンが終了すると機能しなくなります。 |
| あるターンでエージェントに別の要求がなされる場合 | エージェント自体のツールは無効化されており、コネクターは他の権限要求を拒否します。ロールに割り当てられたツールはクラウドモデルと同じで、QA、レビュー、ゲート、ステップ制限も同様です。 |
| リリース内容がソース情報と一致しない場合 | 各リリースは、パブリックリポジトリのタグ付きコミットからGitHub Actionsによってビルドされ、検証済みの状態でnpmに公開され、来歴情報も付与されます。Homebrewのフォーミュラは、その検証結果を確認した後にのみ新バージョンを適用します。ご自身で検証することも可能です(下記参照)。 |
制限事項
- エージェントはご自身の権限を持ってマシン上で実行されます。CoRoidのツールの利用可否は各エージェント個別の設定に依存しており、そのためコネクターはテスト済みのバージョンでのみエージェントを使用します。
- エージェントがターン中に自身のストレージに保持するデータはエージェントごとに異なります(詳細は マシン上に残るデータ)。組織のポリシーにより、従業員が利用できるエージェントが決定されます(詳細は 組織が許可する内容)。
- Cursorは、デフォルト設定ではウェブ取得、ウェブ検索、ブラウザ機能を使用する前に確認を求めます。コネクターはマシン上の2つの設定(承認モード、ウェブ検索の自動許可の有無)を読み取り、これらの設定で該当ツールの無断利用が許可されている場合にはCursorを使用しません。
- このコネクターはWindows上ではテストされていません。
リリースを確認する
GitHub上の各リリースには、公開されたパッケージ、コネクターファイル、CycloneDXの部品表が含まれていますSHA256SUMS。以下の文字列を<version>確認するリリース名に置き換えてください。
npmパッケージのレジストリ署名と来歴情報:
mkdir check && cd check && npm init -y
npm install @coroid/connector@<version>
npm audit signaturesファイルをビルドしたコミットとワークフローが記載された検証情報:
gh release download v<version> --repo COROID-AI/coroid-connector
gh attestation verify coroid-connector-<version>.tgz --repo COROID-AI/coroid-connector \
--signer-workflow COROID-AI/coroid-connector/.github/workflows/release.ymlタグ付きソースからご自身でビルドしたファイル:
git clone https://github.com/COROID-AI/coroid-connector && cd coroid-connector
git checkout v<version> && npm ci && npm run build
shasum -a 256 dist/coroid-connector.mjs # the same as its line in SHA256SUMS脆弱性を報告するには、リポジトリのセキュリティポリシー(GitHubの非公開脆弱性報告機能)をご利用ください。