给 AI

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

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

更新于 2026-11-12

Claude(网页版和桌面版连接器) 连接的地址 https://api.okdata.online/mcp

一个地址,一个请求头:你的 API Key,作为 Bearer 令牌。

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

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

接入步骤

  1. 打开添加 MCP 服务的地方。 Customize → Connectors → Add → Add custom connector。Team 和 Enterprise 版要先由 Owner 在 Organization settings → Connectors → Add → Custom → Web 里添加,成员再点 Connect。
  2. 填写这些字段。 Key 填在客户端里,由客户端保存。
    字段值
    Nameokdata
    Remote MCP server URLhttps://api.okdata.online/mcp
    AuthenticationNo sign-in
    Request headersauthorization,值为 Bearer okd_…。Claude 不会自动加前缀,“Bearer ” 要自己输入。
  3. 点 Add,出现 Connect 就点一下。在对话里打开 + → Connectors,把 okdata 打开。
  4. 让它列出工具。 回答应该和下面一致。

验证是否接好

“列出 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

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

在 Claude(网页版和桌面版连接器) 里用的建议

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

关于 Claude(网页版和桌面版连接器)

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

来源

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

出问题时

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

接上一次,以后直接问 AI。

新 key 自带 $0.10 试用额度。贴一句话,就能接进你的智能体。

免费开始
一句话接进你的 AI

把这句话发给你的智能体

读一下 https://okdata.online/zh/agents.md,帮我把 okdata 配好;我的 key 在环境变量 OKDATA_API_KEY 里。

Claude Code、Cursor、Codex 等能打开网址的智能体,读完会自己配好。

MCP 地址https://api.okdata.online/mcp