# 在 Cursor 里用 okdata：通过 MCP 拿社媒数据

> 在 Cursor 的 mcp.json 里加上 okdata，Agent 写代码时就能查接口、看价格，并取到 10 个平台的真实数据。

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

配好之后，Cursor 的 Agent 帮你写东西时可以直接用上真实的社媒数据。比如你在做一个内部看板，展示大家在 X 上怎么讨论你的品牌。以前得先编几条假数据，现在 Agent 会先用 `describe` 看清字段，再真取一页，存成 fixture，照着它写类型和组件。每一步收费的调用，执行前你都看得到。

## 准备

- 装好并登录 Cursor。
- 一个 okdata 的 key，以 `okd_` 开头。新 key 自带 $0.10 额度。怎么拿 key 见[快速开始](/zh/docs/quickstart/)。
- 把 key 放进环境变量 `OKDATA_API_KEY`。Mac 上加到 `~/.zshrc`（Linux 是 `~/.bashrc`；Windows 在系统设置里加一个用户环境变量）：

```bash
export OKDATA_API_KEY="okd_..."
```

设好后彻底退出 Cursor 再打开，它才读得到这个变量。

## 添加服务

Cursor 从两个文件读 MCP 服务：用户目录下的 `~/.cursor/mcp.json` 对所有项目生效，项目里的 `.cursor/mcp.json` 只对这个项目生效。任选一个，写入：

```json
{
  "mcpServers": {
    "okdata": {
      "url": "https://api.okdata.online/mcp",
      "headers": { "Authorization": "Bearer ${env:OKDATA_API_KEY}" }
    }
  }
}
```

`${env:OKDATA_API_KEY}` 的意思是连接时由 Cursor 去读环境变量，文件里不出现 key 本身。所以项目里的这份配置可以放心提交，同事各自设好自己的变量就行。文件里已经有别的服务的话，把 `"okdata"` 这一块放进现有的 `mcpServers` 里。

## 确认连上了

打开侧边栏的 **Customize**，应该能看到 `okdata` 已开启，下面有四个工具：`find`、`describe`、`call`、`account`。如果显示报错，看最后一节。

在 Agent 对话里问一句：“我的 okdata 余额还有多少？”报出数字就说明 key 生效了，这一步不花钱。

## 第一句可以这样说

```text
用 okdata：先 describe 一下 X 帖子搜索接口，告诉我单价。
然后搜 "你的品牌名"，只取一页，把原始数据存到 fixtures/x-posts.json，
再根据它写一个单条数据的 TypeScript 类型。
```

Cursor 默认在运行 MCP 工具前征求你的同意。点工具名旁边的箭头，可以先看清这次调用的参数再批准。用熟了以后，可以让免费的 `find`、`describe` 自动执行，`call` 继续保留手动确认。

## 花多少钱

`find`、`describe`、`account` 免费。`call` 按接口单价收费：X 帖子搜索一页 $0.006，上面这句话就花 $0.006。[小红书笔记搜索](/zh/apis/xiaohongshu/notes/search/)一页 $0.02。调用失败不扣费。

Agent 一旦开始自动翻页，钱会一点点累积。最好在提示里写明“只要一页”，或者“最多三页，然后先问我”。

## 出问题时

- **返回 `unauthorized`（401）。** 请求头发出去了，但里面没有 key。多半是设变量时 Cursor 已经开着：彻底退出再打开。也检查一下写法是不是 `${env:OKDATA_API_KEY}`，前面的 `env:` 不能少。
- **返回 `insufficient_balance`（402）。** 余额不够这次调用，没有扣费。充值后再跑一次，价格见[定价页](/zh/pricing/)。
- **返回 `rate_limited`（429）。** 短时间内调用太多。错误里有 `retry_after_seconds`，等这么多秒再发同一个调用，不扣费。
- **服务报错或没有工具。** 检查 JSON 格式（最常见的是漏了逗号），地址要以 `/mcp` 结尾。用浏览器打开这个地址会看到 “Method not allowed”，这是正常的，它只接受 MCP 请求。在 **Customize** 里把服务关掉再打开，可以重新连接。

## 接着看

- [MCP 服务说明](/zh/mcp/)：四个工具做什么，以及该怎么叮嘱 Agent。
- [X 帖子搜索](/zh/apis/x/posts/search/)：查询语法、字段和价格。