调试 FastMCP 天气工具卡住把 Codex 的模型通道接入 TaoTokenFastMCP 三行代码就能把get_weather注册成 MCP 工具但真正让新手卡住的往往不是工具本身而是 AI 客户端怎么连上模型。本文从接入配置视角出发把 Codex 的模型通道切到 TaoToken官网https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content让 Codex 对话里能直接调用 FastMCP 暴露的get_weather解决“MCP Server 写好却连不上模型”的痛点。一、原问题与场景FastMCP 跑起来了Codex 却调不到工具很多人的 FastMCP 起步是这样的from fastmcp import FastMCP mcp FastMCP(Weather Service) mcp.tool() def get_weather(city: str) - str: 查询指定城市的天气 return f{city}晴30°C mcp.run()本地python weather_server.py一跑日志显示 server 已启动工具列表里也能看到get_weather。但切到 Codex 客户端输入“帮我查一下上海天气”模型要么答非所问要么直接说没有可用工具。问题不在 FastMCP而在 Codex 的模型通道没有正确指向一个能承载工具调用的后端。Codex 的模型通道由config.toml里的 provider 决定。默认配置指向官方端点一旦网络或额度受限工具调用链路就会断在“模型请求”这一步——MCP Server 明明活着模型却收不到工具描述自然也不会发起call_tool。把 Codex 的 Base URL 换成 TaoToken 的https://taotoken.net/api模型请求先走通FastMCP 的工具才有机会被真正调用。二、TaoToken 前置拿 Key、认端点、分清两套地址在改 Codex 配置之前先把三件事做完。第一创建 API Key。打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册后在控制台生成一个 Key形如YOUR_API_KEY。这个 Key 是 Codex 访问模型的凭证不要写进 FastMCP 的代码里两者职责不同FastMCP 负责暴露工具TaoToken 负责提供模型通道。第二记住两个地址的区别。官网入口是https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content用于注册、看文档、管理 KeyAPI 端点是https://taotoken.net/api只作为 Codex 的 Base URL 使用不要加 UTM 参数。很多新手把带查询参数的官网地址填进config.toml结果请求 404就是没分清这两者。第三确认模型 ID。在模型对话页面或接入文档里能看到当前可用的模型标识Codex 的model字段要填这个 ID而不是随手写gpt-4之类的猜测值。Key、Base URL、Model ID 三者对齐模型通道才算配好。三、可复制配置Codex 的 config.toml 怎么写Codex 的配置集中在config.toml。下面是一份可直接复制的最小配置把占位符替换成你自己的值即可model MODEL_ID model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY wire_api chat配套设置环境变量避免 Key 硬编码进配置文件export TAOTOKEN_API_KEYYOUR_API_KEYWindows PowerShell 用$env:TAOTOKEN_API_KEYYOUR_API_KEY几点说明。base_url必须是https://taotoken.net/api结尾不要多加/v1或斜杠否则容易拼出错误路径。env_key的名字要和实际环境变量一致Codex 启动时会去读它。wire_api按接入文档的说明填写不同客户端版本字段名可能略有差异以文档为准。如果你同时用 Claude Code配置位置不同改的是settings.json里的ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY不要和 Codex 的config.toml混在一起。两套客户端各管各的配置文件这是新手最容易串的地方。四、验证请求与成功结果从模型通道到工具调用配置改完先验证模型通道本身是否通。重启 Codex发一条不带工具的普通消息比如“你好简单介绍一下你自己”。如果模型正常回复说明 Base URL 和 Key 已经生效如果报 401是 Key 问题报 404多半是 Base URL 写错。通道通了之后再验证 FastMCP 工具是否被识别。保持weather_server.py运行在 Codex 里输入“帮我查一下上海天气”。成功的表现是模型先输出一段工具调用意图随后返回类似“上海晴30°C”的结果这个字符串正是get_weather的返回值。此时链路完整——Codex 通过 TaoToken 拿到模型响应模型根据 FastMCP 注册的工具描述发起调用FastMCP 执行函数并把结果回传。如果模型回复“我没有查询天气的工具”说明工具列表没有传到模型侧。检查 FastMCP 是否真的在运行、Codex 是否配置了连接该 MCP Server、以及工具描述是否为空。工具描述为空时模型看不到get_weather的用途自然不会调用。五、本篇常见错排查错误一Base URL 带了 UTM 参数。把https://taotoken.net/?utm_source...填进config.toml请求会打到官网首页而不是 API。正确值是https://taotoken.net/api。错误二Key 写进代码而不是环境变量。有人把YOUR_API_KEY直接写进 FastMCP 脚本结果 Codex 读不到。Key 属于 Codex 的模型通道配置放在环境变量或config.toml引用的变量里。错误三模型 ID 猜着填。model字段必须是接入文档里列出的真实 ID填错会返回模型不存在。去模型对话页面确认当前可用 ID。错误四FastMCP 没启动就测工具。Codex 报“工具不可用”时先确认weather_server.py进程还在。MCP Server 是独立进程关掉终端它就停了。错误五Claude Code 和 Codex 配置混用。Claude Code 改settings.json的ANTHROPIC_*Codex 改config.toml两者不通用。改错文件等于没改。错误六环境变量没生效。export只在当前终端会话有效换一个终端或重启 IDE 就丢了。要持久化就写进 shell 配置文件或在启动脚本里设置。排查顺序建议先确认模型通道普通对话能否回复再确认工具注册工具列表是否可见最后确认调用链路模型是否发起call_tool。逐层定位比一次性改一堆配置高效得多。六、语义一致 CTA接入配置和排障相关的操作集中在 API Keys 和接入文档两处先到 https://taotoken.net/api-keys 生成或管理 Key再对照 https://taotoken.net/doc 里的 Codex 配置说明逐字段核对。模型是否可用、ID 是否正确可以直接在模型对话页面验证。如果你打算长期用 Codex 跑编码和 Agent 任务Coding Plan 更适合持续调用场景避免频繁手动换 Key。把 FastMCP 的工具能力和 TaoToken 的模型通道接上之后get_weather只是起点后面可以继续把数据库查询、内部 API 封装成工具让 Codex 在对话里直接调用。