# 在 Claude 里用 okdata：网页版和桌面版的自定义连接器

> 把 okdata 加成 Claude 的自定义连接器，claude.ai 和 Claude Desktop 的普通对话就能读抖音、小红书、X、YouTube 的数据，每笔费用都看得见。

网页版：https://okdata.online/zh/integrations/claude/

连接器打开后，你在普通对话里问 Claude“微博热搜上现在有什么，哪些话题和我们的品类有关？”，它会去取实时榜单，而不是凭记忆猜。每次工具调用都会显示在对话里，只有 `call` 收费。

Claude 的自定义连接器是从 Anthropic 的云端发起连接的，claude.ai 和桌面版做法一样。目前 okdata 用请求头里的 API Key 认证；在 Claude 里直接登录 okdata（OAuth）的方式正在开发。

## 接入步骤

服务地址：`https://api.okdata.online/mcp`

1. Customize → Connectors → Add → Add custom connector。Team 和 Enterprise 版要先由 Owner 在 Organization settings → Connectors → Add → Custom → Web 里添加，成员再点 Connect。
2. 填写这些字段：

| 字段 | 值 |
|---|---|
| Name | okdata |
| Remote MCP server URL | `https://api.okdata.online/mcp` |
| Authentication | No sign-in |
| Request headers | `authorization`，值为 `Bearer okd_…`。Claude 不会自动加前缀，“Bearer ” 要自己输入。 |

- 点 Add，出现 Connect 就点一下。在对话里打开 + → Connectors，把 okdata 打开。

## 验证是否接好

> 列出 okdata 的工具。

okdata 已接好，共 5 个工具：`find` 用一句话说要什么数据，返回最多五个接口，带所需参数、价格和可直接用的调用；不会拿别的平台顶替你问的平台；`describe` 查看一到五个接口的完整说明：参数、支持的链接、价格和单次最多花费、翻页、字段和示例；`call` 取一页数据，以文本返回：开头几行写明花了多少、余额还剩多少、怎么翻下一页。失败不扣费；max_price 可以给单次调用封顶；`read_more` 读完被截断（约 20 KB）的结果，或换一种视图再看同一份结果，24 小时内有效；`account` 余额和 key 的花费上限、单次调用的账单、按天或按接口的用量；不带 key 也能看哪些接口可用。只有 `call` 收费。目录里有 17 个平台的 214 个接口。

## 第一次对话

> 微博热搜现在有什么？

| 工具调用 | 结果 | 费用 |
|---|---|---|
| `find {"query":"微博热搜"}` | weibo.trends.list · $0.002/次 · 每页约 50 条榜单 | 免费 |
| `call {"capability":"weibo.trends.list"}` | 一页，约 50 条 | $0.002 |

2 次工具调用 · 1 次收费 · $0.002

## 在 Claude（网页版和桌面版连接器） 里用的建议

- **免费工具直接放行。** `find`、`describe`、`account` 设为不用确认；想每笔收费都过目，就把 `call` 留在“每次询问”。
- **先问价再动手。** “调用之前先告诉我要花多少钱”这句话在哪个客户端都管用。
- **每个客户端单独一把 Key。** 在控制台给每个应用建一把，以后吊销互不影响。
- **重试很安全。** 带同一个 `idempotency_key` 重发不会重复扣费，失败的调用也不收钱。

## 关于 Claude（网页版和桌面版连接器）

- Request headers 是 Claude 只对部分组织开放的测试功能。没有它的话，Claude 只能用登录（OAuth）方式连接，而 okdata 面向连接器的登录还在开发中。在那之前，请用 Claude Code，或按 Claude Desktop 页面里的桥接方式接入。
- 所有套餐都能加自定义连接器；免费版只能加一个。
- 连接器添加后不能改认证方式：要删掉重新添加。
- Claude 是从 Anthropic 的云端发起连接，不是从你的电脑，所以服务地址必须是公网可达的。我们的就是。

接着试试：“用 okdata 看看微博热搜现在有什么。”

根据 Claude（网页版和桌面版连接器） 官方文档整理，阅读日期 2026-11-12。菜单可能会变；步骤对不上时以客户端官方页面为准。

- https://claude.com/docs/connectors/custom/add-unlisted
- https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp

## 出问题时

| 现象 | 原因 | 解决 |
|---|---|---|
| Claude（网页版和桌面版连接器） 里看不到 okdata 的工具 | 添加服务之前就已经打开了，或者地址和上面的不一样。 | 检查配置，然后重启 Claude（网页版和桌面版连接器） 或新开一个对话。 |
| `find` 能用，`call` 报 `unauthorized` | Key 没有传过去。`find` 和 `describe` 不需要 Key，所以照样能用。 | 检查请求头是不是 `Authorization`，值是 `Bearer ` 加 `okd_` 开头的 Key，然后重启。 |
| `call` 报 `insufficient_balance` | 余额不够这次调用的最高费用，没有扣费。 | 让它调一次 `account` 看余额，然后去控制台充值。 |