CorroborateMe

CorroborateMe

エンドユーザーが誰なのかを、エージェントやアプリに証明します。

CorroborateMe は、複数チャネルの通知機能を備え、エージェントやアプリに企業の API キーと人間のログインリンクを提供します。これにより、エンドユーザーが誰であるかを証明できます。さらに、OIDC クライアント登録、インテグレーションシークレット、予算を考慮した課金にも対応します。REST を第一級でサポートし、MCP はオプションです。

ライブエンドポイント： https://corroborateme.com/mcp

このリポジトリは、ディレクトリクローラー向けの公開カタログとスキーマのスタブです。ホストされたサーバーではありません。MCP クライアントは、CorroborateMe API キー（aa_...）または MCP OAuth（PRM は /.well-known/oauth-protected-resource）を使って、上記のライブ URL に接続してください。新しい OAuth クライアントをバインドするには、最初に aa_... キー（またはコンソールメンバーのセッション）が必要です。このリポジトリ内の TypeScript を実行しても、ユーザーの認証やシークレットの保存は行われません。

エージェントガイド： 検出 URL、認証、MCP の接続例については、AGENTS.md を参照してください。

API キーを取得する

人間を介さない方法（エージェント）

1. POST https://corroborateme.com/api/agents/bootstrap に、任意の { "company_name": "...", "contact_email": "[email protected]" } を指定して送信します -> ブートストラップトークンが返されます（メール送信はありません）。
2. Authorization: Bearer <bootstrapToken> と、任意の { "sku": "pro_prepaid_30d" } を指定して、POST https://corroborateme.com/api/billing/machine-pay を送信します。
3. Stripe MPP が有効な場合は決済を完了します（料金はライブの GET /api/config を参照）。ロック解除に成功すると、レスポンスに secret（aa_...）が含まれます。

llms.txt と llms-full.txt を参照してください。法的情報：利用規約 · プライバシー。

人間による方法

1. corroborateme.com を開き、アカウントを作成します。
2. 料金プランでサブスクリプションに登録し、コンソールで API キーを発行します。シークレットは aa_ で始まります。
3. 企業キーを REST と MCP に使用します。

実際のキーをコミットしないでください。設定では aa_... プレースホルダーを使用してください。

クライアントを接続する

トランスポートはストリーミング可能な HTTPです。次のいずれかで認証します。

• Authorization: Bearer aa_...（コンソールまたはブートストラップ＋machine-pay で取得した API キー）、または
• MCP OAuth - まず aa_... キー（ブートストラップ＋machine-pay、またはコンソールで取得）を用意します。ホストは /.well-known/oauth-protected-resource から PRM を検出し、DCR で登録した後、ブラウザーでの同意の前に Authorization: Bearer aa_...（キーに紐付けられた企業）または company_id を指定したコンソールメンバーのセッションを使って、POST /api/oidc/start でクライアントをバインドします。company_id のみを指定した場合は拒否されます（401）。

Cursor

Cursor Marketplace（プラグイン）からインストール

このリポジトリには、Cursor MarketplaceからワンクリックでインストールするためのCursor プラグインマニフェストとルートのmcp.jsonが含まれています。

1. MarketplaceからCorroborateMeプラグインをインストールします（または、このリポジトリをクローンしてローカルでプラグインをテストします）。
2. Cursor Settings -> Customize -> CorroborateMeを開き、CorroborateMe API key（ブートストラップとmachine-pay、またはコンソールから取得したaa_...）を設定します。
3. ウィンドウを再読み込みします。MCP ツールがCorroborateMeサーバーの下に表示されます。

このプラグインは、Authorization: Bearer ${CORROBORATE_ME_API_KEY}を使用してhttps://corroborateme.com/mcpに接続します。実際のキーをコミットしないでください。

準備ができたら、公開リポジトリをcursor.com/marketplace/publishに提出してください。

MCP の手動設定

ユーザーまたはプロジェクトの MCP 設定：

{
  "mcpServers": {
    "corroborate-me": {
      "url": "https://corroborateme.com/mcp",
      "headers": {
        "Authorization": "Bearer aa_..."
      }
    }
  }
}

Claude Desktop / Claude Code

{
  "mcpServers": {
    "corroborate-me": {
      "command": "npx",
      "args": ["mcp-remote", "https://corroborateme.com/mcp", "--header", "Authorization: Bearer aa_..."]
    }
  }
}

汎用リモート MCP

{
  "url": "https://corroborateme.com/mcp",
  "headers": {
    "Authorization": "Bearer aa_..."
  }
}

製品ホスト上の検出マニフェスト：

• /.well-known/mcp.json
• /.well-known/oauth-protected-resource（MCP OAuth）
• /llms.txt
• /openapi.json

ツール

src/server.ts内のスキーマは、ホストされているサーバーと一致します。

ツール	機能
agent_bootstrap	人手を介さない会社のオンボーディングを開始します（メール OTP の後、ブートストラップトークンを発行）
budget_get	認証済みの会社に残っているクォータ
billing_checkout	人間向け Pro の Stripe Checkout URL を作成します
billing_machine_pay	Stripe MPP によるエージェント向け前払いアンロック（skuは省略可能）
billing_portal	Stripe Customer Portal の URL
keys_create	新しいaa_ API キーを発行します（一度だけ表示）
oauth_client_create	OIDC リライングパーティークライアントを登録します（RP ログアウトが有効、ログアウト後 URI は省略可能）
oauth_client_revoke	OIDC リライングパーティークライアントをソフト失効します（認可とトークン更新を停止）
integration_upsert	暗号化されたインテグレーションシークレットを保存します（Google／Apple など）
integration_list	インテグレーションの一覧を取得します（プレフィックスのみ、シークレットは含まれません）
create_login_link	通知方法を指定して、人間向けのワンタイムログイン URL を発行します
get_login_status	ログインリンクのセッション状態をポーリングします
retry_login_webhook	通知に失敗した後、署名付き Webhook の配信を再試行します
webhook_allowlist_add	コールバック URL のプレフィックスを許可リストに追加します

エージェントの一般的なループ

1. メール OTP（agent_bootstrapまたは REST /api/agents/bootstrap）でブートストラップし、必要に応じて前払い Pro（billing_machine_pay）をアンロックします。
2. 永続的なaa_...シークレットが必要な場合は、keys_createでキーを発行します。
3. コールバックのプレフィックスを許可リスト（webhook_allowlist_add）に追加してから、人間による証明のためにcreate_login_linkを実行します。
4. get_login_statusでポーリングするか、Webhook／リダイレクト／postMessageを待ちます。
5. 必要に応じて、キー、OIDC クライアント、インテグレーションには REST または MCP を使用します。

変更される可能性のある手順については、最新のドキュメントとllms-full.txtを参照してください。

認証とエラー

• 401 - Authorization がない、または無効です（API キーaa_...または MCP OAuth アクセストークン）
• 402 / 429 - プランまたはクォータに関するエラーです。最新 API の機械可読アクションに従ってください
• 価格：最新のGET /api/configを読み取ってください。金額を永続的な値としてハードコードしないでください（執筆時点：Pro は月額 $5.99、エージェント向け前払い Pro は30日あたり $5.99）

製品ドキュメント

• アプリ：corroborateme.com
• ドキュメント：corroborateme.com/docs
• OpenAPI：corroborateme.com/openapi.json
• Swagger：corroborateme.com/swagger

CorroborateMe製品（Worker、課金、IdP）はクローズドソースです。このカタログは、ディレクトリでツールやインストール用スニペットを掲載できるよう、MITライセンスで公開されています。

ディレクトリへの登録

レジストリ名：com.corroborateme/corroborate-me（corroborateme.com の DNS 認証によるドメイン名前空間）。以前のバージョンは com.cnrcode/corroborateme として公開されていました。

レジストリのリモート URL は https://corroborateme.com/mcp/ です。Worker はこのパスを https://corroborateme.com/mcp と同じ MCP エンドポイントとして提供します（リダイレクトなし）。このリポジトリのクライアントのインストール用スニペットでは、末尾にスラッシュのない URL を使用しています。server.json では末尾にスラッシュのない URL を使用できません。非推奨の com.cnrcode/corroborateme がその URL を引き続き使用しており、レジストリのエントリは削除できないためです。

1. v=MCPv1; k=ed25519; p=<public key> の TXT レコードが corroborateme.com のルートドメインに設定されていることを確認します。

2. GitHub リポジトリのシークレット MCP_REGISTRY_KEY_CORROBORATEME を設定します（Ed25519 の秘密鍵の 16 進数表記。コミットしたり、ファイルに書き込んだりしないでください）。

3. バージョンタグをプッシュすると、GitHub Actions が 公式 MCP Registry に server.json を公開します。

   git tag v0.2.1
   git push origin v0.2.1
   

公式レジストリを取り込むディレクトリ（PulseMCP、MCPCentral、MCPFind、Glama connectors）は、そこからエントリを取得します。その他のディレクトリ（Glama server listing、Smithery、mcpservers.org、mcp.directory、MCP Market、McpMux）への登録は、メンテナーのみが申請できます。docs/directory-listings.md を参照してください。

Stdio スタブ（ディレクトリによるイントロスペクション）

このリポジトリには、ディレクトリがコンテナをビルドしてプロセスを起動し、13 個のツール定義をイントロスペクションできるように、stdio カタログスタブ（src/main.ts）が含まれています。認証や課金には対応していません。クライアントは引き続き上記のホストされたエンドポイントに接続します。

ローカルでの検証：

npm ci && npm run build && npm start   # hangs on stdio - expected
docker build -t corroborate-me-stub . && docker run -i corroborate-me-stub

ライセンス

MIT - カタログ、ドキュメント、スキーマスタブのみ。