人工智能代理与模型上下文协议

Talivia 在以下地址提供账户级模型上下文协议端点：

https://talivia.com/mcp

只需连接一次，获得授权的人工智能代理便可处理 Talivia 账户有权访问的所有网站。代理可以读取 Talivia 中同样的按时间段分析数据，包括事件、目标、漏斗、获客、收入、付款、用户路径和数据质量；也可以安装并验证追踪，或打开安全的付款服务商配置流程。

选择客户端

Codex通过命令行、远程模型上下文协议和 OAuth 连接。ChatGPT在“应用与连接器”中创建自定义应用。Claude将 Talivia 添加为自定义网页连接器。其他客户端使用可流式传输的 HTTP 与 OAuth 发现。

授权如何工作

1. 将 https://talivia.com/mcp 添加到模型上下文协议客户端。
2. 第一个受保护请求会返回 OAuth 质询，其中包含 Talivia 授权元数据。
3. 客户端会在浏览器中打开 Talivia；如有需要，请先登录。
4. 检查请求的权限范围并批准连接。
5. 客户端会保存一个限定权限范围的访问令牌；除非您主动撤销连接，否则该令牌会一直有效。

代理永远不会收到您的 Talivia 密码。付款服务商密钥也会保留在 Talivia 内：Stripe 等服务商需要授权时，工具会返回安全的浏览器移交，而不是要求代理处理凭据。

您可以随时在设置 → 人工智能代理中查看或撤销已批准连接。撤销后，已保存的令牌会立即失效。

本地 npm 桥接器

如果客户端需要本地标准输入输出协议服务器，请使用已发布的 Talivia 软件包：

npx -y @talivia/agent setup --agent codex
npx -y @talivia/agent checkin --agent codex
codex mcp add talivia -- npx -y @talivia/agent mcp

配置命令会打开 Talivia 进行浏览器批准。签入命令将已批准且可撤销的本地凭据保存到 ~/.talivia/config.json，最后一条命令让 Codex 启动经过身份验证的标准输入输出桥接器。

Codex

添加托管端点：

codex mcp add talivia --url https://talivia.com/mcp

然后开始浏览器授权：

codex mcp login talivia

批准后，可以这样要求 Codex：

请为这个项目配置 Talivia。选择或创建正确的网站，安装追踪器，通过安全的浏览器移交连接收入，并验证真实数据已经到达。

ChatGPT

1. 打开 ChatGPT → 设置 → 应用与连接器。
2. 创建名为 Talivia 的自定义应用。
3. 将服务器网址设为 https://talivia.com/mcp，并选择 OAuth。
4. 保存应用，然后在浏览器中完成 Talivia 登录与授权同意。
5. 在对话中启用 Talivia，再要求它检查或完成配置。

Claude

1. 打开 Claude → 自定义 → 连接器 → 添加自定义连接器。
2. 将连接器命名为 Talivia，远程服务器网址使用 https://talivia.com/mcp。
3. 在浏览器中完成 Talivia 登录与授权同意。
4. 在对话中打开 + 菜单，选择连接器并启用 Talivia。

Claude Code

注册托管端点：

claude mcp add --transport http talivia https://talivia.com/mcp

首次调用受保护工具时会启动浏览器授权。

其他模型上下文协议客户端

使用支持 OAuth 发现的可流式传输 HTTP 服务器：

{
  "talivia": {
    "type": "http",
    "url": "https://talivia.com/mcp",
    "auth": "oauth"
  }
}

客户端必须支持模型上下文协议 OAuth 授权服务器发现和浏览器授权流程。如果不支持，请使用上方列出的客户端。

代理可以执行哪些操作

Talivia 提供用于配置和分析的专用工具：

• 读取指定时间段的流量、转化、收入、退款以及上一周期对比。
• 检查事件名称、事件属性、操作次数、独立访客和时间序列。
• 读取已保存的目标定义，并计算选定时间段的结果。
• 读取已保存的漏斗定义，并计算每一步的到达人数和流失。
• 读取仪表板显示的所有 Talivia 维度，包括渠道、来源、全部 UTM 字段、落地页和退出页、主机名、地理位置、浏览器、设备、语言及访客 ID；支持收入的维度还会返回付款和归因收入。
• 读取关键词视图，其中合并了追踪到的 UTM 关键词，以及已连接的 Google Search Console 和 Bing Webmaster 查询、点击、展示、点击率、排名、页面和估算自然搜索收入。
• 读取已确认付款、新客户、续费、退款、争议、订阅和收入归因。
• 查看汇总用户路径，或追踪某一笔付款从获客、产品行为到归因的完整过程。
• 诊断数据新鲜度、身份关联覆盖率、服务商同步失败、待匹配结账返回和未归因付款。
• 创建或选择网站、安装追踪器、通过安全移交连接付款服务商并验证数据接收。

每个分析结果都会标明实际时间段、时区、生成时间，以及数据是已就绪还是为空。startDate 和 endDate 支持任意有效范围，因此代理可以请求 30 天、40 天或准确的广告系列日期，而不依赖固定预设。空数据与查询失败会明确区分。

Talivia 提供已观察到的产品和付款数据，包括现有关键词视图。Google Ads 账户中的花费、广告素材、竞价关键词和广告搜索词仍需从广告平台获取，再由代理与 Talivia 结果合并。

问题排查

浏览器没有打开

确认客户端支持远程服务器 OAuth。删除已有 Talivia 条目，重新添加并再次授权。

端点不可用

打开设置 → 人工智能代理并检查端点状态。健康的端点会显示可以连接。

授权了错误账户

在设置 → 人工智能代理中撤销连接，在浏览器中登录目标 Talivia 账户，然后重新连接。

代理看不到某个网站

模型上下文协议连接遵循与 Talivia 界面相同的账户和网站权限。请确认当前账户有权访问该网站。