# 人工智能代理与模型上下文协议 (https://talivia.com/zh-CN/docs/ai-agents)



Talivia 在以下地址提供账户级[模型上下文协议](https://modelcontextprotocol.io/)端点：

```text
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 桥接器 [#本地-npm-桥接器]

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

```bash
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]

添加托管端点：

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

然后开始浏览器授权：

```bash
codex mcp login talivia
```

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

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

## ChatGPT [#chatgpt]

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

## Claude [#claude]

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

## Claude Code [#claude-code]

注册托管端点：

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

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

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

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

```json
{
  "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 界面相同的账户和网站权限。请确认当前账户有权访问该网站。