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

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

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

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

## 准备

- 已登录的 Claude Desktop，更新到最新版（Claude 菜单里的 “Check for Updates…”）。
- 一个 okdata 的 key，以 `okd_` 开头。新 key 自带 $0.10 额度。怎么拿 key 见[快速开始](/zh/docs/quickstart/)。

别的接入页都建议把 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](https://nodejs.org/) 18 或更新的版本。

1. 在 Claude 菜单里打开 **Settings…**，进入 **Developer**，点 **Edit Config**，会打开 `claude_desktop_config.json`（Mac 在 `~/Library/Application Support/Claude/`，Windows 在 `%APPDATA%\Claude\`）。
2. 加入下面这段，把 `okd_...` 换成你的 key。文件里如果已经有别的服务，只把 `"okdata"` 这一块放进现有的 `mcpServers` 里。

```json
{
  "mcpServers": {
    "okdata": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.okdata.online/mcp", "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer okd_..." }
    }
  }
}
```

3. 彻底退出 Claude Desktop（不是关掉窗口），再重新打开。

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

## 确认连上了

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

## 第一句可以这样说

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

## 花多少钱

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

- 抖音热搜榜：$0.002
- [抖音视频搜索](/zh/apis/douyin/videos/search/)一页：$0.02
- 三条视频的评论：每条 $0.002

合计 $0.028，试用额度绰绰有余。作为对比，[小红书笔记搜索](/zh/apis/xiaohongshu/notes/search/)一页是 $0.02。调用失败不扣费。

## 出问题时

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

## 接着看

- [MCP 服务说明](/zh/mcp/)：四个工具分别做什么，怎么叮嘱 Claude 控制花费。
- [抖音视频搜索](/zh/apis/douyin/videos/search/)：参数、返回字段和价格。