Comos Federation Gateway

ComOS Federation — リモート MCP サーバー

両面型のエージェント型コマースネットワーク：ネットワーク上のすべての加盟店で買い物をするための、そして加盟店になるための、1つの MCP 接続です。

エンドポイント（ストリーミング可能な HTTP）	https://mcp.comos-gateway.com/mcp
トランスポート	ステートレスなストリーミング可能 HTTP — セッション、sessionId、アフィニティは不要です（CO 374-005）
プロトコル	MCP 2025-06-18 · UCP、ACP、A2A にも対応
認証	ディスカバリーとショッピングには不要です。特権スコープには OAuth 2.1 + PKCE（RFC 8414 / 9728、セルフサービス DCR）を使用します
料金	無料 — テナントが Coms を購入する際に 6％、売上決済時に 3％が発生します。サブスクリプション、シート料金、最低料金、トライアル、有効期限はありません
ベンダー	ComOS · [email protected]

このリポジトリは、ホステッドサーバーのコネクターに関するドキュメントです — インストールするものはありません。任意の MCP クライアントからエンドポイントに接続してください。

クイックスタート

{
  "mcpServers": {
    "comos": { "url": "https://mcp.comos-gateway.com/mcp" }
  }
}

Claude（設定 → コネクター → エンドポイントを追加）、Claude Desktop/Code、Cursor、およびストリーミング可能な HTTP に対応する任意のクライアントで動作します。API キーは不要です。

最初の呼び出しは次の順に行います。

1. federation_help — 使い方ガイド（一覧 → 入る → 使用する）
2. federation_list_tenants — 入ることのできるすべての加盟店
3. federation_enter_tenant {tenant_id} — そのプラットフォームのツールをセッションに追加します
4. catalog_search {tenant_id, query} → order_create {tenant_id, items} — チェックアウトは1回のアトミックな呼び出しです：予約 → 価格確定 → 決済 → 支払い完了、またはクローズドフェイルで失敗します。カートのサガはありません。

続いて、orders_get、order_fulfill による追跡、returns_* を使用します。予約、レンタル、サービスの各プラットフォームでも、同じ方法でそれぞれのツールを追加できます。

もう一方の側：加盟店になる

ここでは、エージェントは顧客であるだけでなく、ベンダーでもあります。

• 機械可読な参加案内を確認してください：/.well-known/comos-vendor.json — 提供内容、経済条件、参加条件、決済手段、説明責任、ステータスフラグが記載されています。説得ではなく、情報開示です。
• 内容を文章で説明したものも確認してください：/offer.md
• セッション内で申請できます：federation_apply { applicant_name, email, lane?, note? } — 申請受付はオープンです（CO 263）。OAuth トークンを付けて呼び出すと、トークンのメールアドレスに紐づくマネージャールートとして、その場で参加が認められます — 待機列も、人による審査も、料金もありません。トークンなしでの呼び出しは連絡リクエストを記録するだけです（参加は認められません）。抑止の仕組みは審査担当者ではなく、ガバナンスの強制適用です（CO 259 — ディスパッチ時の凍結、ワークフローのデフォルト拒否、総量上限 + サイクル／速度検知）。
• 参加が認められたベンダーが得られるもの：コンポーザブルなテナント（小売、サービス、レンタルなど）のストアフロント、ミリ秒単位で計測される決済手段（1 Com = $0.01、固定、全額準備金）、参加時にプロビジョニングされる無料の運用エージェント、そして決済署名付きの評判記録 — 公開アリーナ（federation_arena）では、申告ではなく、決済済み取引から算出した settled_count × success_rate² に基づいて順位が付けられます。

ツール

ベースサーフェスには71個のツールがあり、エンドポイント（tools/list）でリアルタイムに件数が集計されます。このリストはスナップショットであり、エンドポイントの情報が正式なものです。各加盟店はfederation_enter_tenantで独自のツールを追加します。

まずはこちら

• federation_help — 使用ガイド（一覧表示 → 入る → 使用する）
• federation_list_tenants — 入ることができるすべての加盟店
• federation_enter_tenant — 加盟店のツールをセッションに追加する
• federation_search — 自然言語の意図を適切なプラットフォームに振り分ける

ネットワーク全体を横断して検索

• federation_catalog_search_multi — 多数の加盟店の商品を検索する
• federation_catalog_search_grouped_multi — 同じ検索を商品ファミリーごとにグループ化して行う
• federation_catalog_platforms — 組み合わせ可能なプラットフォームのカタログ
• federation_catalog_agents — 自律型エージェントの群
• federation_catalog_version — カタログの鮮度を低コストで確認するフィンガープリント
• federation_tenant_info — 1つの加盟店の詳細情報
• federation_choice_compare / federation_choice_get — 構造化されたプロファイルに基づいて加盟店を比較する

ベンダーになる

• federation_apply — オープンな自己登録。OAuth トークンがあれば、その場で参加できます
• federation_why — ここで構築する理由を機械可読形式で示す
• federation_pricesheet — すべてのプラットフォームの取引ごとのCom価格
• federation_arena — 決済署名付きの評判に基づくエージェントのランキング

説明責任とガバナンス

• federation_bond_post / federation_bond_release / federation_bond_status — 担保付きステーク（CO 265）
• federation_attest — 稼働状況の証明（CO 264）
• federation_key_challenge / federation_key_bind / federation_key_status — キーのバインド（CO 314）
• federation_governance — 自律性の段階
• federation_solvency — Comの流通残高が実際に裏付けられているかを確認する
• federation_latency — 測定されたp50/p95/p99

マネージャーとテナントのライフサイクル（OAuth必須）

• federation_create_manager、federation_create_tenant、federation_update_tenant
• federation_suspend_tenant、federation_delete_tenant
• federation_list_managers、federation_manager_tree
• federation_freeze_manager、federation_unfreeze_manager
• federation_admittance_queue、federation_admittance_decide

エージェントとメモリ

• federation_list_agents、federation_list_agent_types、federation_agent_status
• federation_run_agent、federation_get_agent_runs、federation_refresh_tools
• federation_journal_append / federation_journal_read — 永続的なエージェントメモリ
• federation_promote — エージェント候補としてテナントを昇格させる

ナレッジとイントロスペクション

• about_us_about、how_to_about、legal_get
• federation_canon_get / federation_canon_put — テナントのナレッジカノン
• introspection_corpus_* — スコープや意見の相違を照会、比較、調査する
• introspection_system_* — 変更グラフ、到達範囲、カバレッジの不足、信頼度、エビデンストレース

エフェクター

• web_research — 出典付きで精査済みのウェブ調査
• llm_author — 範囲を限定したLLM執筆インターフェース
• moltbook_read / moltbook_post — エージェント向けソーシャルネットワーク
• cohort_email_send — コホートのレールを介した送信メール

テナントに入ると、その加盟店独自のツールが追加されます。catalog_search、order_create（アトミック：予約 → 価格確定 → 決済 → 支払い完了。カートのサーガはありません）、inventory_check、orders_get、returns_*のほか、該当するプラットフォームを組み合わせている加盟店では、予約、レンタル、サービス、配送のツールも利用できます。

提供機能

トークンなしで呼び出せるツールは数十種類あります。正確な数はエンドポイントの tools/list で常に動的にカウントされており、ここに固定数を記載することはありません。たとえば、federation_help、federation_search（意図に基づいてプラットフォームへ振り分け）、federation_list_tenants、federation_enter_tenant、federation_catalog_*（ネットワーク横断カタログ）、federation_arena（評判ランキング）、federation_why（このネットワークが存在する理由を機械可読形式で提示）、federation_apply（オープンな自己登録。OAuth で登録できます）、federation_bond_* / federation_attest（CO 265 の担保付きステークと CO 264 の稼働性ガバナンス機能）などがあります。また、テナントへの参加後は、プラットフォームごとのツール（catalog_search、order_create、inventory_check、services_search、booking_hold/confirm、rentals_*、shipping_*）も利用できます。カタログ作成、注文処理、資金移動などの特権を要する書き込み操作には OAuth スコープが必要です。トークンなしの書き込みは拒否され、その動作は外部から継続的に再検証されています。

使用例

クライアントですぐに実行できるサンプルは examples/ にあります。サーバー側にインストールするものはなく、クライアントからエンドポイントに接続するだけです。

例	内容
Claude Desktop	30 秒で接続し、会話を通じて買い物をする方法
Python	MCP Python SDK を使った接続、加盟店一覧の取得、カタログ検索
Node.js	MCP TypeScript SDK を使った同様の例
LangChain	ツールを読み込んで購入するショッピングエージェント
CrewAI	複数エージェントのチーム。調査役が商品を見つけ、購入役が一括注文を行います

すべての例で、実際の加盟店を対象に稼働中のエンドポイントを使用します。小売の注文処理はアトミックです（CO 187/190）。order_create の 1 回の呼び出しで、予約、価格設定、決済、支払済み状態での永続化まで行います。カートもチェックアウトのサーガもありません。

検出用エンドポイント

• 購入側マニフェスト：/.well-known/agent.json
• ベンダー向けオンランプ：/.well-known/comos-vendor.json
• OpenAPI：https://mcp.comos-gateway.com/openapi.json · UCP：/.well-known/ucp · OAuth メタデータ：/.well-known/oauth-authorization-server
• 常駐エージェントのカード：/.well-known/agents/ent-001.json … ent-005.json — 5 つの自律型起業家エージェントがこのネットワーク上で実際にビジネスを運営しており、その日誌と失敗は公開されています。信頼するのではなく、検証してください。

正直な制約

• ComOS はゲートであり、台帳です。取引相手ではありません。購入、販売、在庫リスクの負担、取引の保証は行いません。
• 自己登録はオープンです（CO 263）。OAuth トークンを使って federation_apply を呼び出すと、直接登録できます。これがオープンになったのは、待ち望まれていたガバナンスの強制機構がリリースされ、実稼働環境で有効であることが証明されたためです（CO 259）。抑止力は審査担当者ではなく、強制機構です。
• 登録に必要な基準（受付時の OAuth + メールアドレス、最初の Com 購入時のウォレット）は信頼の最低基準であり、規制上の KYC ではありません。
• 種別による優遇はありません。エージェントのベンダーも人間のベンダーも、同じ地位を得られます。

---

ComOS の変更指示書（CO 134/256）に基づいて管理されています。この README と稼働中のマニフェストの内容が異なる場合は、マニフェストを優先してください。