企业官网建设流程全解析

1. 为什么 MCP 配好了 Codex 还是没反应

你按教程把 MySQL 的 MCP 工具写完了，application-dev.yml里填了只读账号，mvn clean package也顺利打出 jar，config.toml里[mcp_servers.mysql_schema]那段也加上了，结果重启 Codex 一问“帮我看看 user 表结构”，它要么装死，要么回你一句“我无法访问数据库”。这时候绝大多数人的第一反应是回去翻 MCP 工具的代码，怀疑 jar 路径写错、怀疑 Java 版本不对、怀疑只读账号权限不够——但真正的坑往往不在 MCP 这一层，而在 Codex 的模型通道根本没通。

MCP（Model Context Protocol）本质上是给模型挂“外挂工具”的协议，它负责把数据库的表结构、字段、索引这些信息喂给模型。但模型本身得先能正常对话，才有机会去调用这个工具。如果 Codex 的 Base URL 指向的通道不通、Key 没配、或者请求压根发不出去，那 MCP 工具就算写得再完美，也只是个躺在硬盘上的 jar 包，永远不会被触发。所以排障顺序应该是：先确认模型通道能通，再确认 MCP 工具被加载，最后才去查工具本身的逻辑。

这篇就按这个顺序来，重点讲怎么用 TaoToken 把 Codex 的 Base URL 改对，让mcp_servers.mysql_schema真正返回库表结构。适合已经写完 MCP 工具、但提问没反应的开发者，也适合任何在 Codex 里接自定义工具却卡在“没反应”这一步的人。

2. 先分清官网和 API：TaoToken 前置准备

在动 Codex 配置之前，得先把 TaoToken 这边的准备工作做对。这里有个特别容易搞混的点：官网地址和 API 地址是两个不同的东西，用途完全不一样。

官网地址是https://taotoken.net/?utm_source=taotoken_aicg_blog_end，它的作用是注册账号、创建 Key、看文档、管理额度。你拿 Key 就在这个站上操作。而 API 地址是https://taotoken.net/api，它是真正要填进 Codex 配置里的 Base URL，Codex 发请求时打的就是这个地址。很多人排障排半天，就是因为把官网地址填进了config.toml，或者把 API 地址拿去浏览器里注册，结果两边都不对。

具体操作是这样：打开官网，注册登录后进控制台，在 API Keys 页面创建一个新的 Key。这个 Key 是一串以sk-开头的字符串，创建完立刻复制保存，因为页面刷新后可能就不再完整显示了。创建 Key 的入口在控制台的 API Keys 页面，文档入口在 doc 页面，这两个地方后面排障还会用到。

注意：Key 只用于身份认证，不要把它写进任何会提交到 Git 仓库的文件里。Codex 的config.toml是本机文件，问题不大，但如果你把配置同步到云端或者分享给别人，记得先把 Key 抹掉。

TaoToken 在这里的角色是统一接入的兼容通道。Codex 本身支持自定义 Base URL，你把地址指向 TaoToken 的 API，Codex 就会走这条通道去请求模型。通道通了，模型才能正常回话，才有机会去调用你挂的 MySQL MCP 工具。所以这一步不是“可选项”，而是让整个链路活起来的前提。

3. 可复制配置：改 Codex 的 config.toml

准备工作做完，接下来就是改 Codex 的配置文件。你的 Codex 配置在C:\Users\Administrator\.codex\config.toml，这个路径是 Windows 下的默认位置，如果你用的是别的用户名，把Administrator换成你自己的就行。

先看 MCP 那一段，也就是你之前加进去的：

[mcp_servers.mysql_schema] command = "java" args = ["-jar", 'D:\work\java\mysql-schema-mcp\target\mysql-schema-mcp-test-0.1.0.jar']

这段本身没问题，command是java，args里第一个是-jar，第二个是 jar 的绝对路径。注意路径里的反斜杠在 TOML 里要么用双反斜杠\\，要么像上面这样用单引号包起来，否则可能被转义。jar 名字里的test是你打包时的 classifier，mvn clean package打出来的三份 jar 里选对那个可执行的就行。

真正要加的是模型通道的配置。在同一个config.toml里，加上或修改这几项：

model_provider = "taotoken" model = "gpt-4o" [model_providers.taotoken] name = "TaoToken" base_url = "https://taotoken.net/api" env_key = "TAOTOKEN_API_KEY"

这里base_url填的就是 API 地址https://taotoken.net/api，不是官网地址。env_key指定了一个环境变量名，Codex 会从这个环境变量里读 Key。所以你还需要在系统里设置这个环境变量：

setx TAOTOKEN_API_KEY "sk-你的Key"

在 PowerShell 里执行完setx后，要重新开一个终端窗口，环境变量才会生效。如果你不想用环境变量，也可以直接在配置里写api_key = "sk-你的Key"，但这样 Key 就明文躺在配置文件里了，自己权衡。

配置改完，保存config.toml，然后完全退出 Codex 再重新启动。注意是“完全退出”，不是关掉窗口再点开，任务栏里如果有残留进程也要结束掉，否则配置不会重新加载。

4. 验证请求：确认通道通了再问数据库

重启 Codex 之后，先别急着问数据库的问题。第一步是确认模型通道本身是通的。你可以先问一个跟数据库无关的简单问题，比如“你好，帮我写一个 Python 的 hello world”。如果 Codex 能正常回复，说明 Base URL 和 Key 都配对了，通道没问题。

如果这一步就没反应，那问题 100% 在通道上，跟 MCP 工具无关。这时候回去检查三件事：base_url是不是https://taotoken.net/api、环境变量TAOTOKEN_API_KEY有没有生效、Key 有没有过期或额度用完。可以在终端里echo $env:TAOTOKEN_API_KEY看看变量是不是空的。

通道确认通了之后，再问数据库相关的问题，比如“帮我列出当前数据库里所有的表”或者“user 表有哪些字段”。这时候 Codex 应该会去调用mysql_schema这个 MCP 工具，工具启动 Java 进程、连上 MySQL、把表结构读出来返回给模型，模型再整理成回答给你。

实测下来，如果 MCP 工具被正确加载，你会在 Codex 的输出里看到它调用工具的痕迹，比如显示正在执行mysql_schema之类的提示。如果通道通了但问数据库还是没反应，那才轮到去查 MCP 工具本身：jar 路径对不对、Java 在不在 PATH 里、application-dev.yml里的数据库连接信息对不对、只读账号有没有权限读information_schema。

提示：application-dev.yml里的数据库地址建议用127.0.0.1而不是localhost，某些环境下localhost会走 IPv6 导致连接失败。只读账号记得只给SELECT权限，别图省事用 root。

5. 本篇常见错排查

排障过程中有几个错误特别高频，这里集中列一下，对照着查能省不少时间。

第一个是 Base URL 填错。把官网地址https://taotoken.net/?utm_source=taotoken_aicg_blog_end填进了config.toml，这是最常见的。记住官网是给人看的，API 地址https://taotoken.net/api才是给 Codex 用的。两者差一个/api路径和一堆查询参数，填错了请求直接 404。

第二个是环境变量没生效。setx设置完必须重开终端，Codex 如果是从旧终端启动的，读到的还是旧环境。可以先把 Codex 完全退出，再开新终端启动。

第三个是 MCP 工具路径问题。args里的 jar 路径如果包含空格，要用引号包起来。Windows 下路径分隔符用\\或单引号。另外确认java命令在 PATH 里，可以在终端跑java -version验证。

第四个是数据库连接问题。application-dev.yml里的账号密码、库名、端口都要对。只读账号如果连information_schema都读不了，工具拿不到表结构，模型自然没东西可返回。可以先手动用这个账号连一下数据库，跑一句SHOW TABLES;看看能不能出结果。

第五个是 Codex 没重新加载配置。改完config.toml必须完全重启 Codex，光刷新或者重开对话窗口不够。任务管理器里确认没有残留的 Codex 进程。

第六个是 Key 的问题。Key 复制时前后带了空格、Key 被禁用、额度用完，都会导致通道不通。在控制台的 API Keys 页面确认 Key 状态是 active。

6. 通道通了，MCP 才有意义

回到最开始那个问题：MCP 工具配置完没反应，先别改工具本身。把 Codex 的 Base URL 改成https://taotoken.net/api，用官网https://taotoken.net/?utm_source=taotoken_aicg_blog_end创建的 Key 配上，重启 Codex，先验证模型能正常对话，再去问数据库。这个顺序能帮你把“通道问题”和“工具问题”分开，排障效率高很多。

如果你还在接入阶段，Key 和 Base URL 的配置可以参考接入文档；想先验证模型通道是否正常，可以直接在模型对话里试几个简单问题；如果是要长期在 Codex 里跑编码和 Agent 任务，Coding Plan 那条线更适合持续用。通道是地基，MCP 是地基上的工具，地基没打好，工具再精致也转不起来。