外部 AI の接続 (MCP)
組み込みの AI アナリスト に加えて、Qubix は 自分自身の AI アシスタント — Claude Desktop、Claude Code、Cursor、または MCP(Model Context Protocol)をサポートする任意のクライアント — に接続できます。アシスタントは、インターフェースであなたが持つのとまったく同じアクセス権と権限で、ライブデータを使ってキャンペーンに関する質問に回答します。
必要なもの
- 個人トークン(PAT) — MCP/API ページで作成します。詳細 — MCP/API。
https://<your-domain>/api/mcpの形式の Qubix アドレス。
トークンは作成した瞬間にのみ表示されます。すぐにコピーして安全に保管してください — Qubix はそのハッシュのみを保存し、再表示することはできません。紛失した場合は 再生成 を押すと新しいものが取得できます(古いものはただちに動作しなくなります)。
接続方法
必要なものは 2 つです: アドレス https://<your-domain>/api/mcp と、ヘッダー Authorization: Bearer <your-token>。残りはクライアントによって異なります。
Claude Code (CLI)
claude mcp add --transport http qubix https://<your-domain>/api/mcp \
--header "Authorization: Bearer qbx_YOUR_TOKEN"
Claude Code を再起動してください — Qubix のツールがチャットで利用可能になります。
Claude Desktop
Settings → Connectors → Add custom connector を開き、アドレス https://<your-domain>/api/mcp を設定し、ヘッダー Authorization: Bearer qbx_YOUR_TOKEN を追加します。
Cursor
~/.cursor/mcp.json(またはプロジェクトの .cursor/mcp.json)にサーバーを追加します:
{
"mcpServers": {
"qubix": {
"url": "https://<your-domain>/api/mcp",
"headers": { "Authorization": "Bearer qbx_YOUR_TOKEN" }
}
}
}
アシスタントができること
接続すると、アシスタントはあなたの分析データを読み取り、操作を実行できます — すべてあなたの権限の範囲内で:
- 分析 — ダッシュボード、ジオ、オファー、ネットワーク、トラフィックソース、Facebook の各画面、ビジターファネル、そして個々の広告、キャンペーン、オファー、クリエイティブ、PWA、ジオ、トラフィックソースのドリルダウン。
- クリエイティブ — セマンティック検索(「フェイクチャットのスクリーンショットのようなクリエイティブを探す」)と、最も成果の高いクリエイティブのテーマ。
- Britva — 自動化ルール、一時停止された広告、発火履歴の閲覧。ルールの作成、編集、リリース。
- アクション — 広告とキャンペーンの一時停止・再開。オファー、ネットワーク、トラフィックソース、トラッカーキャンペーンの管理。
- 自由形式のクエリ — 既製のツールではカバーできない質問向け。
アシスタントは、あなたがインターフェースで見るものとまったく同じものを見ます: 管理者はアカウント全体を、バイヤーは自分のチームのデータのみを取得します。操作は管理パネルと同様にあなたの権限によって制限されます。
アシスタントを通じた広告の一時停止、ルールやオファーの削除は、あなたの実際のキャンペーンを変更します。チャットクライアントでは、そうした操作はあなたの確認後にのみ実行されます — 承認する前に、アシスタントが提案する内容を読んでください。
セキュリティ
- トークンはあなたのアクセスキーです — パスワードのように扱い、共有ファイルや公開リポジトリに置かないでください。
- ユーザーごとに 1 つのトークンです。アクセスを取り消すには、MCP/API ページを開いて 失効 を押します(または置き換えるには 再生成)。