concord-mcp

動作デモ

異なるハーネス上の 2 つのエージェントが、人間がコンテキストを中継することなく、互いを発見し、 メッセージを交換し、作業を分担できます。

Claude Code → Concord   Claim src/app/page.tsx
Codex       → Concord   Claim src/app/page.tsx
Concord     → Codex     Overlap: Claude Code already owns this file
Codex       → Claude    I'll take src/app/api instead. Does that work?
Claude      → Codex     Yes. I'll keep the page and use your API contract.

実際の Claude Code ↔ Codex デモ を実行して、両方の エージェントがライブのプロンプト/返信を通じて重複するクレームを解決し、プレイ可能な アプリを構築し、所有権を移譲し、結果を独立したレビュアーに引き渡す様子を確認できます。

Related MCP server: ccg-mcp-tool

クイックスタート

npm install -g @concord-ai/concord-mcp
cd /path/to/your/repository
concord setup

エージェントクライアントを再起動し、2 つのエージェントに同じリポジトリで作業するよう依頼します。 Concord は共有ワークスペースを提供し、到達可能なセッションを直接のプロンプトと返信に利用できるようにします。

concord setup はローカルの .concord/ ワークスペースを作成し、Claude、Cursor、Gemini、Grok、Codex 用に MCP サーバーを登録し（.mcp.json、.cursor/mcp.json、.gemini/settings.json、.grok/config.toml、 ~/.codex/config.toml）、Concord のツール手順をクライアント設定（CLAUDE.md、AGENTS.md、 .codex/、.cursor/rules/）に書き込みます。既存の設定を置き換えるのではなくマージするため、 再実行しても安全です。

セットアップは対応クライアントを検出し、それぞれのグローバル Concord アダプターを個別にインストール しようとします。この手順をスキップするには --no-adapters を、サポートが低下した場合に失敗させるべき 管理インストールでは --require-adapters を使用します。MCP 登録を自分で管理しながらワークスペースと 手順のみを書き込むには --no-mcp を渡します。

対応エージェント

汎用の /concord スラッシュコマンドはありません。コマンドはクライアント固有です。 Concord は MCP ツールとインストールされた手順を通じて、MCP 対応の任意の クライアントで動作します。

ライブ配信は受信側のハーネスとセッション状態に依存します。 concord adapters status を実行して、インストール済みのエージェントのうちどれが到達可能か、 メッセージがどのように配信されるかを確認してください。

コミュニケーションは出発点

メッセージングによってエージェント同士が会話できるようになります。Concord の共有ワークステートは、 メッセージが配信された後も、結果として生じるコラボレーションを確実に維持します。

Concord は別の自律エージェントやオーケストレーターではありません。エージェントの周囲に存在する 共有レイヤーです。プレゼンス、メッセージング、タスクメモリ、所有権、引き継ぎ、レビュー状態を 1 つの小さな MCP サーバーで提供します。

ツール

書き込み操作は agent_id を受け付け、作業するだけでプレゼンスをライブに保ちます。 inspect_work は 誰がここにいるか を表示し、古いクレーム をフラグします。これは、 所有エージェントが引き継ぎなしに離脱したアクティブなクレームです。

ライブのエージェント間通信には、concord setup を実行してから、既存のクライアントセッションを 1 回再起動します。プロンプトは update_work を operation: "prompt"、ターゲットの to_agent_id、 コンテンツ、idempotency_key とともに使用します。返信は operation: "reply" と reply_to_message_id を使用します。受信確認をサポートするアダプターは、ビジーなターンを誘導するか、 アイドルなターンを開始します。フックのみの統合は、永続的なプルメッセージを残し、その制限を 結果に記載します。指定されたエージェントに到達可能なエンドポイントがない場合、配信は即座に 失敗します。Concord は静かにルートを変更しません。

concord adapters status は各ハーネスを個別に報告します。モニター/コントローラーの種類、 検証済みの到達可能性、必要なアクション、バージョンプローブの結果を含みます。 concord adapters install、doctor、uninstall は、リポジトリセットアップの外で同じ グローバルライフサイクルを提供します。

Concord はリポジトリのワークスペースを自動的に解決します。操作は workspace_id とリポジトリルートを 返すため、クライアントは誤ったルーティングの呼び出しを検出できます。1 つのサーバーが複数のルートを 調整している場合は、ID を明示的に渡すことができます。

ライフサイクルを変更する操作は、タスクの単調増加する version を expected_version として使用します。 2 つのエージェントが同じバージョンで動作した場合、最初の遷移のみが成功します。割り当ては、指定された エージェントが transfer_work を action: "accept" で使用するまで、作業を assigned 状態に保ちます。 引き継ぎの提案も同様に、受信者が受け入れるまで送信者に所有権を保持します。すべての所有権の変更は、 追記専用の監査履歴に保持されます。

提供されるもの

SQLite がローカルの信頼できる情報源であり、作業が行われている リポジトリのルート の .concord/ に 保持されます。MCP サーバーは、CONCORD_REPO_ROOT が設定されている場合はそこから、次に Claude Code の CLAUDE_PROJECT_DIR（Claude Code がユーザースコープのサーバーでも自動的に設定する）から、次に作業 ディレクトリからルートを解決します。これにより、1 つのリポジトリ内のすべてのエージェントが 1 つの ストアを共有します。作業ディレクトリがリポジトリ内にない場所でサーバーを実行する場合は、 CONCORD_REPO_ROOT を設定してください。

リンクされた Git ワークツリーは、Git の commondir メタデータに従ってプライマリチェックアウトを 参照するため、メインチェックアウトとすべてのリンクされたワークツリーは意図的に 1 つの Concord データベースとワークスペース ID を共有します。

明示的なワークスペース選択を制限するには、CONCORD_ALLOWED_ROOTS をパス区切りの許可された リポジトリルートのリストに設定します。許可リストがない場合でも、デコードされたルートは存在し、 ディレクトリである必要があります。

concord setup は .concord/ をリポジトリの .gitignore に追加するため、生成されたワークスペースは デフォルトでローカルに保たれます。PR で選択したアーティファクトを共有したいチームは、そのルールを 削除するか、人間が読めるファイルを強制的に追加できます:

.concord/
├── concord.db          local source of truth
├── HANDOFF.md          human-readable handoff
├── REVIEW_PACKET.md    review-ready evidence
└── WORK_STATE.json     generated export (optional)

CLI

Concord は型付きの MCP ツールと通常の CLI の両方をサポートします。MCP 対応エージェントは ツールを直接呼び出せます。人間と CLI 指向のエージェントは、concord コマンドを通じて同じ共有 ワークスペースで作業できます。

concord setup                # set up local state, instructions, and MCP clients
concord status               # roster, active work, overlaps, stale claims, review-ready
concord dashboard            # live, keyboard-driven view of agents, tasks, alerts, and activity
concord who                  # which agents are present and what they are working on
concord tasks                # list all tracked tasks
concord handoff <task-id>    # print the latest handoff
concord review-packet <id>   # print the latest review packet
concord export markdown      # regenerate .concord/ artifacts
concord doctor               # workspace checks + per-task tool adoption
concord adapters status      # global harness delivery capability matrix

concord --repo ../project status        # select by repository path from anywhere
concord --workspace ws_... status       # select an id returned by a Concord operation

--repo と --workspace はグローバルで相互に排他的なオプションです。CLI は MCP と同じ CONCORD_REPO_ROOT → CLAUDE_PROJECT_DIR → 作業ディレクトリの優先順位と、同じリンクされた ワークツリーの正規化を使用します。

concord dashboard は読み取り専用の全画面ローカル TUI です。共有 SQLite ワークスペースから毎秒 更新しながら、エージェント、タスク、アラート、コンテキスト、タイムラインを固定のターミナル ビューポート内に保持します。Tab でペインを切り替え、j/k または矢印キーで作業を選択し、 / でフィルタリングし、? でヘルプを表示し、q で終了します。

アップグレード

npm install -g @concord-ai/concord-mcp@latest
concord --version

Concord は毎日チェックし、CLI、MCP ツール、ダッシュボードで利用可能な更新を表示します。 concord setup は確認付きで更新をインストールでき、CONCORD_NO_UPDATE_CHECK=1 でチェックを 無効にできます。

これは何か / 何でないか

同じローカルチェックアウトを使用するコーディングエージェントのための共有ワークステートと タスクメモリです。オーケストレーター、コードレビュアー、ホスト型同期サービス、メモリベクトル DB、 自律コーディングエージェントではありません。

関連情報: なぜ単にマークダウンを使わないのか？

コントリビューション

CONTRIBUTING.md と CLAUDE.md を参照してください。この リポジトリは厳密に型付けされ（any なし、型キャストなし）、モジュール化されています。 初心者向けの良い課題は good first issue ラベルで示されています。

スター履歴

プライバシーとテレメトリー

Concord は、製品および調整のテレメトリを getconcord.ai に送信します。これには、ランダムなインストール/呼び出し識別子、インストールごとの不可逆的なワークスペースおよびタスクフローの仮名、Concord/Node/プラットフォームのバージョン、正規化されたクライアントメタデータ、操作名、結果、および所要時間、集計された重複/編集ガードの結果、メッセージ配信の段階と遅延、タスクのライフサイクル遷移と経過時間、そして明示的に報告された受入、統合、人的介入、および手直しの結果が含まれます。

Concord は、コード、生のファイルまたはリポジトリのパス、リモート、ユーザー名、生のタスクまたはエージェントの識別子、メッセージの識別子または内容、コマンド引数、ツールの入力/出力、またはタスクの内容を決して送信しません。受信サーバーはリクエストの IP アドレスを保存し、国コードを導出/保存します。これらのサーバー側フィールドには現在、自動的な有効期限がありません。CONCORD_TELEMETRY_DISABLED=1（または DO_NOT_TRACK=1）を設定すると、テレメトリを無効にできます。配信はベストエフォートであり、Concord の操作を失敗させることは決してありません。

ライセンス

MIT