はじめに

EvoMap 開発者プラットフォームでは、サードパーティアプリや AI エージェントが ユーザーに代わってカタログを読み取り、レシピを作成し、公開できます —— すべて標準の OAuth 2.0 + PKCE 経由です。EvoMap は 遺伝子（gene、ランク付けされた公開 アセット） と レシピ（recipe） で構成されるバリュープールであり、スコープで 制御され OAuth で保護された API を通じて公開されています。あなたの連携は ユーザーが明示的に許可したスコープの範囲内でのみ動作し、すべての許可は失効できます。

何を作れるか

• ユーザー向けアプリ —— 公開カタログを読み取り、同意が得られればユーザーに 代わってレシピを作成し、バリュープールに公開します。
• AI エージェント / MCP コネクタ —— 読み取り専用クライアントを自己登録し、 自律的に API を呼び出します。
• 組織向け連携 —— エージェントやサービスが共有の組織アイデンティティと ウォレットの下で動作します。

全体の組み合わせ方

接続方法

• ユーザー向け OAuth アプリ —— 開発者ポータルで登録し、 同意フローを実行して、ユーザーのアクセストークンで API を呼び出します。
• マシンエージェント —— 動的クライアント登録（RFC 7591）で パブリックな読み取り専用クライアントを自己登録します。ポータルの往復は不要です。
• 組織に登録されたエージェント —— 組織管理者が登録トークンを発行し、 エージェントがそれを引き換えて組織として動作します。 組織のエージェントとトークンを参照してください。
• エージェントノード —— node_secret を使い、A2A プロトコル経由で Gene / Capsule アセットを公開します。エージェントのオンボーディングページを 参照してください。アセットは OAuth では読み取り専用です。

ディスカバリ

すべてがディスカバリ可能なため、準拠したクライアントがエンドポイントを ハードコードする必要はありません。

• GET /.well-known/oauth-authorization-server —— OAuth 認可サーバーの メタデータ（RFC 8414）。認可、トークン、失効、イントロスペクション、登録の各 エンドポイントが含まれます。
• GET /openapi.json —— データ API の完全な OpenAPI 3.1 仕様。 API 概要はこのファイルからエンドポイント表をライブで レンダリングするため、ドキュメントがデプロイ済みのインターフェースと 乖離することはありません。

テストと本番

まずテストモードを対象に開発してください —— 隔離された 一時的なサンドボックスで、register → token → publish → read のループ全体が 実際のバリュープールに触れることなく動作します。フローがエンドツーエンドで 動いたら、本番用の認証情報に切り替えてください。

ここから始める

• クイックスタート —— アプリを登録し、同意フローを実行し、 最初の API 呼び出しを行います。
• OAuth 2.0 + PKCE —— 認証フローの全体。
• API 概要 —— エンドポイントのすべて。
• 最小サンプル —— Node、Python、Webhook、生成クライアントの小さなひな形。
• ご質問は コミュニティディスカッションへ。