メインコンテンツまでスキップ

MCP/API

MCP/API は Qubix への唯一のプログラミングインターフェースです。外部クライアント（AI アシスタント、BI スクリプト、自動化ツール）は MCP（Model Context Protocol）経由で 1 つの エンドポイントに接続し、このページに記載されたメソッドを呼び出します。すべての呼び出しは あなたの権限の範囲内で厳密に実行されます。管理者はアカウント全体に、バイヤーは自分のチームの データのみにアクセスできます。

学習すべき別の REST API はありません。ここに表示されるメソッドがまさにエンドポイントが提供する ものであり、カタログが実際のインターフェースから乖離することは決してありません。

同じメソッドが組み込みアシスタントを動かしています​

これらのメソッドは外部クライアント専用ではありません。組み込みの Qubix AI アシスタント — 管理パネルのすべての画面で利用でき、設定不要のパネル — はまったく同じカタログを呼び出します。 そのため、組み込みアシスタントに尋ねる場合も、独自の AI エージェントを MCP 経由で接続する場合も、 どちらも同じメソッドを通じて、常にあなたの権限の範囲内であなたのデータを読み取り、操作を実行します。

  • 組み込み — すべてのページにあるアシスタント。AI アナリストチャットを参照してください。
  • 外部 — Claude、Cursor、その他の MCP クライアントを接続します。 外部 AI の接続を参照してください。

どこにあるか​

管理パネルで アカウントメニュー（右上、名前の隣）を開き、MCP/API を選択します。

エンドポイント​

すべては 1 つのアドレスに送られます：

POST https://<your-domain>/api/mcp

トランスポートは Streamable HTTP（JSON-RPC 2.0）です。対応する MCP クライアントがネイティブに 扱える単一のエンドポイントであり、任意の言語から直接呼び出すこともできます（下記の コード例を参照してください）。

API トークン​

プログラムによるアクセスには 個人トークン（PAT） を使用します。これはこのページの API Token ブロックで作成・管理されます。

  1. API トークンを生成 を押します（すでにトークンがある場合は 再生成）。
  2. トークンをすぐにコピーしてください — 一度だけ 表示されます。

トークンは qbx_… のような形式です。Qubix はそのハッシュのみを保存し、二度と表示することは できません。

  • ユーザーごとに 1 つのトークン。 トークンはあなたのロールと権限を継承するため、API 経由でも インターフェースとまったく同じデータと操作にアクセスできます。
  • 再生成 は新しいトークンを発行し、古いトークンは直ちに無効になります。
  • 失効 はトークンを削除し、それを使用していたすべてのアクセスを遮断します。
トークンはパスワードと同じように扱ってください

個人トークンはあなたとしてサインインするのと同等です。公開したり共有したりしないでください。 漏洩した場合は、ここで 再生成 を押してください — 古いトークンは 即座に無効になります。

クライアントを接続する​

ほとんどの MCP クライアントは小さな設定を必要とします。エンドポイントと Authorization ヘッダーです。 トークンは生成直後に表示されますが、このページではすでに実際の値が下記の例に埋め込まれています — そのままコピーしてください。

JSON
{
  "mcpServers": {
    "qubix": {
      "url": "https://<your-domain>/api/mcp",
      "headers": { "Authorization": "Bearer qbx_YOUR_TOKEN" }
    }
  }
}

特定のアシスタント（Claude Code、Claude Desktop、Cursor）の手順ごとの設定については、 外部 AI の接続を参照してください。

コード例​

独自のコードからエンドポイントを呼び出すには、認証ヘッダーと Streamable-HTTP ヘッダーを付けて JSON-RPC リクエストを送信します。このページでは cURL、JavaScript、 Python 向けの既製スニペットを提供しています — タブを切り替えてコピーしてください。たとえば、 利用可能なメソッドの一覧を取得する例：

Bash
curl -X POST 'https://<your-domain>/api/mcp' \
  -H 'Authorization: Bearer qbx_YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Python
import requests

res = requests.post(
    "https://<your-domain>/api/mcp",
    headers={
        "Authorization": "Bearer qbx_YOUR_TOKEN",
        "Content-Type": "application/json",
        "Accept": "application/json, text/event-stream",
    },
    json={"jsonrpc": "2.0", "id": 1, "method": "tools/list"},
)
print(res.text)
カスタム連携向け

これらの生の呼び出しは、任意の言語からプロトコルを示すものです。既製のクライアント（Claude、 Cursor）には不要です — それらは上記の設定を使用します。

API が公開するもの​

このページには完全な メソッドカタログ（現在約 100 個のメソッド）が一覧表示され、それぞれに 読み取り または 書き込み のタグが付いています。あなたの 権限の範囲内で、次をカバーします：

  • アナリティクス — ダッシュボード、ジオ、オファー、ネットワーク、トラフィックソース、 Facebook 画面、訪問者ファネル、さらに単一の広告、キャンペーン、オファー、クリエイティブ、PWA、 ジオ、トラフィックソースへのドリルダウン。
  • クリエイティブ — セマンティック検索と最高のパフォーマンスを示すクリエイティブテーマ。
  • Britva — 自動化ルール、一時停止された広告、発火履歴の表示。ルールの作成、編集、リリース。
  • アクション — 広告とキャンペーンの一時停止と再開。オファー、ネットワーク、 トラフィックソース、トラッカーキャンペーン、ピクセル、ウェブサイト、ドメイン、PWA、プッシュ キャンペーンの管理。
  • 自由形式クエリ — 既製のメソッドではカバーできない質問のための読み取り専用クエリメソッド。

各メソッドはそのパラメーターとデータを変更するかどうかを表示します。検索ボックスを使って名前や 説明からメソッドを探せます。

書き込みメソッドは実際に動作します

API 経由で広告を一時停止したり、ルールやオファーを削除したりすると、稼働中のキャンペーンが 変更されます。チャットクライアントでは、そのような操作はあなたの確認後にのみ実行されます — 承認する前に提案内容を確認してください。

次のステップ​

外部 AI の接続

Claude、Cursor、その他の MCP クライアントを手順ごとに設定します。

接続

Qubix が連携する外部サービスのキー。

テンプレート

あなたのロール — ひいてはあなたのトークン — がアクセスできるデータと操作。

On this page