ChatGPT
通过开发者模式把 TwexAPI 连接到 ChatGPT,用 TwexAPI 账号登录后搜索 X 帖子、用户资料、粉丝和趋势。
ChatGPT 连接 https://api.twexapi.io/mcp 上的 TwexAPI MCP 服务器,并用你的 TwexAPI 账号登录。ChatGPT 无法发送自定义请求头,所以不能使用 API 密钥,每次连接都要经过登录页。调用会消耗你的 TwexAPI 额度。
前提条件
- 开发者模式(Developer mode),它让 ChatGPT 可以连接你自己的 MCP 服务器。OpenAI 只在部分套餐中提供,工作区管理员也可以限制它。如果找不到这个选项,请查看 OpenAI 的开发者模式说明,确认你的账号是否可用。
- 一个有可用 API 密钥和额度的 TwexAPI 账号。在 TwexAPI 控制台 创建密钥。
网页版 ChatGPT
打开开发者模式
打开 Settings,开启 Developer mode。新版本中它在 Security and login 下;旧版本在 Connectors → Advanced settings 下。
添加 TwexAPI
打开 Plugins(或 Apps),点击 +,添加一个自定义 MCP 服务器。名称填 TwexAPI,URL 填 https://api.twexapi.io/mcp。如果 ChatGPT 询问认证方式,选择 OAuth,然后创建。
登录
ChatGPT 会打开 TwexAPI 登录页。登录后,选择是否允许 ChatGPT 替你发推,然后点击 Approve。
在对话中使用
新建对话,从 + 菜单中选择 TwexAPI(或输入 @ 选择),然后描述你的任务。
ChatGPT 桌面应用
打开自定义 MCP 表单
打开应用设置,选择连接自定义 MCP 服务器。
选择 Streamable HTTP
名称填 TwexAPI,把类型从 STDIO 切换为 Streamable HTTP(中文界面为“流式 HTTP”)。URL 填 https://api.twexapi.io/mcp。token、请求头、环境变量等字段全部留空,然后保存。
登录
浏览器会打开 TwexAPI 登录页。点击 Approve 后,浏览器会显示一个 127.0.0.1 开头的页面,提示认证完成。桌面应用就是通过这个本机地址接收授权结果的,关掉这个窗口回到 ChatGPT 即可。
工具
ChatGPT 看到的工具和其他客户端一样:
| 工具 | 作用 |
|---|---|
explore |
为任务找到对应的接口和参数。不消耗额度。 |
twexapi_request |
读取 X 数据:搜索、推文、回复、帖子串、用户资料、粉丝、社区、列表和趋势。 |
twexapi_write |
发推或回复。只有授予写入权限时才会出现,每次调用前 ChatGPT 都会请你确认。 |
发推需要发推账号的 X Cookie,Cookie 会经过你的 ChatGPT 对话。如果想让 ChatGPT 只读,在登录页取消勾选写入权限即可。
详见 MCP 工具参考。
额度
每次调用的费用和对应的 REST 请求相同。额度用完后连接仍然有效,ChatGPT 会提示 “No credits left on this TwexAPI account”。在 控制台 充值后再问一次即可。
常见问题
| 问题 | 解决方法 |
|---|---|
| 找不到开发者模式或添加按钮 | 你的套餐或工作区管理员可能不允许自定义 MCP 服务器,请查看 OpenAI 的说明。 |
| 登录失败或反复跳转 | 在 ChatGPT 中删除 TwexAPI,重新添加并登录。 |
| 登录页提示你没有 API 密钥或没有额度 | 在控制台处理后,10 分钟内回到登录页再点一次 Approve。 |
| 少了某个工具 | 在 ChatGPT 中刷新连接器。如果缺的是 twexapi_write,说明你是以只读方式连接的。 |
| 想断开连接 | 在控制台的 Authorized apps(已授权应用)中撤销 ChatGPT,并在 ChatGPT 中删除连接器。 |
以前的指南建议用 Custom GPT 加 OpenAPI Action。这种方式仍然可以配合 API 密钥调用 REST API,但要使用 MCP 服务器,推荐的方式是开发者模式加登录。