APIとAIアシスタント/AIアシスタントを接続

AIアシスタントを接続

読み取り専用のMCPコネクタで、claude.ai、ChatGPT、Claude Code、Cursor、VS Code、Claude DesktopからGloriadsのアカウントについて質問できます。

AIアシスタントをGloriadsに接続すると、アカウントについてふだんの言葉で質問できます。

アシスタントが見られるのはGloriads APIが見られるものとまったく同じで、アカウントの内容は何も変更しません。

アシスタントが見られるもの

  • APIが見られるものすべてで、それ以外は見られません。
  • 変更できるものはありません。設定も請求も変更できません。
  • データはGloriadsの外に出ます。信頼できるアシスタントだけを接続してください。アシスタントがアカウントを読み取ったあとに接続を解除すると(設定 → API → 接続済みのアプリ)、それ以降の読み取りは止まりますが、すでに読み取られた内容を取り消すことはできません。

質問できること

  • 「先月の広告の成果はどうでしたか?どのマーケットプレイスでいちばん広告費を使いましたか?」
  • 「ACOSは前月より改善していますか?」
  • 「過去30日間でACOSがいちばん高かった商品はどれですか?」
  • 「今月の広告費を日ごとに表示してください」
  • 「ドイツで一時停止中のキャンペーンを一覧表示してください」
  • 「このキャンペーンはどのキーワードをターゲティングしていますか?」
  • 「今週、ルールは何を変更しましたか?入札額を1件ずつ教えてください」

アシスタントはダッシュボードと同じ数値を読み取ります。読み取れるものの一覧は、APIで読み取れるものをご覧ください。

アドレスと、各アシスタントに必要なもの

アドレスは1つで、どのアシスタントでも同じです。

https://gloriads.com/api/mcp
アシスタント必要なもの
claude.ai、Claude Desktopログインして許可をクリックするだけです。コピーするキーはありません。
ChatGPT同じログインですが、有料プランで、開発者モードを使います。
Claude Code、Cursor、VS Code設定 → APIで作成したAPIキーの1つ。

カスタムMCPサーバーに対応したほかのツールでも、同じアドレスを使えます。

必要なものはすべて、アプリの1つのページ(設定 → API)にまとまっています。アドレス、すぐに使えるコマンド、キーです。各ブロックにコピーボタンがあります。

claude.ai

  1. claude.aiで、左側のメニューのカスタマイズ(Customize)を開きます。

  2. コネクタ(Connectors)タブを開きます。

  3. 追加(Add)をクリックし、カスタムコネクタを追加(Add custom connector)をクリックします。

  4. 名前をGloriadsにし、https://gloriads.com/api/mcpを貼り付けて、続ける(Continue)をクリックします。

  5. 次のページでは何も変更しないでください。claude.aiは、Gloriadsがログイン機能を提供し、自身の情報を公開していることを検出済みです。追加(Add)をクリックします。

  6. 接続(Connect)をクリックします。

  7. 求められたら、Gloriadsにログインします。

  8. アクセスを求めているアプリを確認し、許可をクリックします。

  9. claude.aiに戻ります。コネクタのページのツールの権限(Tool permissions)で、常に許可(Always allow)を選びます。これで、Claudeは毎回確認せずに数値を読み取れます。このコネクタはそれ以外のことはできません。

会話の中で、アプリに求められたらコネクタをオンにし、質問します。

Haikuに質問しましょう。Claudeのモデルの中で最も速く、最も安価です。数値を読み取るだけなら、それ以上の性能は必要ありません。会話のモデルメニューで選びます。

Claudeの無料アカウントでは、カスタムコネクタを1つ追加できます。

接続を解除するには、Gloriadsで設定 → API → 接続済みのアプリを開き、接続を解除を選びます。数値の読み取りはすぐに止まります。

Claude Desktop

Claude Desktopはclaude.aiと同じコネクタを使うため、追加でインストールするものはありません。どちらかでコネクタを追加し、ログインして許可をクリックすれば、両方で使えます。

ChatGPT

ChatGPTの接続方法はClaudeとは異なります。カスタムサーバーは開発者モード(developer mode)の中にあり、開発者モードはChatGPTの有料プランでしか提供されていません。手順は次のとおりです。

  1. ChatGPTの設定で、開発者モードをオンにします。

  2. プラグイン(Plugins)を開き、新しいプラグイン(New plugin)を開きます。

  3. 名前(Name):Gloriadsと入力します。アイコンと説明は任意です。

  4. 接続(Connection):サーバーURL(Server URL)のまま、https://gloriads.com/api/mcpを貼り付けます。

  5. 認証(Authentication):OAuthを選びます。その下に入力するものはありません。Gloriadsがそのアドレスで設定を公開しており、ChatGPTがそれを読み取ります。

  6. 理解したうえで続行する(I understand and want to continue)にチェックを入れ(ChatGPTは、Gloriadsを含むすべてのカスタムサーバーでこの警告を表示します)、作成(Create)をクリックします。

  7. ChatGPTがGloriadsを開きます。求められたらログインし、アクセスを求めているアプリがChatGPTであることを確認して、許可をクリックします。

  8. 会話の中で、最初の質問の前にプラグインをオンにします。

  9. ChatGPTが自動で行える範囲を、設定 → プラグイン → Gloriads → 権限(Settings → Plugins → Gloriads → Permissions)で選びます。読み取りアクションを許可(Allow read actions)で十分です。このコネクタは読み取りしかできません。すべてのアクションを許可(Allow all actions)はリスクが高いと表示され、ここでは何のメリットもありません。

接続を解除するには、claude.aiの場合とまったく同じく、Gloriadsで設定 → API → 接続済みのアプリを開き、接続を解除を選びます。

Claude Code

設定 → API → キーを作成でキーを作成し、「Claude Code」という名前を付けてコピーします。キーが表示されるのは1回だけです。

次に、YOUR_API_KEYをご自身のキーに置き換えて、ターミナルで次のコマンドを実行します。

claude mcp add --transport http gloriads https://gloriads.com/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"
  • claude mcp list、またはClaude Code内の/mcpで確認します。
  • サーバーは現在のプロジェクトに追加されます。すべての場所で使うには、--scope userを付けます。
  • 削除するには:claude mcp remove gloriads。

Cursor

キーを環境変数GLORIADS_API_KEYに設定し、次の内容を~/.cursor/mcp.json(すべてのプロジェクト)または.cursor/mcp.json(1つのプロジェクト)に貼り付けます。

{
  "mcpServers": {
    "gloriads": {
      "url": "https://gloriads.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:GLORIADS_API_KEY}"
      }
    }
  }
}

Cursorはキーをこの環境変数から読み取るため、ファイルにキーが書き込まれることはありません。Cursorを開く前に、環境変数を設定してください。

VS Code

コマンドパレットからMCP: Open User Configurationを開く(すべてのプロジェクト)か、プロジェクトに.vscode/mcp.jsonを作成して、次の内容を追加します。

{
  "inputs": [
    {
      "type": "promptString",
      "id": "gloriads-api-key",
      "description": "Gloriads API key",
      "password": true
    }
  ],
  "servers": {
    "gloriads": {
      "type": "http",
      "url": "https://gloriads.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:gloriads-api-key}"
      }
    }
  }
}

VS Codeは、サーバーを最初に起動したときにキーをたずね、それを記憶するため、ファイルにキーが書き込まれることはありません。

アシスタントが使うツール

アシスタントが質問に合ったツールを選びます。各ツールは、APIの一部分を読み取ります。

ツール読み取る内容質問の例
get_accountサブスクリプション、Amazon Adsが接続されているかどうか、数値がどの日までそろっているか「サブスクリプションは有効ですか?」
list_marketplaces接続済みのマーケットプレイスと、それぞれが運用しているキャンペーンの数「どのマーケットプレイスが接続されていますか?」
get_summary期間の合計(マーケットプレイス別・広告タイプ別の内訳も含む)と、求めに応じて以前の期間との比較「先月の広告費はいくらでしたか?その前の月と比べてどうですか?」
get_timeline同じ数値を日ごと、または月ごとに「今月の売上を日ごとに表示してください」
get_products_report期間中の商品ごとの数値「ACOSがいちばん高い商品はどれですか?」
get_streaming_tv_report1つのマーケットプレイスのストリーミングTV広告のキャンペーンと、その数値「今月、米国のテレビ広告の成果はどうでしたか?」
list_campaigns1つのマーケットプレイスのキャンペーン「ドイツで一時停止中のキャンペーンを一覧表示してください」
list_ad_groups1つのマーケットプレイスの広告グループ「このキャンペーンの広告グループのデフォルトの入札額はいくらですか?」
list_targets1つのキャンペーンのキーワードやその他のターゲット「このキャンペーンはどのキーワードを、いくらの入札額でターゲティングしていますか?」
list_ads1つのキャンペーンの広告「このキャンペーンの広告対象商品はどれですか?」
list_rulesルール「オンになっているルールはどれですか?」
list_rule_runs1つのルールの直近の実行「このルールは前回の実行で何を変更しましたか?」
list_activityGloriadsがAmazonで行ったすべてのこと「今週、Gloriadsは何を変更しましたか?」
get_activity1つの操作「そのコピーは完了しましたか?」
list_activity_lines1つの操作が変更したものを1行ずつ「そのルールはどの入札額を、どれだけ下げましたか?」

知っておきたいこと

  • アプリと同じ数値です。各回答には、使った期間と通貨が示され、数値が不完全な場合はその旨が示されます。
  • キーはアカウント全体を読み取ります。共有ファイルには入れず、アシスタントを使わなくなったら設定 → APIで無効にしてください。
  • 制限はAPIと共通です:アカウントごとに、1分あたり60リクエスト、1日あたり10,000リクエストです。1つの質問で複数のリクエストを使うことがあります。制限とエラーをご覧ください。
  • アカウントがなくても、開発者ツールで試せます:APIリファレンスの公開デモキーはここでも使え、デモアカウントの架空の数値を読み取ります。