我刚把 Codex Desktop 接到了 SunAI 论坛的 Discourse MCP。接好以后，Codex 就可以直接搜索论坛、读帖子、发回复、创建主题，适合用来整理资料、同步教程、维护论坛内容。
大多数人只需要复制下面的提示词发给自己的 Codex。后半部分是给想手动配置、排错或了解原理的人看的。
快速开始：复制这段提示词
把下面这段提示词复制给你的 Codex Desktop。Codex 会根据你的本机环境自动检查 Node.js、创建 profile、修改配置文件，并提示你重启。
请帮我在 Codex Desktop 里接入 SunAI 论坛的官方 Discourse MCP。
目标：让当前 Codex 可以使用 mcp__discourse 工具访问 https://www.sunai.net。
请按下面要求配置：
1. 使用官方 MCP 包 @discourse/mcp@latest。
2. 不要把 Discourse API Key 写进命令行参数，也不要写进项目仓库。
3. 创建本地 profile JSON 保存站点、认证和写入开关，推荐放在：%APPDATA%\SunAI\discourse-mcp-profile.json。
4. 修改 %USERPROFILE%\.codex\config.toml，新增 [mcp_servers.discourse]。
5. 优先使用本机 PATH 里的 node；如果 npx.cmd 在 Codex MCP 启动时不稳定，就定位 npm 的 npx-cli.js，用 node 去运行它。
6. 配置完成后提醒我重启 Codex Desktop。
7. 重启后用 tool_search 搜索 discourse，确认出现 mcp__discourse 工具。
8. 最后只做一次 discourse_search 只读测试，不要直接执行发帖、改帖、删帖等写操作。
我会提供 SunAI 的 Discourse 用户名和 API Key。如果我还没有 API Key，请停止配置，并提醒我到教程帖下面留言申请。
如果你还没有 SunAI 的 Discourse API Key，请直接在本帖下面留言。管理员确认账号和用途后，可以协助你生成或配置合适权限的 key。
手动配置与排错原理
它做了什么
Codex Desktop 通过 MCP server 调用 Discourse API。这里使用的是官方包：
@discourse/mcp@latest
关键点是：API Key 不放在命令行参数里，而是放进本机 profile 文件。这样任务管理器或进程命令行里看不到 key，也不容易误提交到项目仓库。
检查 Node.js
本机需要有 Node.js：
node -v
如果能输出版本号，就可以继续。若 node 已经在环境变量里，Codex 配置里可以直接写：
command = "node"
创建 profile 文件
推荐把密钥放在本机用户配置目录，不要放项目目录，也不要写进命令行。
建议路径：
%APPDATA%\SunAI\discourse-mcp-profile.json
profile 大致长这样：
{
"site": "https://www.sunai.net",
"read_only": false,
"allow_writes": true,
"auth_pairs": [
{
"username": "你的论坛用户名",
"api_key": "你的 API Key"
}
]
}
只想先让 Codex 读论坛，可以先设成：
{
"site": "https://www.sunai.net",
"read_only": true,
"allow_writes": false,
"auth_pairs": [
{
"username": "你的论坛用户名",
"api_key": "你的 API Key"
}
]
}
等需要发帖、回复、编辑时再打开写权限。
修改 Codex 配置
打开：
%USERPROFILE%\.codex\config.toml
加入：
[mcp_servers.discourse]
command = "node"
args = [
"C:\\path\\to\\npm\\bin\\npx-cli.js",
"-y",
"@discourse/mcp@latest",
"--profile",
"C:\\Users\\你的用户名\\AppData\\Roaming\\SunAI\\discourse-mcp-profile.json"
]
startup_timeout_sec = 120
其中 C:\\path\\to\\npm\\bin\\npx-cli.js 要换成本机真实路径。可以让 Codex 帮你找；如果你用的是 Codex Desktop 自带 Node 运行时，也可以用它自带的 npx-cli.js。
有些环境可以直接这样写：
[mcp_servers.discourse]
command = "npx.cmd"
args = [
"-y",
"@discourse/mcp@latest",
"--profile",
"C:\\Users\\你的用户名\\AppData\\Roaming\\SunAI\\discourse-mcp-profile.json"
]
startup_timeout_sec = 120
但 Windows 下不同启动方式对 .cmd 的处理不完全一致。如果 npx.cmd 方式没有加载出工具，就换回 node + npx-cli.js。
重启并验证
保存配置后，重启 Codex Desktop。
然后问 Codex：
你现在有 discourse MCP 工具了吗？用 tool_search 检查一下。
正常会看到 mcp__discourse 命名空间。再做一次只读测试：
用 discourse_search 搜索 SunAI，max_results 设为 1。
能返回主题结果，就说明 MCP、profile 和认证都通了。
安全建议
- API Key 不要写在
args里。 - profile 不要放进项目仓库。
- 不要把 profile 提交到 Git。
- 不要把高权限 key 发给不可信工具或不可信项目。
- 写权限打开以后，发帖、改帖、创建用户这类操作最好让 Codex 先复述计划，再确认执行。