关于 Kooga
Kooga 是面向企业及其 AI 助手的托管营销 MCP 服务,整合店铺、搜索、AI 可见度和邮件数据,并支持内容与营销操作。对离开 Kooga 或不可撤销的更改,会先请求确认。
主要功能
- 01店铺与销售数据报告
- 02搜索排名和流量分析
- 03AI 可见度与竞争对手跟踪
- 04邮件营销活动与流程管理
- 05外部或不可撤销操作需确认
适用场景
- 01查找搜索流量下滑的文章
- 02比较店铺、邮件和 AI 可见度表现
- 03起草营销活动或客户流程
- 04查看 Kooga Agent 的待处理操作
MCP 相关
Kooga 在 `https://mcp.kooga.io/mcp` 提供托管的 Streamable HTTP MCP 服务,支持 OAuth 2.1 或访问令牌认证。它向客户端开放营销工具、四个提示词和一个术语表资源。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://mcp.kooga.io/mcpclaude mcp add --transport http io-kooga-kooga https://mcp.kooga.io/mcp{"mcpServers":{"io-kooga-kooga":{"type":"http","url":"https://mcp.kooga.io/mcp"}}}在 Cursor 中打开{"servers":{"io-kooga-kooga":{"type":"http","url":"https://mcp.kooga.io/mcp"}}}在 VS Code 中打开{"mcpServers":{"io-kooga-kooga":{"type":"http","url":"https://mcp.kooga.io/mcp"}}}{"mcpServers":{"io-kooga-kooga":{"serverUrl":"https://mcp.kooga.io/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
Kooga
在 AI 助手中管理您的业务营销。
询问销售额、Google 排名、AI 可见度和邮件的变化情况,并让 Kooga 撰写文章、起草营销活动,还能回答 Agent 留给您的问题。任何通过 Kooga 发出的内容,都会先征求您的同意。Kooga 插件整合了托管的 MCP 连接和工作流技能,帮助您的助手熟练使用它。
- 服务:
https://mcp.kooga.io/mcp,Streamable HTTP - 登录: OAuth 2.1(动态客户端注册、PKCE),或访问令牌
- 注册表名称:
io.kooga/kooga
支持的平台
| 服务 | Kooga 在其中的功能 | |
|---|---|---|
| Shopify | 读取订单、产品、客户和商品刊登信息;向商店博客发布文章 | |
| WordPress 和 WooCommerce | 读取 WooCommerce 订单和产品;向网站发布文章 | |
| Google Search Console | 读取点击量、展示次数和查询:刚好未进入首页的页面、流量下滑的文章 | |
| ChatGPT、Claude、Gemini、Perplexity 和 Google AI Overviews | 向它们提问买家会问的问题,并追踪它们提及您的频率、改而提及了谁,以及引用了什么内容 |
邮件由 Kooga 直接通过您自己的已验证域名发送。
安装插件
Claude Code
/plugin marketplace add HushThrive/kooga-mcp
/plugin install kooga@kooga
开启新会话,然后使用 /mcp 登录 Kooga。询问与您业务相关的问题,或调用 /kooga:kooga-mcp。Claude Code 插件文档
Codex
codex plugin marketplace add HushThrive/kooga-mcp
codex plugin add kooga@kooga
开启新会话,并在提示时登录 Kooga。从 /skills 或 $ 选择器中选择 Kooga,或询问有哪些事项待您处理。Codex 插件文档
Cursor
- 打开设置 → 插件。
- 在插件搜索框中粘贴
https://github.com/HushThrive/kooga-mcp。 - 安装 Kooga,然后连接它的 MCP 服务,并在提示时登录。
或者,点击上方的添加到 Cursor按钮,仅连接服务。
VS Code 和 GitHub Copilot
- 在设置中启用
chat.plugins.enabled。 - 在命令面板中运行 Chat: Install Plugin From Source。
- 输入
https://github.com/HushThrive/kooga-mcp并安装 Kooga。 - 开始新的聊天,并在提示时登录 Kooga。
也可以使用上方的 Install in VS Code 按钮,或运行 code --add-mcp '{"name":"kooga","type":"http","url":"https://mcp.kooga.io/mcp"}',仅建立连接。
Claude 和 ChatGPT
- Claude(网页版和桌面版):选择 Settings → Connectors → Add custom connector,将名称设为 Kooga,粘贴
https://mcp.kooga.io/mcp,然后选择 Connect。 - ChatGPT:启用开发者模式(付费方案;对于 Business 或 Enterprise,需由管理员允许),然后添加连接器,地址填入
https://mcp.kooga.io/mcp,并使用 OAuth 登录。
其他助手
通过 Streamable HTTP 添加地址为 https://mcp.kooga.io/mcp 的远程 MCP 服务。Kooga 负责运行服务:你无需在本地安装或运行任何内容。若要在 MCP Inspector 中试用,请运行 npx @modelcontextprotocol/inspector。
如果你的助手支持独立技能,可以单独添加工作流指南:
npx skills add HushThrive/kooga-mcp --skill kooga-mcp
这只会安装说明;请另行添加连接。请选择插件或独立技能,不要同时使用两者,以免指南重复。
连接你的账户
你需要拥有 Kooga 账户,并且是要连接的工作区的所有者或管理员。
- 助手首次连接到服务时,会打开 Kooga 登录页面。
- 勾选它可以访问的工作区,选择 Read only 或 Read and change,然后选择 Allow。
- 询问它可以访问哪些工作区。一个连接可以访问多个工作区,适合代理机构使用。
对于 n8n、Make、脚本或任何无法打开登录页面的客户端,请在 Kooga 中通过 Settings → Connected apps → Access tokens 创建访问令牌。令牌以 kooga_pat_ 开头,只会显示一次,并应放入 bearer 标头:
claude mcp add --transport http kooga https://mcp.kooga.io/mcp --header "Authorization: Bearer kooga_pat_..."
令牌会以你的身份,在你勾选的工作区中生效,并遵循相同的确认要求和限制。请将它保存在客户端的凭据设置中,并像密码一样妥善保管。所有连接都会列在 Settings → Connected apps 中,也可以在那里断开连接。
试试看
- “Kooga 中有哪些事情正等着我处理?”
- “本周我的商店有哪些变化?”
- “哪些文章的流量正在下降?我应该先更新哪些文章?”
- “AI 回答中提到我们和竞争对手并列的频率有多高?”
- “起草一个弃购流程:一小时后发送提醒,第二天再发送一次。”
- “比较 3 月和 2 月的订单、邮件效果和 AI 可见度。”
工具
| 区域 | 读取 | 更改 |
|---|---|---|
| 连接 | readConnection、listWorkspaces | |
| 你的 Agent | readWaitingItems、readRecentRuns、readStatus | approveItem、dismissItem、undoAction |
| 商店 | readStoreOverview、readTopProducts、readProducts、readSalesTrend、readSalesChannels、readCustomerStats | updateListing |
| Google 搜索 | readOpportunities、readDecaying、readRankings、readBacklinks、readSiteHealth、researchKeywords、readListings、readIdeas | generateArticle、refreshArticle、publishArticle、trackKeyword |
| AI 可见度 | readScorecard、readTopics、readCompetitors、readSources、readPerceptions、readAnswers、readShelf | addPrompt、addCompetitor、briefContentGap、proposeProbe |
| 电子邮件 | readPerformance、readDeliverability、readCampaigns、readCampaign、readFlows、readSegments、previewSend、findContacts、readContact | draftCampaign、updateCampaign、scheduleCampaign、sendTestCampaign、resendCampaign、deleteCampaign、draftFlow、updateFlowStep、enableFlow、createSegment、updateContact、unsubscribeContacts、uploadImage、updateEmailBrand |
| 知识 | searchDocuments、readDocument、listDocuments、readOptions | |
| 商店聊天,启用后 | readCustomerInbox、readCustomerFeedback |
已连接服务的工具列表是权威依据:只读连接只能使用读取工具;而读取顾客在你商店聊天中所写内容的工具,只有在你启用聊天后才会显示。每个工具的输入和输出详见工具参考和 kooga.io。
该服务还提供四个现成的提示词(账户审计、周一回顾、修复我最弱的主题、竞争对手雷达),以及 Kooga 术语表资源 kooga://glossary。
执行前会征求确认的操作
在 Kooga 内完成的操作会立即执行,就像你直接在 Kooga 中操作一样。任何会离开 Kooga 的操作,或无法撤销的操作,都会先用 Kooga 自己的措辞征求你的确认。
flowchart LR
A[You ask for a change] --> B{Leaves Kooga, or cannot be undone?}
B -- No: a draft, a segment, a tracked keyword --> C[Done in Kooga]
B -- Yes: publish, send, change the live store --> D[Kooga asks you]
D -- Yes --> E[Done, once]
D -- No --> F[Nothing happens]
如果你的助手能够显示确认问题,就会直接显示;否则会在聊天中询问你。一次确认只执行一项操作。替换了现有内容的更改(例如商品列表或已发布文章)可以撤销,前提是此后没有其他更改;已发送的电子邮件则无法撤销。Kooga 不会转移资金、更改套餐,也不会让任何人订阅。
故障排除
| 问题 | 下一步 |
|---|---|
| 再次要求登录 | 你的会话已结束,或应用已断开连接。请从助手中重新连接 |
| “此连接具有只读权限” | 重新连接并选择 读取和更改 |
| “此连接可访问多个工作区” | 指明你要使用的工作区;助手可以列出这些工作区 |
| 缺少新工具或提示词 | 在助手中刷新连接器的工具,或重新连接 |
| “此工作区尚未连接商店” | 在 Settings → Integrations 中连接 Shopify 或 WooCommerce |
| “此连接已关闭顾客消息” | 由所有者或管理员在 Settings → Connected apps 中启用 |
| “已达到每日允许的上限” | 助手的每日限额已用完。请在 Kooga 中完成其余操作、等待限额重置,或前往 Settings → Connected apps 调高限额 |
| “请求过多” | 等待一分钟,或在一个问题中提出多项请求 |
隐私
- 哪些内容会发送给你的助手:它为你查询的内容(你商店的数据、文章、联系人,以及仅当你启用此功能时,顾客在你商店聊天中写下的内容)会发送给运营该助手的公司,并受该公司的条款约束。
- Kooga 会保留什么:每次请求的记录(请求者、使用的应用、工作区、工具,以及请求是否成功),但绝不会保留发送或返回的内容。你可以在 设置 → 已连接的应用 中查看;每条记录会在 180 天后删除。
- 谁可以访问哪些内容:助手使用为你的账户签发的令牌登录,绝不会看到你的密码。任何人一旦失去对工作区的访问权限,也会同时失去其助手对该工作区的访问权限。
- 来自外部的文本:顾客、其他网站和 AI 引擎撰写的内容会作为信息发送给助手,绝不会作为指令。
完整政策请见 kooga.io/privacy-policy。
此代码库
Kooga 托管该服务,因此此代码库不包含服务端代码。它包含助手和目录安装及列出该服务所需的内容:
| 文件 | 内容 |
|---|---|
plugin.json、mcp.json | 可移植插件及其 MCP 连接(streamable-http) |
.mcp.json | 相同连接的原生格式(http) |
.claude-plugin/、.codex-plugin/、.cursor-plugin/ | 各助手自己的清单;.claude-plugin/marketplace.json 和 .agents/plugins/marketplace.json 使此代码库成为其自身的市场 |
skills/kooga-mcp/ | 工作流技能、工具参考和 Kooga 的徽标 |
server.json | MCP Registry 条目 io.kooga/kooga;文件变更时由 .github/workflows/publish.yaml 发布 |
lhm.plugin.json | LobeHub 列表条目 |
帮助
- 设置和使用:Kooga 文档
- 账户或连接问题:[email protected]
- 此处的指令或元数据有误:提交问题,请勿附上令牌或客户数据
- 漏洞或令牌泄露:请参阅 SECURITY.md
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。