Kampalo

Grok Build 的 Kampalo 插件

Grok Build 插件，可连接到 Kampalo 托管的 FastMCP 服务。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）仍为只读。只有此 MCP 目录包含 automate_*。

安装

插件在 xAI marketplace 上架后，在 Grok Build 中运行 /plugin，搜索 Kampalo 并安装。

在此之前，请从插件仓库安装：

grok plugin install Tekreign/kampalo-cursor-plugin

将 KAMPALO_MCP_API_KEY 设为你在 Kampalo 设置 → API Keys 中获取的个人 kmp_… 密钥（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 设置 → 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 已连接，然后询问：Brief Google vs Meta in Kampalo.

没有插件时，同一服务也可以通过项目级或用户级 ~/.cursor/mcp.json 使用，只需从 mcp.json 复制 kampalo 条目。

Claude（claude.ai、Cowork、Claude Code）

Claude 插件位于 claude/，也是 Claude 目录所列出的插件。它使用 OAuth：Claude 首次会要求你登录 Kampalo，因此无需设置 KAMPALO_MCP_API_KEY。其技能是 skills/ 的副本，但省略了 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 设置 → 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 不可用或数据库没有行数据，则不会编造指标

目录结构

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>。

预期会调用 automate_confirm_action，并设置 confirm=true。广告系列将变为 PAUSED（需要有效的 Google/Meta 令牌）。

看门狗

创建一条试运行规则：如果 Google 广告系列的 ROAS 连续 3 天低于 1，且花费至少为 $10，则暂停。不要启用实时执行。

预期会调用 automate_upsert_automation_rule，并设置 dry_run=true、is_active=false。

故障

停止 MCP 后再次提问。机器人不得声称已暂停广告系列或已保存规则。

许可证

MIT