> ## Documentation Index
> Fetch the complete documentation index at: https://adcp-docs-ja.pier1.co.jp/llms.txt
> Use this file to discover all available pages before exploring further.

# エージェントの登録

> エージェントが AAO レジストリにどう現れるか — 単一の登録パスと AAO メンバーシップがアンロックするもの。

AdCP レジストリカタログ（`/api/registry/agents`、`/api/registry/publishers`）は、AAO 証明のメンバー登録エージェントのみを含みます。カタログに現れるには、AAO メンバーがメンバープロフィールでエージェントを明示的に登録しなければなりません。

## エージェントがレジストリに入る方法

1 つのパスがあります: **AAO メンバーがダッシュボードまたは `PUT /api/me/member-profile` 経由でエージェントをメンバープロフィールに追加**。ダッシュボード経由でエンドツーエンド: 5 分未満。

1. **サインインまたはサインアップ。** [agenticadvertising.org/auth/login](https://agenticadvertising.org/auth/login) に行きます。初めて? **Sign up** でアカウントを作成し、次に AAO 組織招待を受諾（またはあなたの組織がまだ AAO にない場合 [メンバーシップを開始](https://agenticadvertising.org/membership)）。
2. **エージェントダッシュボードを開く。** サインインしたら、[agenticadvertising.org/dashboard/agents](https://agenticadvertising.org/dashboard/agents) に行きます。URL は組織コンテキストを自動解決します。
3. **ページ右上の `+ Register agent` をクリック。**（エージェントのないまったく新しい組織では、空状態 CTA は **Register your first agent** と読み、同じフローをトリガーします。）
4. **Addie と話す。** ボタンは、プロンプト *"Help me register my agent."* で事前ロードされた Addie とのチャットに入れます。Addie は以下を案内します:
   * **エージェント URL** — 例: `https://agent.yourcompany.com/mcp`
   * **表示名**（オプション）
   * **認証方法** — 1 つを選ぶ: None · Static bearer · Static basic · OAuth client credentials。*（インタラクティブ OAuth ユーザー認可は別途構成 — ここでは **None** で登録し、次にエージェントカードの **Authorize** をクリックしてサインイン。）*
   * **認証フィールド** — 選んだ方法が必要とするもののみ（bearer トークン、または client credentials の `token_endpoint` + `client_id` + `client_secret` など）
   * **プロトコル** — MCP にデフォルト。URL が曖昧な場合のみ Addie が尋ねる
5. **完了。** Addie が `save_agent` を呼び、あなたのエージェントは `visibility: "members_only"`（他の有料 AAO メンバー — Professional、Builder、Member、Leader に可視。公開リストされない）でレジストリカタログに着地します。
6. **オプション — 公開に。** `/dashboard/agents` に戻り、エージェントの可視性を **Members only** から **Public** に変更します。公開可視性は有料 AAO 階層（Professional、Builder、Member、Leader）と、エージェントが `brand.json` に追加できるようメンバープロフィールのプライマリブランドドメインを要求します。

**タイプはサーバー側で解決されます。** エージェントのタイプを尋ねられません — タイプ（`brand`、`sales`、`buying`、`measurement`、`creative`、`signals` など）はエージェントのケイパビリティスナップショットから解決されます。`resolveAgentTypes()` はクローラーから最新のスナップショットを読みます。スナップショットがまだ存在しない場合、保存されるタイプフィールドはクライアントが供給したもので、次のクローラープローブがそれを上書きします。どちらの方法でも、誤ったタイプを永久にピン留めできません。

**このパスが証明するもの:** メンバーが AAO 条件に署名した。URL、名前、連絡先が明示的に宣言された。タイプがプローブ検証された。可視性は `public`、`members_only`、`private` になりえます — 下の [Visibility](#visibility) を参照。

クロールされた `adagents.json` ファイルからの自動投入はありません。サードパーティ `adagents.json` ファイルにリストされたエージェントは、Operator ルックアップエンドポイント（`GET /api/registry/operator?domain=X`）、`/api/registry/lookup/domain`、`hasValidAdagents` が使うパブリッシャー認可グラフを投入しますが、カタログエントリーを作成しません。

## プログラマティック登録（CI、スクリプト、エージェント用）

CI、デプロイフック、または自身のエージェントから — ダッシュボードや Addie なしで — エージェントを登録するには、`/api/me/agents` 下のエージェントごとの REST エンドポイントを使います。それらはダッシュボードパスと同じ可視性ゲート、サーバー側タイプ解決、監査ログを共有するので、`members_only` デフォルト、`public` の `tier_required` チェック、タイプスマグル保護がすべて同一に適用されます。

WorkOS API キー（`Authorization: Bearer sk_…`）または OAuth ユーザー JWT で認証します。[agenticadvertising.org/dashboard/api-keys](https://agenticadvertising.org/dashboard/api-keys) で API キーを作成します。

| Endpoint                      | Purpose        |
| ----------------------------- | -------------- |
| `GET /api/me/agents`          | 登録したエージェントをリスト |
| `POST /api/me/agents`         | エージェントを登録      |
| `PATCH /api/me/agents/{url}`  | エージェントを更新      |
| `DELETE /api/me/agents/{url}` | エージェントを削除      |

PATCH と DELETE のパスパラメーターはエージェントの `url`、URL エンコード（例: `https%3A%2F%2Fagent.example.com%2Fmcp`）。`POST` は `url` で冪等: 新しいエントリーは `201` を返す。同じ `url` の再ポストは既存エントリーを更新し `200` を返す。各成功した書き込みは `{ agent, warnings? }` を返す — `warnings` は任意の階層駆動の可視性ダウングレードをリスト（例: `public` を求める Explorer 階層呼び出し元は `visibility_downgraded` 警告で `members_only` として保存）。

### 前提条件

* あなたの組織の AAO メンバープロフィールが既に存在しなければならない。まずダッシュボードまたは `POST /api/me/member-profile` 経由で作成。それまでエージェントエンドポイントは `404` を返す。
* `visibility: "public"` には、組織は有料 AAO 階層（Professional、Builder、Member、Leader）と、エージェントが `brand.json` に追加できるようプロフィールに設定された `primary_brand_domain` を必要とする。下の [Visibility](#visibility) を参照。

## AAO メンバーでない場合これが何を意味するか

今日セルフ登録できません。あなたのオペレーターは、レジストリカタログにあなたのエージェントを登録するため AAO メンバーでなければなりません。

クロール発見リスティング（誰かの `adagents.json` で参照されるあなたのエージェント）はプロパティ認可チェックに使われる認可グラフを投入しますがカタログエントリーを作成しません — `/api/registry/agents` はメンバー専用です。

登録パスにアクセスするには [メンバーになる](https://agenticadvertising.org/membership)。

## Visibility

メンバー登録エージェントは 3 つの可視性レベルの 1 つを持ちます:

| Visibility     | Who sees it                                                               |
| -------------- | ------------------------------------------------------------------------- |
| `public`       | 誰でも — `/api/registry/agents` と `/api/registry/operator?domain=X` への匿名呼び出し |
| `members_only` | `/api/registry/operator?domain=X` の AAO API 階層メンバー                        |
| `private`      | プロフィールオーナーのみ                                                              |

`/api/registry/operator?domain=X` エンドポイントは認証対応: 匿名呼び出し元は `public` エージェントのみを見る。認証された AAO API 階層呼び出し元は `members_only` エージェントを見る。プロフィールオーナーは加えて `private` エージェントを見る。

## メンバーシップの利益

| Capability                     | Description                             |
| ------------------------------ | --------------------------------------- |
| カタログ可視性                        | あなたのエージェントが `/api/registry/agents` に現れる |
| タイプ、名前、連絡先を自己証明                | エージェントのアイデンティティを宣言し編集                   |
| 自身のリスティングを編集                   | プロフィールオーナーがすべてのフィールドを制御                 |
| `members_only` と `private` 可視性 | `public` を超えてエージェント可視性をスコープ             |
| AAO Verified バッジ               | ストーリーボード通過後に適格                          |
| ストーリーボードテストアクセス                | あなたのエージェントに対してプロトコル適合性テストを実行            |
| コンプライアンスレポート                   | あなたのエージェントのプロトコル使用に対するレポート              |
| 消費者へのトラストシグナル                  | 「AAO メンバー。条件署名。証明済み」                    |

登録パスにアクセスするには [メンバーになる](https://agenticadvertising.org/membership)。

## あなたのエージェントがどう現れるか検証

レジストリを直接クエリ:

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://agenticadvertising.org/api/registry/agents" \
    | jq '.agents[] | select(.url == "https://your-agent-url.example/mcp")'
  ```

  ```javascript JavaScript theme={null}
  const res = await fetch("https://agenticadvertising.org/api/registry/agents");
  const { agents } = await res.json();
  const yours = agents.find((a) => a.url === "https://your-agent-url.example/mcp");
  console.log(yours);
  ```
</CodeGroup>

あなたのエージェントの URL がレスポンスにある場合、それは登録済みで `member` がリスティングを所有する AAO 組織を識別します。レスポンスにない場合、どの AAO メンバーもそれを登録していません — オペレーターにメンバープロフィール経由で登録するよう頼むか、[メンバーになって](https://agenticadvertising.org/membership) セルフ登録します。

あなたのエージェントがパブリッシャーの `adagents.json` で参照されているか（カタログ登録とは別の認可目的）をチェックするには、パブリッシャーのドメインに対して `/api/registry/lookup/domain/{domain}` を呼びます。

## 関連

* [レジストリ概要](/docs/registry) — エンドポイントカタログ、ルックアップフロー、ブランド解決。
* `GET /api/registry/operator?domain=X` — エージェントと認可の認証対応エンティティごとビュー。
* `GET /api/registry/agents` — 完全なレジストリカタログ。
* `POST /api/registry/crawl-request` - 認可グラフのパブリッシャーの `adagents.json` マッピングをリフレッシュ。