---
title: "ChatGPT"
description: "通过开发者模式把 TwexAPI 连接到 ChatGPT，用 TwexAPI 账号登录后搜索 X 帖子、用户资料、粉丝和趋势。"
---

ChatGPT 连接 `https://api.twexapi.io/mcp` 上的 TwexAPI MCP 服务器，并用你的 TwexAPI 账号登录。ChatGPT 无法发送自定义请求头，所以不能使用 API 密钥，每次连接都要经过登录页。调用会消耗你的 TwexAPI 额度。

## 前提条件

- 开发者模式（Developer mode），它让 ChatGPT 可以连接你自己的 MCP 服务器。OpenAI 只在部分套餐中提供，工作区管理员也可以限制它。如果找不到这个选项，请查看 [OpenAI 的开发者模式说明](https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt)，确认你的账号是否可用。
- 一个有可用 API 密钥和额度的 TwexAPI 账号。在 [TwexAPI 控制台](https://twexapi.io/dashboard) 创建密钥。

:::note
  OpenAI 会不定期调整这些设置的位置。如果下面的菜单名称和你看到的不一致，请以 OpenAI 的最新说明为准；服务器地址和登录步骤不变。
:::

## 网页版 ChatGPT

1. **打开开发者模式**

    打开 **Settings**，开启 **Developer mode**。新版本中它在 **Security and login** 下；旧版本在 **Connectors → Advanced settings** 下。

2. **添加 TwexAPI**

    打开 **Plugins**（或 **Apps**），点击 **+**，添加一个自定义 MCP 服务器。名称填 `TwexAPI`，URL 填 `https://api.twexapi.io/mcp`。如果 ChatGPT 询问认证方式，选择 **OAuth**，然后创建。

3. **登录**

    ChatGPT 会打开 TwexAPI 登录页。登录后，选择是否允许 ChatGPT 替你发推，然后点击 **Approve**。

4. **在对话中使用**

    新建对话，从 **+** 菜单中选择 TwexAPI（或输入 `@` 选择），然后描述你的任务。

## ChatGPT 桌面应用

1. **打开自定义 MCP 表单**

    打开应用设置，选择连接自定义 MCP 服务器。

2. **选择 Streamable HTTP**

    名称填 `TwexAPI`，把类型从 **STDIO** 切换为 **Streamable HTTP**（中文界面为"流式 HTTP"）。URL 填 `https://api.twexapi.io/mcp`。token、请求头、环境变量等字段全部留空，然后保存。

3. **登录**

    浏览器会打开 TwexAPI 登录页。点击 **Approve** 后，浏览器会显示一个 `127.0.0.1` 开头的页面，提示认证完成。桌面应用就是通过这个本机地址接收授权结果的，关掉这个窗口回到 ChatGPT 即可。

## 工具

ChatGPT 看到的工具和其他客户端一样：

| 工具 | 作用 |
| --- | --- |
| `explore` | 为任务找到对应的接口和参数。不消耗额度。 |
| `twexapi_request` | 读取 X 数据：搜索、推文、回复、帖子串、用户资料、粉丝、社区、列表和趋势。 |
| `twexapi_write` | 发推或回复。只有授予写入权限时才会出现，每次调用前 ChatGPT 都会请你确认。 |

发推需要发推账号的 X Cookie，Cookie 会经过你的 ChatGPT 对话。如果想让 ChatGPT 只读，在登录页取消勾选写入权限即可。

详见 [MCP 工具参考](/mcp/tools)。

## 额度

每次调用的费用和对应的 REST 请求相同。额度用完后连接仍然有效，ChatGPT 会提示 "No credits left on this TwexAPI account"。在 [控制台](https://twexapi.io/dashboard) 充值后再问一次即可。

## 常见问题

| 问题 | 解决方法 |
| --- | --- |
| 找不到开发者模式或添加按钮 | 你的套餐或工作区管理员可能不允许自定义 MCP 服务器，请查看 OpenAI 的说明。 |
| 登录失败或反复跳转 | 在 ChatGPT 中删除 TwexAPI，重新添加并登录。 |
| 登录页提示你没有 API 密钥或没有额度 | 在控制台处理后，10 分钟内回到登录页再点一次 **Approve**。 |
| 少了某个工具 | 在 ChatGPT 中刷新连接器。如果缺的是 `twexapi_write`，说明你是以只读方式连接的。 |
| 想断开连接 | 在控制台的 **Authorized apps**（已授权应用）中撤销 ChatGPT，并在 ChatGPT 中删除连接器。 |

以前的指南建议用 Custom GPT 加 OpenAPI Action。这种方式仍然可以配合 API 密钥调用 REST API，但要使用 MCP 服务器，推荐的方式是开发者模式加登录。