# 在 ChatGPT 里用 okdata：桌面版、MCP 和 GPT Actions

> 2026 年 11 月，ChatGPT 的哪些入口能用 okdata 的 key，以及能用的那几种怎么配：桌面版、自定义 MCP 服务、GPT Action。

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

想要的效果是这样的：每天早上问 ChatGPT 一句“今天微博和抖音热搜上有什么，哪些和我们这个品类有关”，它去拿实时榜单，给你一份带排名和热度的短名单，而不是凭记忆瞎编。不过 ChatGPT 今年秋天改动很大，不是每个入口都能带上 okdata 的 key，所以先说清楚截至 2026 年 11 月，哪里能用、哪里不能用。

## 哪里能用

| 入口 | 能不能发起收费调用 |
|---|---|
| ChatGPT 桌面版，通过本机的 MCP 配置 | 能，推荐用这个 |
| ChatGPT 网页版的自定义 MCP 服务（Business、Enterprise、Edu；Pro 有限制） | 只能用免费的查询。网页版的自定义 MCP 服务只支持 OAuth 或不认证，发不了 API key |
| 自定义 GPT 加 Action | 能，但个人版（Free、Go、Plus、Pro）已经不能新建 GPT，而且 OpenAI 会在 2026 年 12 月 11 日下线自定义 GPT |

## 准备

- 一个 okdata 的 key，以 `okd_` 开头。新 key 自带 $0.10 额度。怎么拿 key 见[快速开始](/zh/docs/quickstart/)。
- 用桌面版的话，把 key 放进环境变量 `OKDATA_API_KEY`（Mac 上在 `~/.zshrc` 里加一行 `export OKDATA_API_KEY="okd_..."`）。

## 方式一：ChatGPT 桌面版

桌面版、Codex 命令行和 Codex 的 IDE 插件共用一份 MCP 配置文件，这份配置可以从环境变量读取 bearer token。

1. 打开 `~/.codex/config.toml`（没有就新建），加上：

```toml
[mcp_servers.okdata]
url = "https://api.okdata.online/mcp"
bearer_token_env_var = "OKDATA_API_KEY"
```

2. 在桌面版里打开 **Settings**，进入 **MCP servers**，应该能看到 `okdata`；如果提示重启，就点 **Restart**。
3. 新开一个对话，在输入框里输入 `/mcp`，能看到 `okdata` 和它的四个工具：`find`、`describe`、`call`、`account`。

更多细节，包括从程序坞打开的应用读不到环境变量怎么办，见 [Codex 接入页](/zh/integrations/codex/)。

## 方式二：网页版的自定义 MCP 服务

Business、Enterprise、Edu 工作区里，管理员和所有者（Enterprise 和 Edu 还包括他们授权的成员）可以进入 **Plugins**，点加号，选 **Add custom MCP server**，在 **Connection** 里填 `https://api.okdata.online/mcp`。认证选不认证，勾选 **I understand and want to continue**，再点 **Create as a plugin**。

先把预期说清楚：这样接上以后，ChatGPT 能用 `find` 和 `describe` 浏览全部 51 个接口和价格，规划任务、估算花费很方便；但每次 `call` 都会返回 `unauthorized`，因为 ChatGPT 不会给自定义 MCP 服务发送 API key。真要取数据，请用方式一或方式三。

## 方式三：自定义 GPT 加 Action（12 月 11 日前）

只适合还能新建或编辑 GPT 的工作区。GPT 迁移成插件时，Action 不会跟着迁过去，所以把它当成过渡方案。

1. 在编辑器里打开你的 GPT，进入 **Actions** 区域，点 **Create new action**。
2. 从网址 `https://okdata.online/openapi.json` 导入 schema，或者把文件内容直接粘贴进去。
3. 认证选 **API key**，类型选 **Bearer**，粘贴你的 key。
4. 在 **Preview** 里试一句：“现在微博热搜上有什么？”
5. 要分享到工作区以外，需要填隐私政策网址，okdata 的是 `https://okdata.online/privacy/`。

有两个坑。OpenAI 论坛里有人反馈，一个 Action 最多只能有 30 个操作；okdata 的 schema 有 51 个接口，外加 3 个免费的目录接口。如果导入时报这个错，就把 `openapi.json` 下载下来，删掉用不到的路径再粘贴。另外，所有用这个 GPT 的人花的都是**你的**余额，只分享给你愿意把 key 交给他的人。

## 第一句可以这样说

```text
用 okdata 拿今天的微博热搜和抖音热搜，挑出和护肤最相关的五个话题，
每个写上排名、热度，再用一句话说说它对护肤品牌可能意味着什么。
```

## 花多少钱

`find`、`describe`、`account` 免费（GPT Action 里那几个目录接口也免费）。热搜榜一次：微博 $0.002，抖音 $0.002，上面这句话合计 $0.004，天天问一个月大约 $0.12。搜索类贵一些，[小红书笔记搜索](/zh/apis/xiaohongshu/notes/search/)一页 $0.02。调用失败不扣费。

## 出问题时

- **返回 `unauthorized`（401）。** 桌面版：应用读不到环境变量，处理办法见 [Codex 接入页](/zh/integrations/codex/)。GPT：在 Action 的认证设置里重新填一次 key，确认类型是 **Bearer**。网页版自定义 MCP 服务出现这个错误是意料之中的，原因见上文。
- **返回 `insufficient_balance`（402）。** 余额不够这次调用，没有扣费。充值后再问，价格见[定价页](/zh/pricing/)。
- **返回 `rate_limited`（429）。** 短时间内调用太多。返回里有 `retry_after_seconds`，让 ChatGPT 等这么多秒再发同一个调用，不扣费。
- **看不到工具，或者 Action 里一个操作都没有。** 桌面版：检查 TOML 段名 `[mcp_servers.okdata]`，然后重启应用。GPT：重新导入 schema，看下方的校验报错，最常见的就是上面说的操作数量上限。

## 接着看

- [MCP 服务说明](/zh/mcp/)：四个工具做什么，以及该怎么叮嘱智能体。
- [微博热搜](/zh/apis/weibo/trends/list/)：字段和价格。