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
claude.aiで、左側のメニューのカスタマイズ(Customize)を開きます。
コネクタ(Connectors)タブを開きます。
追加(Add)をクリックし、カスタムコネクタを追加(Add custom connector)をクリックします。
名前を
Gloriadsにし、https://gloriads.com/api/mcpを貼り付けて、続ける(Continue)をクリックします。次のページでは何も変更しないでください。claude.aiは、Gloriadsがログイン機能を提供し、自身の情報を公開していることを検出済みです。追加(Add)をクリックします。
接続(Connect)をクリックします。
求められたら、Gloriadsにログインします。
アクセスを求めているアプリを確認し、許可をクリックします。
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の有料プランでしか提供されていません。手順は次のとおりです。
ChatGPTの設定で、開発者モードをオンにします。
プラグイン(Plugins)を開き、新しいプラグイン(New plugin)を開きます。
名前(Name):
Gloriadsと入力します。アイコンと説明は任意です。接続(Connection):サーバーURL(Server URL)のまま、
https://gloriads.com/api/mcpを貼り付けます。認証(Authentication):OAuthを選びます。その下に入力するものはありません。Gloriadsがそのアドレスで設定を公開しており、ChatGPTがそれを読み取ります。
理解したうえで続行する(I understand and want to continue)にチェックを入れ(ChatGPTは、Gloriadsを含むすべてのカスタムサーバーでこの警告を表示します)、作成(Create)をクリックします。
ChatGPTがGloriadsを開きます。求められたらログインし、アクセスを求めているアプリがChatGPTであることを確認して、許可をクリックします。
会話の中で、最初の質問の前にプラグインをオンにします。
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_report | 1つのマーケットプレイスのストリーミングTV広告のキャンペーンと、その数値 | 「今月、米国のテレビ広告の成果はどうでしたか?」 |
list_campaigns | 1つのマーケットプレイスのキャンペーン | 「ドイツで一時停止中のキャンペーンを一覧表示してください」 |
list_ad_groups | 1つのマーケットプレイスの広告グループ | 「このキャンペーンの広告グループのデフォルトの入札額はいくらですか?」 |
list_targets | 1つのキャンペーンのキーワードやその他のターゲット | 「このキャンペーンはどのキーワードを、いくらの入札額でターゲティングしていますか?」 |
list_ads | 1つのキャンペーンの広告 | 「このキャンペーンの広告対象商品はどれですか?」 |
list_rules | ルール | 「オンになっているルールはどれですか?」 |
list_rule_runs | 1つのルールの直近の実行 | 「このルールは前回の実行で何を変更しましたか?」 |
list_activity | GloriadsがAmazonで行ったすべてのこと | 「今週、Gloriadsは何を変更しましたか?」 |
get_activity | 1つの操作 | 「そのコピーは完了しましたか?」 |
list_activity_lines | 1つの操作が変更したものを1行ずつ | 「そのルールはどの入札額を、どれだけ下げましたか?」 |