Kampalo

Grok Build 用 Kampalo プラグイン

Kampalo のホスト型 FastMCP サーバーに接続する Grok Build プラグインです。Grok は 同期済みの広告／SEO／GA4 データを読み取り、Kampalo にすでにある自動化（停止の提案、広告／SEO アラート、ROAS 停止ルール、レポート JSON）を実行できます。

このプラグインは製品 API を追加しません。Grok を python manage.py run_mcp_server に接続します。

• marketing/agents/suites.py の読み取りツール（同期済みの Postgres）
• marketing/agents/automation_backend.py の automate_* ツール（/api/marketing/actions/ と同じサービス、アラートルール、自動化ルール、レポート）

アプリ内の Kai（LangGraph）は引き続き 読み取り専用 です。automate_* を使用できるのは、この MCP カタログのみです。

インストール

プラグインが xAI marketplace に掲載されたら、Grok Build で /plugin を実行し、Kampalo を検索してインストールします。

それまでは、プラグインリポジトリからインストールしてください。

grok plugin install Tekreign/kampalo-cursor-plugin

Kampalo の Settings → API Keys で発行した個人用の kmp_… キーを KAMPALO_MCP_API_KEY に設定してください（Starter および Enterprise）。初めてツールを使用するとき、Grok は Authorization: Bearer … を指定して https://be.kampalo.com/mcp を呼び出します。

すべてのツールで、Kampalo の user_id または user_email も必要です。どちらも不明な場合はユーザーに確認してください。個人用キーにはユーザーがすでに紐付けられているため、両方とも省略できます。

Cursor

同じリポジトリには、Grok ファイルと並んで Cursor 用のパッケージも含まれています。どちらも同じ skills/ と MCP サーバーを使用します。

Grok Build	Cursor
.grok-plugin/plugin.json	.cursor-plugin/plugin.json
.mcp.json (${KAMPALO_MCP_API_KEY})	mcp.json (${env:KAMPALO_MCP_API_KEY})

1. Kampalo の Settings → API Keys でキーを生成します。

2. Cursor の起動元の環境にキーを設定してから、Cursor を再起動します。

   setx KAMPALO_MCP_API_KEY "kmp_..."
   

   export KAMPALO_MCP_API_KEY="kmp_..."   # in ~/.zshrc or ~/.bashrc
   

3. このリポジトリから Cursor にプラグインをインストールします。Settings → MCP で kampalo が接続済みと表示されることを確認してから、次のように依頼します。Kampalo で Google と Meta を簡潔に比較してください。

プラグインがなくても、mcp.json から kampalo エントリをコピーすれば、プロジェクトまたはユーザーの ~/.cursor/mcp.json から同じサーバーを使用できます。

Claude（claude.ai、Cowork、Claude Code）

Claude プラグインは claude/ にあり、Claude ディレクトリに掲載されています。OAuth を使用するため、初回は Claude から Kampalo へのサインインを求められ、KAMPALO_MCP_API_KEY を設定する必要はありません。サインイン済みのアカウントが自動的に適用されるため、このプラグインのスキルには user_id／user_email の手順がありません。スキルを編集するときは、両方のコピーを同期してください。

このリポジトリのマーケットプレイスから Claude Code にインストールします（.claude-plugin/marketplace.json が ./claude を参照しています）。

/plugin marketplace add Tekreign/kampalo-cursor-plugin
/plugin install kampalo@kampalo

/mcp を実行して kampalo を選択し、プロンプトが表示されたら Kampalo にサインインしてください。

ネットワークと認証情報

項目	値
MCP エンドポイント	https://be.kampalo.com/mcp（ストリーミング可能な HTTP）
認証	Authorization: Bearer ${KAMPALO_MCP_API_KEY}
シークレット	Kampalo の Settings → API Keys で発行した個人用の kmp_… キー（Starter および Enterprise）。アカウント、プラン、ロールにスコープが設定されています。

このプラグインは、その MCP ホストとのみ通信します。ローカルの .env／SSH キーを読み取ったり、他の場所にテレメトリを送信したりすることはありません。

Grok でできること

MCP が稼働しており、Kampalo ユーザーにデータを変更する権限（管理者、または Enterprise のマネージャー／マーケター）があれば、変更を確定できます。アラート／自動化ルールの書き込みは 管理者のみ が実行できます。

1. 同期済みの統計情報から、Google と Meta、SEO、GA4、オーガニックの Page／IG を簡潔に比較する
2. 選択した成果の低いキャンペーンの停止を提案する
3. その提案を確定する（confirm=true） — Google または Meta に PAUSED を書き込む
4. 広告アラート（ROAS／CPA／消化ペース）と SEO／AEO アラートを作成する
5. ドライランの ROAS 自動化ルールを作成し、confirm_live=true の場合のみライブで有効化する
6. パフォーマンスレポートの JSON を生成する（MCP 経由では PDF のバイトデータを取得できません）

できないこと

• OAuth への接続、予算の変更、キャンペーンの作成、Shopify/TikTok への書き込み
• カタログに基づく提案と明示的な確認がない状態での一時停止
• 確認操作やルール管理での閲覧専用ユーザーとしての動作
• MCP が停止中、または DB に行がない場合の指標の捏造

レイアウト

kampalo-cursor-plugin/
├── .grok-plugin/plugin.json
├── .mcp.json
├── .cursor-plugin/plugin.json
├── mcp.json
├── .claude-plugin/plugin.json
├── .claude-plugin/marketplace.json
├── skills/campaign-performance-brief/
├── skills/automate-kampalo-work/
├── assets/logo.svg
├── LICENSE
└── README.md

スキル

スキル	場合
campaign-performance-brief	同期済みの Google Ads、Meta Ads、Search Console、GA4、Page/IG を読み取ります
automate-kampalo-work	一時停止、アラート、ROAS ルール、レポート JSON を提案／確認します

プロンプトの例

読み取り

Kampalo のメールアドレス [email protected] を使ってください。Google と Meta の概要を教えてください。ROAS が最も低いキャンペーンはどれですか？

提案（実際には一時停止しない）

ROAS が最も低い Google キャンペーンの一時停止を提案してください。まだ確認はしないでください。

automate_propose_pause と、保留中の action_id が返されることを想定します。実際のキャンペーンのステータスは ENABLED のままでなければなりません。

確認（実際に一時停止する）

アクション <id> の一時停止を確認してください。

confirm=true を指定した automate_confirm_action が返されることを想定します。キャンペーンは PAUSED になります（有効な Google/Meta トークンが必要です）。

ウォッチドッグ

ROAS が 3 日間 1 未満で、支出が少なくとも $10 の場合に Google キャンペーンを一時停止する、ドライランのルールを作成してください。実際に有効化はしないでください。

dry_run=true、is_active=false を指定した automate_upsert_automation_rule が返されることを想定します。

失敗時

MCP を停止して、もう一度依頼してください。ボットは一時停止した、またはルールを保存したと主張してはなりません。

ライセンス

MIT