Skip to main content
公開テストエージェントを使って、5 分で AdCP を始めましょう。

インタラクティブなテスト

コードを書かずに AdCP を試す: testing.adcontextprotocol.org

コード例

クライアントライブラリをインストール:
npm install @adcp/client  # JavaScript/TypeScript
pip install adcp          # Python
テストエージェントから商品を取得:
import { testAgent } from '@adcp/client/testing';

const result = await testAgent.getProducts({
  brief: 'Premium athletic footwear with innovative cushioning',
  brand_manifest: {
    name: 'Nike',
    url: 'https://nike.com'
  }
});

if (result.success && result.data) {
  console.log(`✓ Found ${result.data.products.length} matching products`);
} else if (result.error) {
  console.log(`Error: ${result.error}`);
} else {
  console.log(`Status: ${result.status}`);
}

次のステップ

基本的な商品探索を確認したら、次を参照してください:

ヘルプが必要な場合

テストエージェントの認証情報

テストエージェントの認証情報(無料):
  • Agent URL: https://test-agent.adcontextprotocol.org/mcp
  • Auth token: 1v8tAhASaUYYp4odoQ1PnMpdqNaMiTrCRqYo9OJp6IQ

認証の理解

一部の操作は認証なしで利用できます:
  • get_adcp_capabilities - エージェントの機能を取得
  • list_creative_formats - クリエイティブ形式を閲覧
  • get_products - 在庫を探索(結果は限定)
多くの操作は認証が必要です:
  • get_products (full results) - 価格付きの完全なカタログ
  • create_media_buy - キャンペーン作成
  • sync_creatives - クリエイティブのアップロード
  • get_media_buy_delivery - パフォーマンス監視
Learn more about authentication →

本番用認証情報の取得

実際のパブリッシャーと連携するには:
  1. sales agent に連絡 - エージェントカード(.well-known/agent-card.json)で連絡先を確認
  2. 認証情報を依頼 - 多くのエージェントは API キーまたは JWT を発行
  3. 安全に保管 - 認証情報をバージョン管理にコミットしない
連携する sales agent ごとに別々の認証情報が必要です。

プロトコルの選択

AdCP は MCP または A2A で動作します。タスクは同一なので、統合形態に合わせて選択してください:
  • MCP - Claude など MCP 対応クライアント向け
  • A2A - Google のエージェントエコシステム向け
Compare protocols →

次に読むもの

よくある問題

”Invalid request parameters” エラー

リクエストに必須項目が含まれているか確認してください。タスクごとに要件があります。 タスクリファレンスを見る →

“Unauthorized” レスポンス

次を確認してください:
  • 認証ヘッダーが含まれている: Authorization: Bearer <token>
  • トークンが有効で期限切れでない
  • この操作に認証が必要なエージェントである