代理与 MCP

在 AI 编程代理中使用 TweetAPI 有两种方式：使用托管 MCP 获取最新文档和只读 API 访问；当代理要把 TweetAPI 集成到您的应用中时，则使用常规 SDK 或服务器端代码。

有关公开产品概览、要求和连接流程，请参阅 TweetAPI Twitter API MCP 服务器页面。

托管 MCP

将代理客户端连接到：

https://mcp.tweetapi.com/mcp

托管 MCP 使用仪表板授权。添加 MCP 服务器只会在代理客户端中保存服务器配置。请运行客户端的 MCP 登录/授权命令，在浏览器中打开 TweetAPI，选择用于该连接的 API 密钥，并批准 tweetapi:read。客户端会保存 MCP 令牌，因此应用或计算机重启后连接仍然有效。

实时 MCP 工具为只读，且仅限面向客户开放的公开端点。每次实时工具调用都会转发给现有 TweetAPI API，并消耗正常 API 配额。

快速安装

在 Codex 中运行：

codex mcp add tweetapi --url https://mcp.tweetapi.com/mcp
codex mcp login tweetapi

在 Claude Code 中运行：

claude mcp add --transport http --scope user tweetapi https://mcp.tweetapi.com/mcp
claude mcp login tweetapi

在 Cursor 中，将以下内容添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "tweetapi": {
      "url": "https://mcp.tweetapi.com/mcp"
    }
  }
}

请分别运行 Codex 和 Claude Code 命令。只运行添加/安装命令不会自动打开浏览器。登录/授权命令会打开 TweetAPI，供您登录、选择用于 MCP 连接的 API 密钥并批准访问。Cursor 第一次连接到已保存的远程服务器时会启动 OAuth。

可以完成的操作

搜索最新 TweetAPI 文档。
编写代码前查询端点参数。
在代理聊天中执行实时、只读的 X/Twitter 查询。
使用正常的 TweetAPI 配额和计费。

要求

TweetAPI 账户。
在仪表板批准流程中选择的 TweetAPI API 密钥。
支持远程 HTTP MCP 的 Codex、Claude Code 或其他代理客户端。

在 Codex 中安装

运行：

codex mcp add tweetapi --url https://mcp.tweetapi.com/mcp
codex mcp login tweetapi

请一次运行一条命令。第一条命令添加 MCP 服务器，第二条命令打开 TweetAPI 以批准 MCP 访问。您可以选择现有 API 密钥，也可以在仪表板中创建 MCP 专用密钥。添加服务器并登录后，请重启 Codex 或打开新聊天。在 Codex 中运行 /mcp，或要求模型列出 TweetAPI MCP 工具。

如果您撤销仪表板连接，或删除该连接使用的 API 密钥，请先清除过期的本地客户端会话，再重新连接：

codex mcp logout tweetapi
codex mcp login tweetapi

随后彻底重启 Codex，并开始新聊天。

在 Claude Code 中安装

运行：

claude mcp add --transport http --scope user tweetapi https://mcp.tweetapi.com/mcp
claude mcp login tweetapi

请一次运行一条命令。第一条命令添加 MCP 服务器，第二条命令打开 TweetAPI 仪表板批准提示。不要把包含令牌或 API 密钥的代理配置文件提交到源代码管理。

如果您撤销仪表板连接，请删除 Claude Code 中保存的 TweetAPI MCP 身份验证/会话，然后再次运行 claude mcp login tweetapi。

在 Cursor 中安装

将 TweetAPI 添加到 Cursor 全局 MCP 配置 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "tweetapi": {
      "url": "https://mcp.tweetapi.com/mcp"
    }
  }
}

如果 Cursor 没有立即检测到新服务器，请重启 Cursor。连接时，请在浏览器中完成 TweetAPI OAuth 批准，并选择用于该连接的 API 密钥。

测试连接

安装 MCP 后，开始新聊天并输入：

列出你可以使用的 TweetAPI MCP 工具。然后在 TweetAPI 文档中搜索 search 端点并说明必填参数。
暂时不要调用任何实时 TweetAPI 工具。

要测试实时只读访问，请输入：

使用 TweetAPI MCP 获取用户名 "elonmusk" 的公开个人资料。实时工具调用必须恰好一次，
并说明你使用了哪个工具。

实时工具调用会消耗正常的 TweetAPI 请求配额。

何时使用 MCP

当模型需要在聊天中检查最新 TweetAPI 文档、查询端点参数或进行范围受限的只读 TweetAPI 调用时，请使用托管 MCP。

当模型要修改您的应用时，请使用常规 SDK 或 REST 集成代码。TweetAPI 调用应在服务器端运行，并从服务器环境读取 API 密钥。

安全的代理提示词

使用 TweetAPI 为我的应用添加此功能。从服务器上的 TWEETAPI_API_KEY 读取 TweetAPI 密钥。
不要在源代码中放入 API 密钥、Twitter/X authToken、ct0、代理服务器凭据或私信内容。
选择端点参数前，先使用托管 TweetAPI MCP 文档工具。

Node.js 示例

npm install tweetapi-node

import TweetAPI from "tweetapi-node";

const client = new TweetAPI({ apiKey: process.env.TWEETAPI_API_KEY! });
const result = await client.explore.search({
  query: "tweetapi",
  type: "Latest",
});

Python 示例

pip install tweetapi

import os
from tweetapi import TweetAPI

client = TweetAPI(api_key=os.environ["TWEETAPI_API_KEY"])
result = client.search.search(query="tweetapi", type="Latest")