MCP連携（AIから操作する）

このアプリは MCP（Model Context Protocol）サーバーを内蔵しています。Claude などの AI クライアントからこのアプリに接続すると、プロジェクトや広告パフォーマンスの確認・入稿（広告作成）までを会話で操作できます。

接続先は https://app.ad-submission.com/api/mcp（リモート HTTP・Streamable HTTP）です。

接続には認証トークンが必要です。マイページ > MCP連携（トークン） から、トークンごとに「どのプロジェクトを操作できるか（プロジェクト権限）」と「どんな操作を許すか（操作権限）」を選んで発行します。用途ごとに権限を絞ったトークンを複数発行できます。

できること

トークンの操作権限は「機能 × 操作範囲」で決めます。機能ごとに「どこまで許すか（操作範囲）」を段階で選びます（なしにした機能はそのトークンでは使えません）。クリエイティブスタジオ・マーケティングリサーチ・アナリティクスは、さらにリーフ（サブ機能）単位で分かれていて、リーフごとに操作範囲を選べます。

たとえば「広告管理=参照+広告操作／入稿=なし／スタジオの画像=参照+編集+生成／リサーチのコンテンツ=参照＋収集」のように、機能・リーフごとに深さを変えたトークンが作れます。トークンの権限を超えるツールを呼び出すと拒否（403）されます。

あわせてプロジェクト権限（全プロジェクト or 選択したプロジェクトのみ）でも制限できます。選択したプロジェクト以外を操作しようとすると拒否されます。

さらに 入稿・広告管理・媒体アカウントの操作は、媒体アカウント権限（すべての媒体アカウント or 選択した連携広告アカウントのみ）で絞れます。たとえば「Google 広告アカウント A だけ入稿・広告管理できるトークン」を発行でき、他のアカウントを操作しようとすると拒否されます（スタジオ・リサーチ・アナリティクスなど媒体に依存しない機能は対象外です）。この設定は、入稿・広告管理・媒体アカウントのいずれかを許可したときだけ表示されます。

トークンを発行する

1. マイページ > MCP連携（トークン） を開きます。
2. トークン名（例: 「Claude Code 連携」）を入力します。
3. プロジェクト権限を選びます（すべてのプロジェクト / 選択したプロジェクトのみ）。
4. 操作権限を選びます（機能ごとに「なし／参照／参照+編集…」の操作範囲をプルダウンで選択）。
5. 入稿・広告管理・媒体アカウントを許可した場合は、媒体アカウント権限（すべて / 選択したアカウントのみ）も選べます。
6. 必要なら有効期限を設定します（未指定なら失効するまで有効）。
7. 「トークンを発行」を押すと、mcpt_ で始まる生トークンが表示されます。

発行済みトークンは同じ画面で一覧でき、権限・最終利用日時の確認や、不要になったトークンの失効ができます。

AIクライアントからの接続

以下の <発行したトークン> は、上で発行した mcpt_… の値に置き換えてください。

Claude Desktop / claude.ai（カスタムコネクタ）

設定の「コネクタ」から、リモート MCP サーバーとして追加します。

• URL: https://app.ad-submission.com/api/mcp
• 認証ヘッダー: Authorization: Bearer <発行したトークン>

Claude Code（CLI）

claude mcp add --transport http ad-submission-app \
  https://app.ad-submission.com/api/mcp \
  --header "Authorization: Bearer <発行したトークン>"

設定ファイルで指定するクライアントの場合

{
  "mcpServers": {
    "ad-submission-app": {
      "url": "https://app.ad-submission.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <発行したトークン>"
      }
    }
  }
}

接続できると、ツール一覧に projects_list や insights_list、studio_image_upload、youtube_upload や *_submit などが表示されます。トークンの権限外のツールを呼び出すと拒否（エラー）が返ります。

使い方の流れ

1. まず AI に「プロジェクト一覧を見せて」と頼みます（内部で projects_list が呼ばれ、各フォルダの projectPlatformId が分かります）。
2. 「このフォルダの広告パフォーマンスを直近7日で」のように依頼すると、インサイトを取得します。
3. 入稿する場合は、「入稿」権限を付けたトークンで接続したうえで「この動画で Google に入稿して」のように依頼します。Google は「YouTube へアップロード → 広告作成」の2段階で進みます。

クリエイティブスタジオの画像操作

クリエイティブスタジオ（各プロジェクトのスタジオ > クリエイティブスタジオ）の画像は、MCP から追加・閲覧・改名・削除できます。これらは「クリエイティブスタジオ」機能を 参照+編集 以上にしたトークンで利用できます（画像の生成は 参照+編集+生成 が必要で、AI の API 利用料がかかります）。

たとえばプロジェクト単位のエージェントやチャットの AI に「この画像をスタジオに保存して」「スタジオの最新の画像を見て、修正点を教えて」のように依頼できます。

安全のしくみ

• トークンでの保護 — マイページで発行した正しいトークンを持つクライアントだけが接続できます。トークンはハッシュ化して保存され、いつでも失効できます。
• プロジェクト権限 — トークンごとに操作できるプロジェクトを限定できます。許可外のプロジェクトを操作しようとすると拒否されます。
• 媒体アカウント権限 — 入稿・広告管理・媒体アカウントの操作を、特定の連携広告アカウントだけに限定できます。許可外のアカウントを操作しようとすると拒否されます。
• 操作権限（機能 × 操作範囲） — トークンごとに、機能ごとの操作範囲（なし／参照／編集・実行・生成…）で許可した範囲だけを実行できます。入稿・広告操作など課金や不可逆を伴うツールには「破壊的操作」の目印が付き、多くの AI クライアントで実行前に確認が入ります。
• 自分のデータだけ — MCP はあなたのアカウントとして動作し、他人のデータには一切アクセスしません（アプリの権限ルールをそのまま利用）。