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

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

准备

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

export OKDATA_API_KEY="okd_..."

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

添加服务

Cursor 从两个文件读 MCP 服务：用户目录下的 ~/.cursor/mcp.json 对所有项目生效，项目里的 .cursor/mcp.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 生效了，这一步不花钱。

第一句可以这样说

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

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

花多少钱

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

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

出问题时

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

接着看

MCP 服务说明：四个工具做什么，以及该怎么叮嘱 Agent。
X 帖子搜索：查询语法、字段和价格。