AI 助手自己看不了 X。问 Claude 或 ChatGPT 某个账号今天早上发了什么,它要么瞎猜,要么说没有权限。MCP 服务器可以解决这个问题:它给助手一组工具,比如“获取某个用户的推文”或“搜索推文”,当你的问题需要实时数据时,助手就调用它们。

本指南通过我们运营的 TwittrAPI 托管 Twitter MCP 服务器(英文),把助手连接到 X 的公开数据。不用安装,也不需要 X 开发者账号。任何 MCP 客户端的步骤思路都一样,区别只在于粘贴 URL 的位置。

你能得到什么

服务器提供 30 个读取公开数据的工具:

类别工具
用户资料get_user_by_username、get_user_by_id、users_by_ids、username_to_id、get_user_about_batch
推文get_tweet、tweets_by_ids、get_tweet_replies、get_tweet_thread、get_user_tweets、get_user_tweets_and_replies、get_user_media、search_tweets
互动get_tweet_quotes、get_tweet_retweets
关系get_followers、get_following、get_verified_followers、get_user_affiliates、get_friendships_batch
列表和社区get_list_details、get_list_members、get_list_tweets、get_community、get_community_about、get_community_tweets、search_communities
趋势和 Spacesget_trends、get_trend_locations、get_space

提供你的 X 会话后,它还能在你自己的账号上发帖、点赞、关注和发私信。这部分有单独的指南:用 Claude 和 ChatGPT 发布 X 帖子。

结果默认以紧凑的简化格式(英文)返回,文本更短,能放进助手的上下文。

第 1 步:获取 API 密钥或账号

在开始使用页面创建账号。新账号获得 US$0.50 测试额度,有效期 7 天。大多数应用通过 OAuth 登录,根本接触不到你的密钥。Cursor 和脚本要在请求头中发送密钥,所以请把它放在环境变量里:

export TWITTRAPI_API_KEY="your-key"

第 2 步:把服务器添加到你的应用

地址始终相同,并且必须以 /mcp 结尾:

https://mcp.twittrapi.com/mcp

Claude.ai 和 Claude Desktop。 打开 Settings > Connectors,选择 Add custom connector,命名为 TwittrAPI,粘贴 URL,点击 Connect。登录后点击 Allow access。

ChatGPT。 在 Settings > Apps & Connectors > Advanced settings 中打开 Developer mode,选择 Create,输入 URL,认证方式选 OAuth。

Claude Code。

claude mcp add --transport http twittrapi https://mcp.twittrapi.com/mcp \
  --header "Authorization: Bearer $TWITTRAPI_API_KEY"

Cursor。 把下面的内容加到 ~/.cursor/mcp.json:

{
  "mcpServers": {
    "twittrapi": {
      "url": "https://mcp.twittrapi.com/mcp",
      "headers": { "X-API-KEY": "${env:TWITTRAPI_API_KEY}" }
    }
  }
}

VS Code(Copilot agent 模式)。 添加 .vscode/mcp.json,写上 "type": "http" 和同一个 URL;服务器启动时 VS Code 会让你登录。托管 MCP 页面(英文)有这个文件以及其他客户端的步骤。

第 3 步:问一个需要实时数据的问题

新开一个对话,问一个只有 X 才能回答的问题。助手会自己选工具,大多数应用会在运行前显示调用:

  • “@nasa 过去 24 小时发了什么?用三个要点总结。”
  • “搜索最近两天提到我产品名称、至少有 20 个赞的推文,按话题分组。”
  • “比较 @openai、@AnthropicAI 和 @GoogleDeepMind 的粉丝数和简介。”
  • “德国现在有哪些热门话题?”

对于较长的任务,先给助手一个上限,例如“只看最新的 40 条推文,不要更多”。它拿到足够数据后就会停止翻页。

第 4 步:留意费用

每次工具调用都是一次计费的 API 调用,从你的余额中按正常价格扣除:Standard 档每 1,000 次调用 US$0.10,用量越大越便宜。一页搜索结果大约返回 20 条推文,所以一个触发五次调用的问题只花不到一美分。风险不在于某一个问题,而在于助手毫无必要地翻遍一个大账号。

两个习惯能让费用保持在低位:

  • 给出数量:“最新的 50 条推文”或“粉丝列表的前两页”。
  • 对无人值守的智能体,单独创建一个有自己预算的 agent 密钥(英文),这样它花的钱不会超过你允许的范围。

服务器还限制每个密钥同时最多 8 个进行中的请求,402 错误表示余额已用完。助手会把这两种情况显示为易读的消息。

第 5 步:用完后断开连接

已连接的应用列在控制台的 Connected apps 下,并显示最后使用时间。Disconnect 会在一分钟内终止某个应用的访问。重新生成 API 密钥会断开所有应用。

什么时候用脚本更合适

MCP 服务器适合提问和一次性的调研。对于每小时运行一次的任务,请改用代码调用 API,这样每次结果一致,也不涉及模型:见 Get an account's tweets with Python(英文)和 Search Twitter/X without a developer account(英文)。想在有新帖子时收到通知,请使用账号监控(英文),不要让助手去检查。

如果你的客户端只支持 stdio,可以用 npm 包在本地运行同样的工具:

npx -y twittrapi-mcp

常见问题排查

  • “404 Not found”或“Couldn't determine how this server signs in”:URL 缺少 /mcp。删除连接器,用完整地址重新添加。
  • 应用提示未授权:连接已断开或密钥已重新生成。删除连接器后重新连接。
  • 助手凭记忆回答而不调用工具:说“使用 TwittrAPI 工具”,或者写明账号和时间范围。有些应用需要在对话中打开连接器。

常见问题

什么是 MCP 服务器?

MCP,即 Model Context Protocol(模型上下文协议),是一个让 AI 应用调用外部工具的开放标准。MCP 服务器提供这些工具。这里的工具用来读取 X 的公开数据。

使用 Twitter MCP 服务器需要 X 开发者账号吗?

不需要。该服务器是第三方服务,有自己的账号和密钥,与 X 无关联。

助手能通过它发推吗?

可以,在你自己的账号上发,前提是你把 X 会话(已登录浏览器的 Cookie 和一个代理)交给服务器。每次发帖前应用都会先问你。设置方法:用 Claude 和 ChatGPT 发布 X 帖子。

一次 MCP 调用多少钱?

一次工具调用就是一次 API 调用,Standard 档每 1,000 次 US$0.10,用量越大越便宜。在控制台查看余额;助手花的钱不会超过余额。

哪些应用可以用?

Claude.ai、Claude Desktop、ChatGPT、Claude Code、Cursor 和 VS Code,以及任何支持 Streamable HTTP 的客户端。

参考来源

TwittrAPI 与 X Corp. 无关联,只读取公开数据。