Jepto

Jepto MCP

在 Claude、ChatGPT、Cursor、Gemini CLI、Antigravity 及任何其他支持 MCP（Model Context Protocol）的应用中查看你的 Google Ads、Google Analytics 4（GA4）、Search Console、Meta Ads 和 Google Business Profile 数据。用通俗易懂的英语询问广告系列、KPI、预算和客户，从实时数据中获取答案，并直接在聊天中生成完整的 Jepto 报告。

https://mcp.jepto.com

Jepto 将其作为托管的远程 MCP 服务运行，因此无需安装或运行任何东西。本仓库提供相关文档。你需要拥有 Jepto 账户，并至少连接一个数据源；如果还没有账户，可以开始 14 天免费试用。

适用对象

• 营销团队：希望在一次对话中获取 Google Ads、GA4、Search Console 和 Meta Ads 的数据，而不必查看五个仪表板。
• 代理机构和顾问：管理多个品牌。一个连接即可涵盖 Jepto 账户中的所有品牌。
• 多地点企业：跟踪各地点 Google Business Profile 的来电、路线请求和评论。
• Agent 开发者：需要托管服务、OAuth、完善的数据模型，以及每次更改都经过确认。

连接

服务 URL	https://mcp.jepto.com
传输方式	Streamable HTTP
身份验证	使用 PKCE 的 OAuth。连接时只需登录 Jepto 一次。
访问权限	你的 Jepto 账户：应用中你的登录账号可以查看的所有客户

Claude

打开应用目录并搜索“Jepto”，或访问 https://claude.ai/directory/jepto

ChatGPT

在侧边栏中打开 Plugins 并搜索“Jepto”，或访问 https://chatgpt.com/plugins/jepto

Claude Code

安装 Jepto 插件，它会添加服务以及帮助 Claude 查找数据的技能：

/plugin install jepto --marketplace jepto/mcp

对于低于 2.1.275 的 Claude Code 版本，请先运行 /plugin marketplace add jepto/mcp，然后运行 /plugin install jepto@jepto。

若只添加服务，请运行：

claude mcp add --transport http --callback-port 8787 jepto https://mcp.jepto.com

无论采用哪种方式，都要运行 /mcp 并选择 jepto 登录。请保留 --callback-port 8787：Jepto 的登录流程只会返回到该端口。

Gemini CLI

gemini extensions install https://github.com/jepto/mcp

然后运行 /mcp auth jepto 登录。登录时会在你的电脑上打开浏览器，因此请在本地运行，而不要通过 SSH 运行。

Antigravity

agy plugin install https://github.com/jepto/mcp

然后登录。在 CLI 中，打开 /mcp，选择 jepto 并选择 Authenticate。在 Antigravity 应用中，打开 Agent 设置，进入 Customizations，然后点击 jepto 旁边的 Authenticate。使用 Jepto 账号登录后，将显示的代码粘贴回 Antigravity。

Cursor

添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "jepto": {
      "url": "https://mcp.jepto.com"
    }
  }
}

VS Code

添加到 .vscode/mcp.json：

{
  "servers": {
    "jepto": {
      "type": "http",
      "url": "https://mcp.jepto.com"
    }
  }
}

其他 MCP 客户端

查找“Add custom connector”或“remote server”，粘贴 URL 并登录。客户端必须支持使用 PKCE 的 OAuth；不提供 API 密钥选项。

可以询问的内容

你不必指定工具。提出问题后，助手会选择合适的工具。明确说明客户端、平台和日期范围，答案会更准确。

检查所有事项

• “我的账户中，哪些 KPI 或预算至关重要或存在风险？”
• “我使用的是哪个套餐，有多少位客户？”
• “哪些客户投放了 Google Ads 和 Facebook Ads？”

分析效果

• “按渠道比较 Homer's Donuts 本季度与上季度的转化率。”
• “显示 Homer's Donuts 本月每日支出与目标的对比。”
• “预测 Homer's Donuts 本季度剩余时间的 ROAS。”

准备会议

• “介绍一下 Homer's Donuts。他们销售什么，正在投放哪些渠道？”
• “Homer's Donuts 的目标受众和品牌语调是什么？”
• “调出 Homer's Donuts 最新的策略笔记。”

创建报告

• “为 Homer's Donuts 创建一份上月的月度报告，包含 Executive Overview、Paid Search 和 Organic Search 标签页。”
• “在 Paid Search 标签页中添加一个广告系列表格，并将支出图表切换为柱形图。”
• “应用我们的品牌主题，并为此报告撰写执行摘要。”

进行更改（始终先预览）

• “为 Homer's Donuts 创建一个 CPA KPI：低于 $50，按月计算。”
• “为 Homer's Donuts 创建预算：65 天内 $1,500，涵盖所有 Google Ads 广告系列。”
• “暂停 Homer's Donuts 的 Google Ads 账户中的品牌广告系列。”

按平台分类的示例问题

Google Search Console

• “显示过去 90 天内平均排名介于 5 到 15 之间且展示次数超过 1,000 的查询。”
• “与上个月相比，本月哪些网页的点击次数下降最多？”
• “按设备和国家/地区细分过去 28 天的点击次数和 CTR。”

Google Analytics 4 (GA4)

• “上个月哪些落地页带来了最多转化？”
• “比较本季度与上季度按默认渠道组划分的会话数和转化率。”
• “过去 30 天按会话来源划分的购买收入是多少？”

Google Ads

• “上周哪些广告系列的每次转化费用最高？”
• “显示过去 30 天内支出超过 $100 且没有转化的搜索字词。”
• “本月按广告系列类型划分的 ROAS 是多少？”

Meta Ads (Facebook and Instagram)

• “比较过去 14 天 Facebook 与 Instagram 的支出金额、CPM 和链接点击次数。”
• “本月哪些广告的频次最高？”
• “按年龄和性别细分我的潜在客户开发广告系列的覆盖人数。”

Google Business Profile

• “上个月哪些地点获得的电话和路线请求最多？”
• “显示所有地点中尚未回复的评价。”
• “本月哪些搜索关键词让用户找到了我的商家资料？”

跨平台

• “上个月 Google Ads、Meta Ads 和 Microsoft Ads 的总支出、点击次数和转化次数分别是多少？”
• “我是否有望达到本月的广告预算目标？”

工具

读取类工具只返回数据，不会更改任何内容。KPI、预算和平台操作类工具会先返回预览；只有在你于聊天中确认后，才会将内容保存到 Jepto 或更改广告平台。待确认操作会在约 10 分钟后过期。报告类工具会立即保存更改，因此你可以在 Jepto 中查看报告逐步成形。

该服务提供 43 个工具。

工具	功能	模式
account_info	账户名称、套餐、状态、时区、每周起始日，以及客户端、KPI 和预算的数量	读取
client_list	所有客户端及其 clientId、名称和域名	读取
client_info	客户端资料：行业、所在地、产品与服务、联系人和业务模式	读取
client_knowledgebase	搜索客户端存储的笔记、简报和品牌指南	读取
datasource_list	客户端已连接的数据源，或 Jepto 支持的所有数据源类型	读取
analytics_schema	客户端可用的指标和维度	读取
analytics_query	使用度量、维度、筛选条件、日期范围、时段比较和排序查询实时数据	读取
kpi_forecasting	列出、读取、创建、更新和删除 KPI 及其预测	读取 + 写入（先预览）
budget_tracker	列出、读取、创建、更新和删除广告支出预算	读取 + 写入（先预览）
actions_list	可执行的平台操作目录，包含输入项和风险级别	读取
actions_execute	在你确认后执行平台操作	写入（先预览）
skills_list	Jepto 的技能目录：助手可遵循的任务指南	读取
skills_get	获取某项技能的完整说明	读取
help_article	搜索 Jepto 帮助中心，或获取一篇文章	读取
web_search	搜索公开网络以获取外部背景信息	读取
web_fetch	按 URL 读取公开网页	读取

报告工具

工具	功能	模式
report_list	列出账户或某个客户端的报告	读取
report_get	加载报告：标签页、布局、卡片、编辑器、预览和公开链接	读取
report_create	创建报告及其所有标签页（空白状态，可添加卡片）	写入
report_update	修改报告标题、描述、日期范围或主题	写入
report_delete	删除报告	写入
report_page_get	加载一个标签页及其布局	读取
report_page_create	向报告添加标签页	写入
report_page_update	修改标签页标题、描述或布局	写入
report_page_delete	移除标签页	写入
report_card_get	加载单张卡片的设置	读取
report_card_generate	检查数据后，根据数据模型字段或自然语言提示词创建图表或表格卡片	写入
report_card_create	创建 Markdown、HTML、图像、分析或日期筛选器卡片	写入
report_card_update	修改卡片的指标、图表类型、对比、调色板或所属标签页	写入
report_card_delete	删除卡片	写入
report_analysis_run	使用 Jepto 的报告分析 Agent 撰写报告分析	写入
report_analysis_list	列出报告的已保存分析	读取
report_analysis_save	将分析文本保存到报告	写入
report_theme_list、report_theme_get	列出主题或加载一个主题	读取
report_theme_create、report_theme_update、report_theme_delete	创建、修改或删除主题	写入
report_palette_list、report_palette_get	列出调色板或加载一个调色板	读取
report_palette_create、report_palette_update、report_palette_delete	创建、修改或删除调色板	写入

更新页面、卡片和报告时会检查最新保存的版本，因此助手不会覆盖其他人的更改。图表类型包括数字、折线、面积、条形、柱形、环形或散点图；目前 MCP 尚不支持地图卡片。请参阅使用 Jepto MCP 构建报告。

平台操作

目前，目录中有两项 Google Ads 操作。两者风险均为中等，且可撤销：

• googleAdsPauseCampaign：暂停广告系列。广告投放会立即停止。
• googleAdsEnableCampaign：重新启用已暂停的广告系列。广告投放会立即恢复。

后续将添加更多操作。actions_list 始终会显示可用操作。

助手如何查找数据

通常按以下顺序调用：client_list → datasource_list → analytics_schema → analytics_query。要构建报告，助手接着会调用 report_create，使用 report_card_generate 添加卡片，通过 report_page_update 放置卡片，并可调用 report_analysis_run 完成分析。字段名称与 Jepto Reports 和 Data Chat 中使用的名称相同，例如 googleAds.spend 或 googleAds.campaignName。日期可使用 last30days、yesterday 和 30DaysAgo 等标记，也可使用 ISO 日期。请参阅数据模型和数据查询。

数据源

MCP 会读取 Jepto 账户中已连接的数据源：

• 广告： Google Ads、Facebook Ads、Instagram Ads、Microsoft Ads、LinkedIn Ads、TikTok Ads、X (Twitter) Ads
• 分析与搜索： Google Analytics 4、Google Search Console
• 本地： Google Business Profile
• 电商： Shopify (beta)
• 财务： Xero
• AI 搜索： Jepto AI Visibility
• 您自己的数据： 已连接到 Jepto 的 BigQuery 表

每个数据源都有独立页面，其中包含示例问题，以及 Jepto 数据模型中的所有指标和维度：

数据源	指标	维度	字段参考
Google Ads	12	69	google-ads/
Google Analytics 4	30	28	google-analytics-4/
Google Search Console	4	6	google-search-console/
Google Business Profile	29	70	google-business-profile/
Facebook Ads	17	19	facebook-ads/
Instagram Ads	20	18	instagram-ads/
LinkedIn Ads	98	26	linkedin-ads/
Microsoft Ads	85	41	microsoft-ads/
TikTok Ads	203	55	tiktok-ads/
X Ads	3	3	x-ads/
Xero	20	55	xero/
AI Visibility	50	87	ai-visibility/

登录 MCP 不会连接新的平台。请先在 Jepto 中连接数据源。

安全与权限

• 您使用 Jepto 登录信息登录。每次工具调用都遵循您在应用中的相同权限。
• 该连接涵盖您的整个 Jepto 账户，而非单个客户端。不提供 clientId 时，列表工具会返回您的登录信息可查看的所有内容。
• 访问令牌的有效期为 60 分钟，刷新令牌的有效期为 30 天；每次刷新时都会轮换令牌。
• 您的 Google、Meta 及其他平台凭据会保留在 Jepto 中，不会发送给 AI 客户端或出现在对话中。
• KPI、预算和平台操作的更改都需要经过预览和确认步骤。报告更改会立即保存，并保留在 Jepto 中。
• 在 Claude 中，您可以要求在每次工具调用前进行审批。

了解更多：OAuth 与身份验证。

链接

• Jepto MCP
• Jepto MCP Server Overview
• 使用 Jepto MCP 构建报告
• Jepto 数据模型
• Jepto 数据查询
• OAuth 与身份验证
• 定价
• 获取支持

许可证

本仓库中的文档采用 MIT 许可证。Jepto MCP 服务的使用受 Jepto 服务条款约束。