企业官网建设流程全解析

宝塔面板里把 MCP SSE 服务端跑起来，Nginx 也配了 /sse 反向代理，客户端却提示 SSE 端点连不上，或者连上后一直收不到 event。这类问题多数不是 MCP 服务端代码坏了，而是 Nginx 把 text/event-stream 缓冲住了。为了边查边让 Codex 对照配置，先到 TaoToken 官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_content= 创建一把 API Key，再把 Codex 的 Base URL 填成 https://taotoken.net/api，后面让它帮你逐项核对 location /sse 里的 proxy_buffering、Connection 和超时参数。你真正要改的是宝塔站点里的 Nginx 片段，Codex 只负责读配置、给 diff；Nginx reload 和端口检查仍然由你在本地或面板里完成。下面按“先定位缓冲 → 再改 /sse → 用 Codex 对照 → 验证推送 → 回控制台对账”的顺序走一遍。

1. /sse 连不上时先看 Nginx 有没有把 SSE 流缓冲住

1.1 客户端提示 SSE 端点连不上的两种表现

MCP SSE 模式和普通 HTTP 接口不一样。普通接口是请求进来、处理完、返回响应、连接关闭；SSE 是服务端握着连接不放，隔一段时间往客户端推event:和data:。如果 Nginx 在中间开了默认的响应缓冲，它会把服务端写出的数据先攒在 Nginx 进程里，等缓冲区满或上游关闭后才转给客户端。结果就是客户端侧看到握手已经成功，状态码也可能是 200，但 MCP 初始化消息一直收不到。

第二种表现是能收到第一条消息，随后静默断开。常见日志是SSE connection closed、unexpected end of stream、MCP initialize timeout，或者浏览器 Network 面板里/sse一直显示 pending，却没有新的 event。此时不要先改 MCP 客户端代码，也不要急着重写服务端。先把 Nginx 的/sselocation 单独拎出来看，十有八九是proxy_buffering没关，或者proxy_read_timeout还是默认的 60 秒。

1.2 宝塔默认反代模板最容易漏掉 /sse 的 location

宝塔里给 Node、Python、Go 服务加反向代理时，常见做法是在站点设置里加一条全局代理，或者让面板生成一段location /。这种写法对普通 API 没问题，对 SSE 很容易出问题。因为/代理会把/sse也一起管进去，而面板默认模板通常不会给text/event-stream单独关缓冲。

更稳的做法是在站点的 Nginx 配置里单独写一个location ^~ /sse，优先级高于普通前缀匹配。这样/sse走长连接专用参数，/message、/health之类的普通路径继续走原来的代理规则，互不影响。原文要求在/sse这条反向代理上关掉proxy_buffering，并把proxy_read_timeout拉长到86400s，这个思路就是让 Nginx 别管推送节奏，老老实实当透明通道。

1.3 proxy_read_timeout 只写 60s 为什么不够

MCP SSE 连接不是一直有数据。服务端可能在初始化后等客户端发下一步消息，中间安静几十秒很正常。Nginx 默认proxy_read_timeout是 60 秒，如果 60 秒内上游没有新数据，Nginx 会认为读超时并断开连接。客户端侧就会体现为初始化失败、工具列表加载不出来，或者跑到某个长任务时突然和 MCP 服务端失联。

把proxy_read_timeout写到86400s，本质是给这条长连接留出 24 小时的静默容忍时间。它不是让服务端真的跑 24 小时，而是避免 Nginx 因为“暂时没数据”而主动切断。与之配套的还有proxy_send_timeout，如果客户端上传消息后服务端处理较慢，也可以一起放宽。SSE 排障时，先让连接能活着，再谈消息能不能到。

2. 对照原文改 location /sse：proxy_buffering off 与 86400s

2.1 在宝塔站点配置文件里定位 server 块

进入宝塔面板，打开对应站点，点“设置”里的“配置文件”。你要找的是当前域名的server { ... }块，而不是面板全局的nginx.conf。如果站点里已经有一条location /代理，先不要删，它可能还在服务其他路径。我们只新增或替换/sse这一段，避免把整站代理搞坏。

定位时重点看三件事：proxy_pass指向的 MCP SSE 服务端端口是不是对的；原来的location /有没有把/sse提前截走；有没有在http或server级别开了proxy_buffering on。如果server级别写了全局缓冲，location /sse里再写off也可以覆盖，但最好确认层级关系，别让宝塔的默认模板在后面又加回来。

2.2 /sse 反向代理的可复制写法

下面这段可以直接作为基础模板，把proxy_pass的端口换成你的 MCP SSE 服务端实际监听端口。如果服务端本身挂在子路径，比如/mcp/sse，location和proxy_pass的路径要一起调整，不要只改一半。

location ^~ /sse { proxy_pass http://127.0.0.1:8000; proxy_http_version 1.1; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header Connection "keep-alive"; proxy_buffering off; proxy_cache off; gzip off; proxy_read_timeout 86400s; proxy_send_timeout 86400s; chunked_transfer_encoding on; }

这里几个参数的作用要分清楚。proxy_buffering off是核心，它让 Nginx 不要攒响应。proxy_http_version 1.1和Connection keep-alive是为了让长连接行为更可控，避免 HTTP/1.0 默认短连接把流掐掉。proxy_read_timeout 86400s给静默期留余量。gzip off是为了防止压缩层再次缓冲小包，SSE 本身数据量不大，不需要在这里省带宽。

2.3 Connection keep-alive、chunked 与 gzip 的处理

有些 Nginx 教程会写proxy_set_header Connection "";，有些写Connection keep-alive。两者思路接近：都是不希望客户端带进来的Connection: close被原样传给上游。你可以先按上面模板用keep-alive，如果上游明确要求清空连接头，再改成空字符串。关键是保持proxy_http_version 1.1，否则长连接参数可能不起作用。

chunked_transfer_encoding on不用过度纠结，Nginx 默认通常就是开的。写出来是为了提醒自己，SSE 响应是分块推送，不要在后面加proxy_set_header Accept-Encoding ""之类的奇怪覆盖。至于gzip，如果站点为了网页性能在server级别开了gzip on，/sse这里最好显式关掉，避免代理层或客户端解压逻辑影响事件到达节奏。

3. 在 Codex 里接入 TaoToken，让模型帮你核对 Nginx 片段

3.1 先去 TaoToken 官网创建 Key 并确认模型 ID

打开 TaoToken，注册登录后进入控制台创建 API Key。Key 不要写死在文章或脚本里，统一用YOUR_API_KEY占位。接着在模型广场确认你要给 Codex 用的模型 ID，因为不同账号、不同时间可见的模型列表可能不一样，不能拿网上随便看到的 ID 直接填。

这一步只需要做两件事：拿到YOUR_API_KEY，记下当前可用的YOUR_MODEL_ID。如果你同时要排 MCP SSE 问题，建议单独建一把 Key，方便后面在控制台看调用记录。创建页面、模型广场和用量入口都在同一个控制台里，不用在多个站点之间来回找。

3.2 ~/.codex/config.toml 里把 Base URL 指到 https://taotoken.net/api

Codex 的配置放在~/.codex/config.toml。下面是一份最小可用示例，base_url填 TaoToken 的兼容通道地址，注意末尾不要加/v1。Key 通过环境变量注入，不要明文写进配置文件。

model_provider = "taotoken" model = "YOUR_MODEL_ID" [model_providers.taotoken] name = "TaoToken" base_url = "https://taotoken.net/api" env_key = "TAOTOKEN_API_KEY" wire_api = "chat"

然后在终端里设置环境变量并启动：

export TAOTOKEN_API_KEY=YOUR_API_KEY codex

如果之前按 Claude Code 的教程给 Codex 配过ANTHROPIC_*变量，先把它们去掉。Codex 读的是自己的config.toml和env_key，不要混用两套变量。模型 ID 以模型广场当时列表为准，YOUR_MODEL_ID要替换成实际值。配置完成后，Codex 只是走 TaoToken 这条模型通道，它不会因此获得你服务器的 SSH 权限。

3.3 把 nginx -T 输出贴给 Codex 的问法

真正的 Nginx 检查交给 Codex 做“对照”，不是让它直接连你的服务器。你在本地或宝塔 SSH 里执行nginx -T，把和/sse相关的片段、MCP 客户端报错、服务端监听端口一起复制到对话里。下面这段提示词可以直接改一改用：

下面是我宝塔站点里 Nginx 的 location /sse 片段和 MCP 客户端报错。请只做三件事： 1. 对照 MCP SSE 反代要求，逐项检查 proxy_buffering、proxy_http_version、Connection、proxy_read_timeout、gzip； 2. 指出最可能让客户端收不到 event 的参数； 3. 给一份可以直接替换的 location /sse diff。 不要假设你能连我的服务器，也不要让我在生产机上直接执行未审核命令。

Codex 返回 diff 后，仍然由你复制到宝塔配置文件里，再由你执行nginx -t和 reload。这样既利用了模型对配置的解读能力，又不越过“AI 只生成和解释、人来执行”的边界。如果 Codex 建议加proxy_buffering off，而你的原配置里已经写了on，优先按它的 diff 覆盖，再去查有没有更高层级的配置把值改回去。

4. 宝塔重载 Nginx 后，如何验证 /sse 真的能持续推送

4.1 nginx -t 与 reload 的顺序

改完配置先别急着重启整个 Nginx。SSH 里执行nginx -t，确认语法通过。宝塔面板里也有“重载配置”或“重启”按钮，但重启会短暂影响其他站点，能重载就优先重载。确认无误后再执行 reload，让新的/sselocation 生效。

如果nginx -t报错，通常是少了大括号、分号，或者proxy_pass后面多了路径。宝塔的配置文件编辑器会高亮行号，照着报错行检查。不要把报错贴给 Codex 后就让它“帮你执行修复”，它只能告诉你哪一行可能有问题；实际保存和 reload 仍然要在面板或 SSH 完成。

4.2 本地 curl 看 text/event-stream 是否持续输出

重载之后，先用 curl 直接测上游，绕过 Nginx：

curl -N -H "Accept: text/event-stream" http://127.0.0.1:8000/sse

如果这里能看到持续的event:和data:，说明 MCP 服务端本身没问题。再测 Nginx 入口：

curl -N -H "Accept: text/event-stream" https://你的域名/sse

正常情况下，第二条命令也应该持续输出事件，而不是立刻回到 shell。如果第一条有输出、第二条没输出，问题基本锁定在 Nginx 反代层；如果第一条也没输出，先回去看 MCP SSE 服务端是否真的监听在 8000，以及它的 SSE 路径是不是/sse。

4.3 MCP 客户端仍报错时的排查顺序

客户端仍报错时，按状态码分。502 Bad Gateway多半是proxy_pass端口不对，或者服务端没启动。504 Gateway Time-out说明请求到了 Nginx，但上游长时间没响应，优先检查proxy_read_timeout有没有真的落在/sse这个 location 里。200但没有任何 event，优先怀疑proxy_buffering、gzip或 CDN 层缓冲。

还要注意，MCP 客户端里填的是你的 MCP SSE 服务端地址，比如https://你的域名/sse，不是 TaoToken 的 Base URL。TaoToken 只出现在 Codex 的模型通道配置里，解决的是 Codex 用哪个模型、走哪个 API 入口；它不负责替你托管 MCP SSE 服务端。两件事不要混在一个配置里。若你前面忘了模型 ID 或 Key，可以回 TaoToken 官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_content= 重新确认，但不要把它填到 MCP 客户端的 SSE URL 里。

5. 改完 /sse 之后，去控制台对一次 Codex 调用

5.1 模型对话里发一条消息确认通道

Nginx reload 后，如果 Codex 已经能正常回话，建议去 TaoToken 模型对话 用同一把 Key 发一条测试消息。这一步不是用来测 SSE，而是确认YOUR_MODEL_ID和https://taotoken.net/api没填错。如果模型对话正常、Codex 也正常，说明模型通道和 Nginx 排障是两条独立链路，都通了。

如果 Codex 报鉴权错误，先检查TAOTOKEN_API_KEY环境变量有没有在启动 Codex 的同一个终端里生效；如果报模型不存在，回模型广场重新复制模型 ID。不要靠猜模型名，也不要在config.toml里写网上抄来的日期后缀模型。

5.2 Key 不够用或要长期写配置时的下一步

准备长期让 Codex 帮忙读 MCP 配置、Nginx diff 和报错日志，可以看 Coding Plan 是否够用。Key 不够用或想按项目分 Key，去 控制台 API Keys 新建。Claude Code 那边如果也要对照 SSE 配置，参数见 Claude Code 接入文档。把/sse修到能持续吐 event 之后，再让 Codex 读一遍你的 Nginx diff，确认proxy_buffering off和86400s没有被宝塔模板覆盖。