在 Claude Desktop 里用 okdata:加一个社媒数据连接器

用自定义连接器或 mcp-remote 桥接,把 okdata 接进 Claude Desktop,在普通对话里直接问抖音、小红书、X 上的内容和评论。

配好以后,你在 Claude Desktop 里像平时聊天一样问一句“这周抖音上大家怎么评价露营装备”,Claude 会先看抖音热搜榜,再搜相关视频,翻一翻点赞最多的几条下面的评论,最后给你一段带链接的总结。每一步要花钱的调用都会在对话里显示出来,带着价格,你可以点同意,也可以拒绝。

准备

  • 已登录的 Claude Desktop,更新到最新版(Claude 菜单里的 “Check for Updates…”)。
  • 一个 okdata 的 key,以 okd_ 开头。新 key 自带 $0.10 额度。怎么拿 key 见快速开始。

别的接入页都建议把 key 放在环境变量 OKDATA_API_KEY 里。但从程序坞或开始菜单打开的桌面应用读不到终端里设的变量,所以这里 key 只能交给 Claude 保管(方式一),或者写进你用户目录下的配置文件(方式二)。不管哪种,都别把 key 放进项目文件夹或共享文档。

方式一:自定义连接器

前提是你添加自定义连接器时能看到 Request headers(请求头)这一栏。Anthropic 说这一栏还在 beta,只对部分组织开放;没看到就直接用方式二。

  1. 打开 Customize > Connectors,点 Add,再选 Add custom connector。Team 和 Enterprise 版要由 Owner 在 Organization settings > Connectors 里添加。
  2. 名称填 okdata,服务地址填 https://api.okdata.online/mcp。
  3. 认证方式选 No sign-in。
  4. 在 Request headers 里选 authorization,值填 Bearer okd_...(换成你完整的 key)。Bearer 和后面的空格都要带上,Claude 会原样发送。
  5. 点 Add。

这样加的连接器在网页版和手机上的 Claude 里也能用,因为请求是从 Claude 的服务器发出的,不经过你的电脑。免费版只能添加一个自定义连接器。

方式二:用 mcp-remote 桥接

Claude Desktop 的配置文件只能启动本地服务。开源小工具 mcp-remote 可以把 okdata 的远程服务“变成”一个本地服务。需要先装好 Node.js 18 或更新的版本。

  1. 在 Claude 菜单里打开 Settings…,进入 Developer,点 Edit Config,会打开 claude_desktop_config.json(Mac 在 ~/Library/Application Support/Claude/,Windows 在 %APPDATA%\Claude\)。
  2. 加入下面这段,把 okd_... 换成你的 key。文件里如果已经有别的服务,只把 "okdata" 这一块放进现有的 mcpServers 里。
{
  "mcpServers": {
    "okdata": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.okdata.online/mcp", "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer okd_..." }
    }
  }
}
  1. 彻底退出 Claude Desktop(不是关掉窗口),再重新打开。

请求头单独放进 AUTH_HEADER,是因为参数里带空格在部分 Windows 环境下会被拆开。现在 key 以明文存在这个文件里,别把它同步到网盘,也别贴给别人。

确认连上了

点输入框下方的 +,打开 Connectors,应该能看到已开启的 okdata,以及它的四个工具:find、describe、call、account。问一句“我的 okdata 余额还有多少?”,能报出数字就说明 key 生效了。查余额不花钱。

第一句可以这样说

用 okdata:先看今天的抖音热搜榜,再搜“露营装备”相关的抖音视频,
按最新排序,只要一页。挑点赞最多的三条,读读下面的评论,
告诉我大家夸什么、吐槽什么,附上链接。每一步收费的调用之前先报价。

花多少钱

查找和了解接口都免费:find、describe 不需要 key 就能看到接口和价格,account 查余额也不收钱。只有 call 按接口单价收费。上面这句话会用到:

  • 抖音热搜榜:$0.002
  • 抖音视频搜索一页:$0.02
  • 三条视频的评论:每条 $0.002

合计 {{cost:douyin.trends.list1+douyin.videos.search1+douyin.videos.comments.list*3}},试用额度绰绰有余。作为对比,小红书笔记搜索一页是 $0.02。调用失败不扣费。

出问题时

  • 返回 unauthorized(401)。 key 没带上或者填错了。方式一里,检查请求头的值是不是以 Bearer 开头、认证方式是不是选了 No sign-in;请求头保存后不能改,只能删掉连接器重新添加。方式二里,检查 AUTH_HEADER 那一行,然后退出 Claude 再打开。
  • 返回 insufficient_balance(402)。 余额不够这次调用,没有扣费。充值后再问一遍,价格见定价页。
  • 返回 rate_limited(429)。 一下子调用太多。错误里带着 retry_after_seconds,Claude 等这么多秒再发同一个调用就行,不扣费。
  • 看不到连接器或工具。 方式一:确认这次对话里 + > Connectors 下的 okdata 是打开的。方式二:在终端运行 node --version,要显示 v18 或更高;检查 JSON 有没有漏逗号;再看日志,Mac 上是 tail -n 50 ~/Library/Logs/Claude/mcp-server-okdata.log。

接着看

更新于 2026-11-12