在 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,只对部分组织开放;没看到就直接用方式二。
- 打开 Customize > Connectors,点 Add,再选 Add custom connector。Team 和 Enterprise 版要由 Owner 在 Organization settings > Connectors 里添加。
- 名称填
okdata,服务地址填https://api.okdata.online/mcp。 - 认证方式选 No sign-in。
- 在 Request headers 里选
authorization,值填Bearer okd_...(换成你完整的 key)。Bearer和后面的空格都要带上,Claude 会原样发送。 - 点 Add。
这样加的连接器在网页版和手机上的 Claude 里也能用,因为请求是从 Claude 的服务器发出的,不经过你的电脑。免费版只能添加一个自定义连接器。
方式二:用 mcp-remote 桥接
Claude Desktop 的配置文件只能启动本地服务。开源小工具 mcp-remote 可以把 okdata 的远程服务“变成”一个本地服务。需要先装好 Node.js 18 或更新的版本。
- 在 Claude 菜单里打开 Settings…,进入 Developer,点 Edit Config,会打开
claude_desktop_config.json(Mac 在~/Library/Application Support/Claude/,Windows 在%APPDATA%\Claude\)。 - 加入下面这段,把
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_..." }
}
}
}
- 彻底退出 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