Twitter MCP 服务器：3 种类型与一行配置

#Twitter MCP 服务器是做什么的

Twitter MCP 服务器是一个小程序，它通过 Model Context Protocol（在新标签页打开）（Claude、Cursor、Codex 和 VS Code 用来调用外部工具的开放标准），把一组操作 X 的工具交给 AI Agent，比如“搜索帖子”或“列出粉丝”。

你用日常语言提问。Agent 选出工具，填好参数并调用；服务器把这次调用变成一个获取 X 数据的请求，把 JSON 交回去，Agent 再据此作答。你永远不用自己写请求，Agent 还可以串联多次调用来完成一项任务，比如先搜索，再对找到的每位作者查询资料。

协议是免费开放的，多数服务器的代码也是。服务器要花多少钱，以及它会对你的 X 账号做什么，取决于它背后的连接：它持有谁的凭据，每次读取由谁计费。这种连接把 Twitter MCP 服务器分成了三类，它的影响比工具列表更大。

#三种 Twitter MCP 服务器

每个 Twitter MCP 服务器都通过三种连接之一访问 X：你自己的 X 开发者应用、你已登录的 X 账号，或者数据 API 密钥。这种连接决定了你要配置什么、一次读取花多少钱，以及你的 Agent 能对你的账号做什么。

只有数据密钥这一类完全不涉及你的 X 账号，而且读取帖子的价格只是官方费率的一小部分：

• 基于数据 API 密钥（Sorsa API 的 sorsa-mcp）

  你要配置什么

  一个 Sorsa API 密钥

  读取 1,000 条帖子

  按 ID $0.014 起，通过搜索 $0.07 起

  Agent 能发帖吗？

  不能，设计上只读

  你的 X 账号

  从不连接

• 基于你的 X 开发者应用（官方 X MCP，以及基于官方 X API 的开源服务器）

  你要配置什么

  带 OAuth 的 X 应用、它的密钥和预付额度

  读取 1,000 条帖子

  $5.00，每条帖子 $0.005

  Agent 能发帖吗？

  取决于服务器和你的应用是否有写权限

  你的 X 账号

  你的应用代表你行事

• 基于你的 X 登录（以你的身份登录的服务器）

  你要配置什么

  你的 X 用户名和密码，或会话 cookie

  读取 1,000 条帖子

  由厂商定价

  Agent 能发帖吗？

  能，以你的身份

  你的 X 账号

  由机器人登录，可能被标记

对读取 X 的 Agent，有六个问题决定了选择：第一次调用之前你要配置什么、一次读取花多少钱、Agent 能不能发帖、你的 X 账号是否牵涉其中、它的响应有多快，以及这些工具占用 Agent 多少上下文。上表解决了前四个；下面的官方 X MCP 和之后的配置一节，会针对每一类回答其余的问题。

#官方 X MCP：它需要什么，又怎么计费

官方 X MCP 需要你自己的 X 开发者应用，并且每次调用都按官方 X API 的按量付费费率计费。X 在 2026 年 6 月 30 日于 api.x.com/mcp 推出了托管服务器（X 的公告（在新标签页打开）），它的 MCP 文档（在新标签页打开）列出了一套可用配置所需要的东西：

• Developer Console 中的一个 X 应用，使用 OAuth 2.0，重定向 URI 为 http://localhost:8080/callback；
• 把应用的 client ID 和 secret 写进你的 Agent 配置，由 xurl 读取，xurl 是通过 npx 运行的本地桥接程序；
• 在浏览器里做一次性登录，并把客户端的启动超时提高到至少 300 秒；
• 把应用切换到 X 的按量付费套餐，否则登录会以 client-not-enrolled 结束。

更简短的路线是发送来自同一个应用的仅应用 Bearer 令牌，X 把它标为只读。无论哪种方式，都要先有开发者账号；我们的无需开发者账号的 Twitter API指南详细介绍了其中涉及的一切。

这个服务器的工具可以读取帖子及其点赞者、转发者和引用者，运行全量存档搜索，查询用户、时间线、提及、新闻和趋势。它的写入只有书签和 Articles；X 的文档没有列出创建帖子的工具。每次读取都按官方 X API 的费率（在新标签页打开）计费：每条帖子 $0.005，每个用户 $0.010，每月最多读取 300 万条帖子，再往上 X 会要求你签 Enterprise 合同。从 2026 年 11 月 22 日起，随帖子一起返回的作者和媒体，X 也会按每个用户 $0.010 计费（X 的通知（在新标签页打开））。我们的 X API 定价分析里有完整价目表。

#一行配置 Sorsa MCP 服务器

对于要在 X 上做研究、监控、线索列表或检查的 Agent，可以添加 Sorsa API 的 MCP 服务器：在 Claude Code 或 Codex 里一条命令，在 Cursor 和 VS Code 里一段 JSON，把你的密钥放进 SORSA_API_KEY，前 100 次工具调用免费。

它用数字回答了那六个问题：一个 API 密钥，推文每 1,000 条 $0.014 起，零个写入工具，没有 X 账号的风险，所有套餐统一每秒 20 次请求，40 个工具定义约占 5,800 个 token。发帖是它有意不做的唯一一项工作；想发帖，就搭配官方 X API，让写入留在你自己的应用上。这个服务器运行在你的电脑上，把每次工具调用变成一次请求，不论这 40 个工具中的哪一个，也不论它返回的是一份资料还是 100 条帖子。

你需要 Node.js 18 或更新版本（用 node -v 检查）以及一个能运行本地 MCP 服务器的应用。Sorsa MCP 服务器页面把每种 Agent 的命令集中在一处。

1. 获取密钥。 用邮箱或 Google 账号注册。控制台会显示你的 API 密钥；前 100 次请求无需绑卡，也永不过期。

2. 把服务器添加到你的 Agent。 用你的密钥替换 YOUR_API_KEY。Claude Code 和 Codex 在终端里一行命令就够了，-s user 会让 Sorsa API 在每个 Claude Code 项目里都可用。Cursor 从 ~/.cursor/mcp.json（对所有项目）或 .cursor/mcp.json（对单个项目）读取一段 JSON；VS Code 读取 .vscode/mcp.json，并且只询问一次密钥，所以密钥不会写在文件里。

   claude mcp add sorsa -s user -e SORSA_API_KEY=YOUR_API_KEY -- npx -y sorsa-mcp
   

   codex mcp add sorsa --env SORSA_API_KEY=YOUR_API_KEY -- npx -y sorsa-mcp
   

   {
     "mcpServers": {
       "sorsa": {
         "command": "npx",
         "args": ["-y", "sorsa-mcp"],
         "env": { "SORSA_API_KEY": "YOUR_API_KEY" }
       }
     }
   }
   

   {
     "inputs": [{ "type": "promptString", "id": "sorsa-key",
       "description": "Sorsa API key", "password": true }],
     "servers": {
       "sorsa": {
         "type": "stdio",
         "command": "npx",
         "args": ["-y", "sorsa-mcp"],
         "env": { "SORSA_API_KEY": "${input:sorsa-key}" }
       }
     }
   }
   

3. 检查是否正常工作。 问你的 Agent“我还剩多少次 Sorsa API 请求？”。它会调用 get_key_usage_info，读取 GET /key-usage-info（在新标签页打开），并且不占用你的请求次数；答案里出现一个数字，就说明 Agent、服务器和密钥已经连通。在 Claude Code 里，claude mcp get sorsa 也应该显示 “Connected”。

4. 问一个真正的问题。 试试“找出本周关于 MCP 服务器的 50 条点赞最多的帖子，并按主题分组”。Agent 会把它变成类似下面这样的 search_tweets 调用，带着每次答案返回的 next_cursor 重复三四次，每次约 20 条帖子，然后根据结果写出总结。

   {
     "name": "search_tweets",
     "arguments": {
       "query": "\"mcp server\" min_faves:20 since:2026-10-26",
       "order": "popular"
     }
   }
   

须知

在 Claude Code 里，服务器名要放在 -e 之前。像 claude mcp add --env SORSA_API_KEY=... sorsa -- npx -y sorsa-mcp 这样的命令会失败，报 "Invalid environment variable format: sorsa"（环境变量格式无效：sorsa），因为 --env 可以接收多个值，会把名字当成又一个值。

-- 之后的一切都属于服务器的命令，所以放在末尾的 -e 根本到不了服务器，它会因为没有密钥而在启动时停止。我们在 Claude Code 2.1.314 里把三种写法都跑了一遍，只有上面那一条能连通。

#其他 MCP 应用的命令

任何运行本地 MCP 服务器的应用，都用同样的三项设置启动 sorsa-mcp：命令 npx，参数 -y sorsa-mcp，以及环境变量里的 SORSA_API_KEY（你的密钥）。Grok Build 和 OpenClaw 从终端添加，Hermes Agent 则从配置文件读取：

grok mcp add sorsa -e SORSA_API_KEY=YOUR_API_KEY -- npx -y sorsa-mcp

openclaw mcp add sorsa --command npx --arg -y --arg sorsa-mcp \
  --env SORSA_API_KEY=YOUR_API_KEY

mcp_servers:
  sorsa:
    command: "npx"
    args: ["-y", "sorsa-mcp"]
    env:
      SORSA_API_KEY: "YOUR_API_KEY"

每一种放在哪里，以及如何确认它已连接：

• Claude Desktop： 把 Cursor 的那段 JSON 粘贴进“Settings, Developer, Edit Config”（设置、开发者、编辑配置）打开的文件，完全退出应用再重新打开；工具在“+”下面。
• Gemini CLI： 把 Cursor 的那段 JSON 粘贴进 ~/.gemini/settings.json，用 /mcp 检查。
• Grok Build： 用 grok mcp doctor sorsa 检查。
• OpenClaw： 用 openclaw mcp doctor sorsa --probe 检查。
• Hermes Agent： 把这段配置加进 ~/.hermes/config.yaml，然后在会话里运行 /reload-mcp。

浏览器里的 Claude.ai、ChatGPT 和 grok.com 只能通过 URL 添加服务器，所以无法在你的电脑上启动服务器：请使用 Claude Desktop 或 Claude Code，密钥相同。能让这个服务器派上用场的现成提示词，在用 AI 构建页面上。

#你的 Agent 能读取什么：40 个工具

Sorsa API 的 MCP 服务器有 40 个工具，每个对应它所覆盖的一个 API 接口，并且每个都读取 X 公开数据。Agent 会根据你的请求按名字选择它们，所以你很少需要知道哪个是哪个；下面是每一组中一次调用会带回什么：

• 搜索，每次调用约 20 条帖子或账号，支持 X 搜索运算符，可回溯到 2006 年：search_tweets、search_users、search_mentions。
• 帖子，每次调用按 ID 最多 100 条帖子，每条都带作者的完整资料：get_tweet_info、get_tweet_info_bulk、get_tweet_comments、get_tweet_quotes、get_retweeters、get_article、get_trends。
• 账号，每次调用最多 100 份资料，或一次 20 条帖子的时间线：get_user_info、get_user_info_batch、get_account_about、get_user_tweets。
• 粉丝，每页最多 200 个：get_followers、get_following、get_verified_followers。
• 检查，每次调用得到一个是或否：check_follow、check_retweet、check_quoted、check_comment、check_community_member。
• 列表、Community 和 Space，成员、动态和 Space 详情：get_list_members、get_list_tweets、get_list_followers、get_community_members、get_community_tweets、search_community_tweets、get_space_info。
• 实用工具，ID 和你剩余的请求次数：username_to_id、id_to_username、link_to_id、get_key_usage_info。

另有七个工具返回加密账号的 Sorsa Score 数据。批量工具是 Agent 省得最多的地方：get_tweet_info_bulk 运行 POST /tweet-info-bulk（在新标签页打开），get_user_info_batch 运行 GET /info-batch（在新标签页打开），一次请求处理 100 项，而 check_follow 一次调用就回答 POST /check-follow（在新标签页打开），不用翻页读完粉丝列表。

没有任何工具能发帖、回复、点赞、关注或发私信，也没有任何工具返回谁点赞了一条帖子、某个用户的点赞或书签、私信或受保护账号：这个服务器只读取公开数据。

#一次工具调用要花多少钱

在 Sorsa API 上，一次工具调用就是一次请求，$0.0014 起，不管它返回多少；官方 X MCP 则对调用里的每一项计费，所以同样搜索 20 条帖子，按每条 $0.005 要 $0.10。

答案越大，差距越大，因为 Sorsa API 用一次请求的价格返回最多 200 项，并且每条帖子的作者不额外收费：

• search_tweets

  返回什么

  约 20 条帖子

  Sorsa API

  $0.0014 起

  官方 X API 费率

  $0.10

  含作者，自 11 月 22 日起

  最高 $0.30

• get_tweet_info_bulk

  返回什么

  100 条帖子

  Sorsa API

  $0.0014 起

  官方 X API 费率

  $0.50

  含作者，自 11 月 22 日起

  最高 $1.50

• get_user_info_batch

  返回什么

  100 份资料

  Sorsa API

  $0.0014 起

  官方 X API 费率

  $1.00

  含作者，自 11 月 22 日起

  $1.00

• get_followers

  返回什么

  200 个粉丝

  Sorsa API

  $0.0014 起

  官方 X API 费率

  $2.00

  含作者，自 11 月 22 日起

  $2.00

放大到一个月的规模，通过 POST /search-tweets（在新标签页打开） 的搜索结果在 Sorsa API 上每 1,000 条 $0.07 起，而按官方 X API 费率是每 1,000 条帖子 $5.00。按 ID 查询每次调用 100 条，每 1,000 条 $0.014 起，通过 GET /followers（在新标签页打开） 获取粉丝列表每 1,000 个 $0.007 起。选一个你的 Agent 一个月的规模：

速度和价格相伴：Sorsa API 在所有套餐（包括免费账号）上都是每秒 20 次请求，通过批量查询最高相当于每秒 2,000 条推文。失败的调用不花钱，因为失败的请求从不收费。

#为什么只读服务器适合 Agent

只读服务器不能发帖、关注，也不能为写入付费，所以一个糊涂或陷入循环的 Agent 最多只会花掉请求次数，绝不会以你的名义在 X 上采取行动。

• 没有写入工具。 没有发帖、回复、点赞、关注或私信工具，服务器背后的 API 也没有这样的接口。要求它调用 post_tweet 时，服务器会回答 "Tool post_tweet not found"（找不到工具 post_tweet）。
• 只有一个目的地。 服务器运行在你的电脑上，它的代码把每次调用都发往 https://api.sorsa.io/v3，你的密钥放在 ApiKey 请求头里。源代码在 GitHub 上（在新标签页打开），采用 MIT 许可证。
• 没有 X 账号。 Sorsa API 从不索要你的 X 登录信息、cookie 或应用。
• 支出有上限。 一个密钥最多每秒 20 次请求，并且在按量付费下，消费上限（默认 $100）限制了每个计费周期。

这些工具对 Agent 的上下文也很轻量。40 个工具定义共约 2.3 万个字符，大约 5,800 个 token，Claude Code 在需要用到某个工具之前只加载它们的名字。结果是带每位作者资料的完整 JSON，所以只请求你需要的（“最新的 50 条帖子”）：单个工具结果超过 1 万个 token 时，Claude Code 会发出警告。

须知

帖子里的文字是数据，不是指令。读取 X 的 Agent 会遇到专门用来操控 AI Agent 的帖子；用只读服务器的话，这种帖子最多让你白白浪费一次请求。让 Agent 的其他工具（比如发邮件或编辑文件）保持在你的批准之后。

#排查无法连接的配置

多数失败的配置都归结为密钥放的位置、缺少 Node.js，或者应用没有重新加载它的服务器。对照你看到的现象：

• Claude Code 里出现 Invalid environment variable format: sorsa

  原因

  服务器名紧跟在 --env 后面

  解决办法

  把名字放在前面：claude mcp add sorsa -s user -e ...

• "Failed to connect"（连接失败），且服务器的环境变量为空

  原因

  -e 放在了 -- 之后，所以被交给了 npx

  解决办法

  把 -e SORSA_API_KEY=... 移到 -- 之前

• npx: command not found

  原因

  没有安装 Node.js

  解决办法

  安装 Node.js 18 或更新版本，然后重启应用

• Missing SORSA_API_KEY environment variable

  原因

  配置里没有密钥

  解决办法

  把 SORSA_API_KEY 加进服务器的环境变量

• 每次调用都返回 401 invalid api key

  原因

  密钥输错了

  解决办法

  从控制台重新粘贴，不要带空格

• 过一阵子调用返回 403

  原因

  你的请求额度用完了

  解决办法

  升级套餐或开启按量付费；同一个密钥继续可用

• 服务器已添加，却不显示任何工具

  原因

  应用没有重新加载

  解决办法

  完全退出 Claude Desktop，在 Hermes 里运行 /reload-mcp，或在 Cursor 里打开 sorsa

• 第一次启动就超时

  原因

  npx 正在下载这个包

  解决办法

  再启动一次，或在 Codex 里设置 startup_timeout_sec = 30

还是不行？让 Agent 调用 get_key_usage_info 并把原始结果给你看：出现数字，说明密钥能连到 Sorsa API，出现错误，则会指出缺了什么。

#今天就让你的 Agent 用上 X 数据

添加 Sorsa API 的 MCP 服务器，你的 Agent 就能通过 40 个只读工具读取 X：在 Claude Code 或 Codex 里一行命令，推文每 1,000 条 $0.014 起，而不是官方 X API 费率下的 $5.00，每秒 20 次请求，整条链路里没有你的任何 X 账号。前 100 次工具调用免费。如果你的 Agent 不通过 MCP 调用 X 数据，而是用纯 REST 或 Agent 技能，请阅读我们的面向 AI Agent 的 Twitter API指南。

#常见问题