LangChain 调 GPT-4.1 报 401？TaoToken 这样修模型通道再跑 ChatBI

1. 401 报错到底卡在哪一步你在 LangChain MCP Client 里跑create_react_agent控制台输入问题后没等到工具调用反而直接抛出openai.AuthenticationError: Error code: 401 - {error: {message: Incorrect API key provided...}}。这个报错跟 MCP Server、跟 chart 的 SSE 地址、跟 covid19-query 的本地服务都没关系它发生在智能体真正发起模型请求之前的那一层——鉴权。LangChain 的create_react_agent(openai:gpt-4.1, tools, ...)底层走的是langchain-openai它会读取环境变量OPENAI_BASE_URL和OPENAI_API_KEY来构造 OpenAI 客户端。只要这两个值有一个不对请求在到达模型之前就被拒了控制台里你看到的就是 401。常见三种情况Key 是随手填的sk-xxxxx占位符没换Base URL 写成了https://api.openai.com/v1但手上没有对应通道的 Key或者 Base URL 多带了/v1后缀导致路径拼接成/v1/v1/chat/completions服务端识别不了。这篇要解决的就是把模型通道修对让 GPT-4.1 的请求不再卡在鉴权然后回到原文main()重跑「确诊前十州折线图」确认 MCP 工具调用链恢复。适合正在用 LangChain MCP 搭 ChatBI、被 401 拦住、想快速定位是 Key 问题还是地址问题的人。整条链路是LangChain Agent → OpenAI 协议通道 → GPT-4.1 → 返回 tool_calls → 调 chart / covid19-query 两个 MCP Server。401 只出在第二环修好它后面可视化图表才能跑起来。2. 修通道前先拿对 Key 和地址TaoToken 在这里的角色很单一它提供一条兼容 OpenAI 协议的模型通道你把它当成OPENAI_BASE_URL的取值来源就行不碰你的 MCP Server也不改你的 Agent 逻辑。原文里 chart 和 covid19-query 两个 SSE 地址保持原样不动我们只替换模型这一层。先打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 注册并登录进控制台创建 API Key。创建入口在 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite Key 列表页在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。生成的 Key 形如sk-开头的一串字符复制下来后面填进OPENAI_API_KEY。地址这块有个高频坑单独拎出来说注意OPENAI_BASE_URL填https://taotoken.net/api不要加/v1也不要带任何 UTM 参数。langchain-openai 会自己在后面拼/chat/completions你多写一层/v1就变成双份路径请求直接 404 或 401。对照一下正确与错误写法配置项正确值常见错误值后果OPENAI_BASE_URLhttps://taotoken.net/apihttps://taotoken.net/api/v1路径重复请求失败OPENAI_BASE_URLhttps://taotoken.net/apihttps://taotoken.net/api?utm_source...参数污染鉴权异常OPENAI_API_KEY控制台新建的 sk- 开头 Keysk-xxxxx 占位符401 Incorrect API key模型名openai:gpt-4.1gpt-4.1缺前缀找不到 provider想先确认通道本身通不通可以到模型对话页 https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 手动发一句话能正常回就说明 Key 和地址没问题再回去改代码。如果你后面要长期跑编码类 Agent可以了解下 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 接入细节看文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。3. 可复制的配置改动原文main()里这两行是问题源头os.environ[OPENAI_BASE_URL] https://api.openai.com/v1 ## 支持openai协议的 API BASE os.environ[OPENAI_API_KEY] sk-xxxxx ## 你的API KEY改成下面这样其余代码一行不动import os # 模型通道TaoToken 兼容 OpenAI 协议 os.environ[OPENAI_BASE_URL] https://taotoken.net/api os.environ[OPENAI_API_KEY] sk-你从控制台新建的Key from langgraph.prebuilt import create_react_agent from langchain_mcp_adapters.client import MultiServerMCPClient from colorama import Fore, Style import asyncio from langgraph.checkpoint.memory import InMemorySaver async def main(): client MultiServerMCPClient( { chart: { url: https://mcp.api-inference.modelscope.net/530c948576c248/sse, transport: sse }, covid19-query: { url: http://127.0.0.1:6030/sse, transport: sse } } ) tools await client.get_tools() checkpointer InMemorySaver() agent create_react_agent( openai:gpt-4.1, tools, checkpointercheckpointer, promptYou are an AI assistant that helps people find information. ) config {configurable: {thread_id: 1}} while True: question input(请输入) if not question: continue if question q: break async for chunk in agent.astream( {messages: [{role: user, content: question}]}, stream_modeupdates, configconfig ): if agent in chunk: content chunk[agent][messages][0].content tool_calls chunk[agent][messages][0].tool_calls if tool_calls: for tool in tool_calls: print(Fore.YELLOW, Style.BRIGHT, f Call MCP Server: {tool[name]} , args: {tool[args]}) else: print(Fore.BLACK, Style.BRIGHT, fLLM: {content}) elif tools in chunk: content chunk[tools][messages][0].content name chunk[tools][messages][0].name print(Fore.GREEN, Style.BRIGHT, f {name} : {content}) if __name__ __main__: asyncio.run(main())两个 SSE 地址原封不动chart 走 ModelScope 的mcp-server-chartcovid19-query 走你本地127.0.0.1:6030/sse。改的只有环境变量两行。如果你用.env管理写法一样注意别在值末尾留空格也别把 Key 用引号包进去后带出多余字符。4. 验证请求与成功结果改完先确认本地 covid19-query MCP Server 已经起来端口 6030 在监听python covid19_query_server.py # 期望输出类似INFO: Uvicorn running on http://127.0.0.1:6030然后跑改好的main()python langchain_mcp_client.py控制台出现请输入后输入原文那条验证问题统计的确诊数量前十名的州以折线图的方式展示成功时你会看到三段输出顺序和颜色对应不同阶段 Call MCP Server: get_table_schema , args: {} get_table_schema : TABLE us_covid19_counties (date varchar COMMENT 日期, county varchar COMMENT 县, ...) Call MCP Server: run_sql , args: {sql: SELECT state, SUM(cases) AS total FROM us_covid19_counties GROUP BY state ORDER BY total DESC LIMIT 10} run_sql : [{state: California, total: ...}, ...] Call MCP Server: generate_line_chart , args: {...} generate_line_chart : https://.../chart.png LLM: 已为你生成确诊人数前十州的折线图图表链接如下...关键判断点只要看到 Call MCP Server出现就说明 401 已经解决模型通道通了Agent 正常拿到了 tool_calls。如果只打印LLM:而没有工具调用那是 prompt 或模型选择问题不是鉴权问题。折线图链接能打开、能看到各州确诊数走势整条 ChatBI 链路就算恢复。想再压一遍换饼图问题「找出确诊人数前五名的州按饼图的方式绘制给我」看generate_pie_chart是否被调用。5. 本篇常见错排查401 依旧出现先确认OPENAI_API_KEY是不是真的替换了sk-xxxxx很多人改了 Base URL 忘了改 Key。再确认 Key 没有多余空格或换行。最后确认 Base URL 是https://taotoken.net/api没带/v1、没带 UTM。报 404 而不是 401基本是 Base URL 多写了/v1路径拼成/api/v1/chat/completions。去掉/v1即可。报 model not foundcreate_react_agent第一个参数必须是openai:gpt-4.1这种带 provider 前缀的写法写成裸gpt-4.1会找不到 provider。工具调用不触发401 修好后如果模型只聊天不调工具检查 prompt 是否明确要求「先获取表结构、再生成 SQL、再画图」原文那段流程提示词别删。chart SSE 连不上这个跟模型通道无关是 ModelScope 的 SSE 地址网络问题确认地址没被改动、本地能访问外网。covid19-query 连不上确认本地 6030 端口服务已启动http://127.0.0.1:6030/sse能通数据库test3里us_covid19_counties表有数据。改了环境变量没生效os.environ必须在 importlangchain_openai之前设置放在文件最顶部。如果放在create_react_agent之后客户端已经用旧值初始化了。排障时如果怀疑是 Key 本身的问题去 API Keys 页 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 重新建一个接入规范看文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。6. 通道修好后继续跑 ChatBI模型通道修对之后原文剩下的封装逻辑不用动FastAPI 那层verify_auth校验的是你自己写的api_key跟模型通道是两回事别混在一起排查。客户端连你的 FastAPI 服务时填的是你自定义的 Key而 FastAPI 内部调 GPT-4.1 用的是 TaoToken 的 Key两层鉴权分开看。回到main()重跑确诊前十州折线图确认get_table_schema → run_sql → generate_line_chart三个工具依次被调用图表链接能打开就说明整条 LangChain MCP ChatBI 可视化链路恢复。后续想换模型或调通道参数在模型对话页 https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 先试通再写进代码能省掉不少来回改环境变量的时间。