​

Addie を AI クライアントに接続する

​

認証の概要

• OAuth 2.1 ユーザー JWT — 人間駆動クライアント（Claude Desktop、Claude Code、ChatGPT、Cursor）用。AAO メールでサインイン。クライアントが OAuth フローを処理します。
• WorkOS 組織 API キー — サーバー間呼び出し元用。agenticadvertising.org/dashboard/api-keys で生成。Authorization: Bearer <key> として送信し OAuth を完全にスキップ。

​

Claude Desktop

1. Claude Desktop → Settings → Connectors を開く。
2. Add custom connector（または Connect → custom）をクリック。
3. ダイアログで Name = Addie、Remote MCP server URL = https://agenticadvertising.org/mcp を設定し、Add をクリック。
4. ブラウザが開いたら AAO メールでサインイン。
5. Claude Desktop が Addie を接続済みとして表示。ツールはチャットツールピッカーに現れます。

​

ChatGPT

1. ChatGPT → Settings → Connectors → Advanced → Developer mode を有効化。
2. Create（または Add MCP server）をクリックし、タイプ MCP を選択。
3. URL: https://agenticadvertising.org/mcp、Authentication: OAuth。
4. ブラウザでサインインを完了。

​

Claude Code

​

推奨: mcp-remote 経由の stdio シム

claude mcp add addie -- npx -y mcp-remote@latest https://agenticadvertising.org/mcp

​

代替: ネイティブ HTTP トランスポート

claude mcp add --transport http addie https://agenticadvertising.org/mcp

​

OAuth の代わりに API キーを使う

claude mcp add --transport http addie https://agenticadvertising.org/mcp \
  --header "Authorization: Bearer sk_your_key_here"

{
  "mcpServers": {
    "addie": {
      "type": "http",
      "url": "https://agenticadvertising.org/mcp",
      "headers": {
        "Authorization": "Bearer sk_your_key_here"
      }
    }
  }
}

​

その他の MCP クライアント

{
  "type": "http",
  "url": "https://agenticadvertising.org/mcp"
}

​

トラブルシューティング

​

”Authentication successful, but server reconnection failed”

​

OAuth 完了後に 401 が返る

• トークンが新しいことを確認。WorkOS アクセストークンは短命です。リフレッシュトークンはより長く続きます。ほとんどのクライアントは自動リフレッシュします。一部はしません。再認証を強制してください。
• 認証情報を二重送信していないことを確認。設定に Authorization ヘッダー と OAuth フローの両方がある場合、一方が他方と衝突します。
• トークンを手動でテスト:
  curl -i -X POST https://agenticadvertising.org/mcp \
    -H "Authorization: Bearer <token>" \
    -H "Content-Type: application/json" \
    -H "Accept: application/json, text/event-stream" \
    -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"diag","version":"0.0.1"}}}'
  
  ここでの 401 はトークンがサーバーで拒否されたことを意味します。200 はクライアントが認証を誤処理していることを意味します。

​

再認証を強制する

• Claude Code: rm ~/.claude/.credentials.json してから /mcp を実行。（これは すべての MCP サーバーの OAuth 状態をクリアします。複数ある場合はまずバックアップしてください。）
• Claude Desktop: Addie コネクターを削除して再追加。
• ChatGPT: 設定でコネクターを切断して再追加。

​

“~/.claude/settings.json に Addie を設定したがロードされない”

​

Claude Code ログの場所

​

Reference URLs

• MCP エンドポイント: https://agenticadvertising.org/mcp
• Authorization server メタデータ（RFC 8414）: https://agenticadvertising.org/.well-known/oauth-authorization-server
• Protected resource メタデータ（RFC 9728）: https://agenticadvertising.org/.well-known/oauth-protected-resource/mcp
• 動的クライアント登録（RFC 7591）: POST /register
• API キーダッシュボード: agenticadvertising.org/dashboard/api-keys
• Issue トラッカー: github.com/adcontextprotocol/adcp/issues