1. 为什么要在 Trae 里给智能体接一个 Web Search MCP智能体最尴尬的状态是它一本正经地告诉你一个过时甚至编造的答案。模型本身的知识停在训练截止那一刻你问它今天的新闻、某个库的最新版本号、某家公司刚发布的财报它只能靠猜。要解决这个问题最直接的办法就是给它一个能联网搜索的工具让它自己去查。Model Context ProtocolMCP就是干这个的。你可以把它理解成 AI 和外部工具之间的“标准插座”以前每接一个搜索服务都要为它单独写一套集成逻辑接口格式、鉴权方式、返回结构各不相同有了 MCP工具方按统一协议暴露能力客户端按统一协议调用双方不用再互相迁就。Trae 作为 AI 原生 IDE本身就能充当这个调度中枢把搜索能力挂进来形成“你提问 → 模型判断要不要搜 → 调用搜索 → 拿回结果 → 整理输出”的闭环。这篇要拆的是博查 Web Search MCP 在 Trae 里的完整接入链路。博查是一个面向 AI 应用的搜索引擎返回结果包含网页标题、URL、摘要、站点名、发布时间、图片链接等字段单次最多能返回 50 条支持自然语言查询、指定时间范围、指定站点范围输出的是相对干净、适合模型消化的结构化结果。它适合谁适合正在做 AI Agent、AI 搜索、RAG 应用又不想自己维护爬虫和清洗管线的开发者。我这次的做法和网上多数教程有个区别搜索服务的 endpoint 和鉴权不走博查原生通道而是统一收敛到 TaoToken 的 Key 通道上。这样做的好处是你手上如果有多个模型、多个工具服务不用每个都单独管一套密钥统一在一个地方签发和轮换。下面从 MCP 服务声明、插件注册到首次搜索调用逐段拆开讲配置片段可以直接复制。2. 前置准备TaoToken 统一 Key 与博查 MCP 服务声明在动手改配置之前先把两样东西准备好一个能用的统一 Key以及博查 MCP 服务的连接信息。先说 Key。TaoToken 的控制台里可以创建 API Key这个 Key 后面会同时用于模型调用和工具服务的鉴权。创建入口在控制台的 API Keys 页面登录后新建一个复制出来先存好注意它通常只完整显示一次。如果你还没账号从官网进控制台即可。这里给几个后面会用到的地址方便你对照官网入口https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content控制台建 Keyhttps://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewriteAPI Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewriteAPI 的基础地址是 https://taotoken.net/api注意这个地址后面不加任何查询参数配置里填裸地址就行。再说博查 MCP 服务。博查的 MCP Server 以 SSE 方式暴露原生地址是 https://mcp.bochaai.com/sse鉴权走请求头里的 Authorization: Bearer 你的KEY。在统一 Key 方案下你把 Bearer 后面的值换成 TaoToken 签发的 Keyendpoint 按你实际接入的通道填写。MCP 服务声明本质上就是一段 JSON告诉 Trae有这么个服务地址在哪怎么鉴权。这里有个容易踩的点MCP 的配置是分层的有的客户端读全局配置有的读项目级配置。Trae 里通常是在 MCP 市场或设置面板里粘贴 JSON而不是直接改某个隐藏文件。所以你要做的第一件事是确认你当前操作的是全局还是项目级避免配了半天发现读的是另一个文件。我建议先配项目级验证通过后再决定要不要提到全局。另外提醒一句博查原生通道和统一 Key 通道的 endpoint 不一样别把两套配置混着抄。下面第 3 节给的是统一 Key 版本的完整片段路径和字段名保持原样你替换 Key 就能用。3. 可复制配置MCP 服务声明与 Trae 插件注册参数这一节是全文的核心配置片段请整段复制后只改 Key。先看 MCP 服务声明。在 Trae 的 MCP 配置入口一般是设置里的 MCP 面板或项目根目录下的 MCP 配置文件粘贴下面这段 JSON{ mcpServers: { bocha-web-search: { url: https://mcp.bochaai.com/sse, headers: { Authorization: Bearer 你的TAOTOKEN_API_KEY }, transport: sse, enabled: true } } }字段逐个说明。mcpServers是固定外层键里面每个子对象就是一个 MCP 服务键名bocha-web-search是你自己起的服务标识后面在智能体里引用它时用的就是这个名。url是 SSE 端点transport显式声明为sse有些客户端不写也能识别但写上更稳。headers里放鉴权头把你的TAOTOKEN_API_KEY换成第 2 节创建的那串 Key。enabled控制是否启用调试阶段保持 true。如果你用的是支持 TOML 的客户端等价写法是这样[mcp_servers.bocha-web-search] url https://mcp.bochaai.com/sse transport sse enabled true [mcp_servers.bocha-web-search.headers] Authorization Bearer 你的TAOTOKEN_API_KEY两种格式二选一别同时存在否则可能触发重复注册。接下来是 Trae 侧的插件注册参数。在 Trae 的 MCP 市场或插件面板里添加服务时如果它让你手填字段按下面这张表对照填字段填写值说明服务名称bocha-web-search与 JSON 里的键名保持一致传输方式SSE不要选 stdio服务地址https://mcp.bochaai.com/sse统一 Key 通道下的端点鉴权方式Bearer Token请求头注入Token你的TAOTOKEN_API_KEY控制台签发的那串超时30s搜索类请求建议不低于 20s填完保存Trae 会尝试建立 SSE 长连接。连接成功后服务列表里这个条目应该显示为已连接或绿色状态。如果显示红色或一直转圈先别急着改配置去第 5 节对照报错。这里必须强调三件套的完整性Base URL、Key、Model ID。MCP 服务本身只负责搜索但你的智能体在调用搜索前后还需要模型来决策和整理所以模型侧同样要配好。模型调用的 Base URL 填 https://taotoken.net/apiKey 用同一个 TaoToken KeyModel ID 按你实际选用的模型填。三件套缺一个智能体要么搜不了要么搜完整理不出来。配置写完后建议先别急着建智能体用第 4 节的验证请求确认 MCP 通道本身是通的。很多问题其实出在连接层先隔离验证能省掉大量排查时间。4. 验证请求从连通性测试到首次联网搜索调用配置保存后第一步不是建智能体而是单独验证 MCP 服务能不能通。Trae 的 MCP 面板通常提供一个“测试连接”或“刷新工具列表”的按钮点一下如果服务正常它会拉取到博查暴露的工具清单一般能看到一个搜索类工具参数包含 query、freshness、count、summary 等。如果面板没有测试按钮就用一次最小请求来验证。博查 Web Search 的请求体结构大致如下你可以先在支持直接调用 MCP 工具的调试入口里跑一次{ query: 阿里巴巴2024年ESG报告, freshness: noLimit, summary: true, count: 10 }参数含义query是自然语言查询词freshness控制时间范围noLimit表示不限也可以填具体区间summary为 true 时返回摘要字段count是返回条数最大 50调试阶段建议先给 10减少等待。正常返回的结构里code为 200data.webPages.value是一个数组每个元素包含name标题、url、snippet摘要、siteName站点名、dateLastCrawled抓取时间等字段。看到这些字段说明 MCP 通道和鉴权都没问题。通道验证通过后再建智能体。在 Trae 里新建一个智能体把bocha-web-search这个 MCP 服务挂上去然后写系统提示词。提示词不用太复杂核心是告诉它什么时候该搜、搜完怎么处理你是一个可以调用博查 Web Search 的智能体。当用户的问题涉及实时信息、网页链接、新闻、版本号、财报等需要联网确认的内容时立即调用 bocha-web-search 工具输入相关关键词触发搜索。拿到返回结果后结合用户的具体需求对标题、摘要、链接进行筛选和整合输出清晰、有条理、带来源链接的回答。如果搜索结果不足以回答明确说明而不是编造。挂载完成后直接在对话里问一个需要联网的问题比如“帮我搜一下小猪佩奇相关的图片资源”。观察两件事一是智能体有没有真的触发工具调用面板里一般会显示工具调用记录二是返回结果里有没有带真实链接。如果工具被调用了、链接能点开、内容对得上整条链路就跑通了。实测下来从触发搜索到返回结果通常在几秒内返回的条目经过模型整理后会比原始 JSON 整齐很多。你可以让它按类型分组比如矢量素材、壁纸、商业图库分开列这样可读性更好。5. 常见报错排查401、local proxy failed 与 reading choices接入过程里最容易卡住的就那几个报错逐个说清楚。401 Invalid API KEY / 权限校验失败。这是最高频的。原因通常是三种Key 复制时带了空格或换行Bearer 后面少了个空格或者你用的是博查原生 Key 去连统一通道两边对不上。排查方法把Authorization的值单独拿出来确认格式是Bearer加一串无空格的字符。如果还报 401去控制台重新生成一个 Key 再试排除 Key 本身失效的可能。注意 401 和 403 要区分403 且 message 是余额不足那是账户额度问题不是 Key 格式问题。local proxy failed / 连接超时。这个报错一般出现在 SSE 长连接建立阶段说明 Trae 根本没连上 MCP 端点。先确认url字段没有多余空格transport写的是sse而不是stdio。如果配置都对还是失败检查本机网络是否能正常访问该端点以及是否有本地安全软件拦截了长连接。有些情况下是超时设得太短把超时从默认值调到 30s 再试。这个报错和 Key 无关别在鉴权上浪费时间。reading choices / 返回结构解析失败。这个通常发生在模型侧而不是 MCP 侧。当智能体拿到搜索结果后如果模型返回的格式不符合预期客户端解析choices字段时就会报错。常见诱因是模型 ID 填错或者 Base URL 指向了不兼容的端点。回到三件套检查Base URL 是不是 https://taotoken.net/apiKey 是不是同一个Model ID 是不是你实际开通的。三者一致后这个报错基本消失。OAuth 相关报错。如果你在配置里误开了 OAuth 流程而当前通道走的是 Bearer Token就会冲突。检查配置里有没有多余的oauth字段删掉它只保留headers里的 Authorization。工具列表为空。连接显示成功但拉不到任何工具。这多半是服务端返回了非预期内容或者enabled被设成了 false。先确认enabled为 true再点一次刷新。如果仍为空把配置删掉重新粘贴一遍避免旧配置残留。排查顺序建议固定下来先看连接状态再看鉴权最后看模型侧。连接层的问题占了大半先隔离掉能省很多事。6. 把统一 Key 通道用顺后续扩展与调用入口跑通一次搜索只是起点。统一 Key 通道真正的价值在于你后面接第二个、第三个工具时不用再重复折腾鉴权。比如你之后想再加一个代码检索 MCP、一个数据库查询 MCP只要它们支持 Bearer 鉴权都可以复用同一个 TaoToken Key配置结构也和第 3 节一样只是换个服务名和端点。如果你打算把这条链路用在长期编码或 Agent 场景里可以关注 Coding Plan 这条线它更适合需要持续调用模型和工具的开发流。入口在这里Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite模型对话验证模型是否正常https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite接入文档查参数细节https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewriteAPI Keys补发或轮换 Keyhttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite最后给一个实用习惯每次改完 MCP 配置先跑一次第 4 节的最小请求确认通道通了再进智能体对话。这样一旦出问题你能立刻判断是配置层还是模型层而不是在一堆可能性里瞎猜。搜索类工具最怕的就是“看起来连上了但实际没返回”用一次真实查询把它逼出来比任何状态指示灯都可靠。
1. 为什么要在 Trae 里给智能体接一个 Web Search MCP智能体最尴尬的状态是它一本正经地告诉你一个过时甚至编造的答案。模型本身的知识停在训练截止那一刻你问它今天的新闻、某个库的最新版本号、某家公司刚发布的财报它只能靠猜。要解决这个问题最直接的办法就是给它一个能联网搜索的工具让它自己去查。Model Context ProtocolMCP就是干这个的。你可以把它理解成 AI 和外部工具之间的“标准插座”以前每接一个搜索服务都要为它单独写一套集成逻辑接口格式、鉴权方式、返回结构各不相同有了 MCP工具方按统一协议暴露能力客户端按统一协议调用双方不用再互相迁就。Trae 作为 AI 原生 IDE本身就能充当这个调度中枢把搜索能力挂进来形成“你提问 → 模型判断要不要搜 → 调用搜索 → 拿回结果 → 整理输出”的闭环。这篇要拆的是博查 Web Search MCP 在 Trae 里的完整接入链路。博查是一个面向 AI 应用的搜索引擎返回结果包含网页标题、URL、摘要、站点名、发布时间、图片链接等字段单次最多能返回 50 条支持自然语言查询、指定时间范围、指定站点范围输出的是相对干净、适合模型消化的结构化结果。它适合谁适合正在做 AI Agent、AI 搜索、RAG 应用又不想自己维护爬虫和清洗管线的开发者。我这次的做法和网上多数教程有个区别搜索服务的 endpoint 和鉴权不走博查原生通道而是统一收敛到 TaoToken 的 Key 通道上。这样做的好处是你手上如果有多个模型、多个工具服务不用每个都单独管一套密钥统一在一个地方签发和轮换。下面从 MCP 服务声明、插件注册到首次搜索调用逐段拆开讲配置片段可以直接复制。2. 前置准备TaoToken 统一 Key 与博查 MCP 服务声明在动手改配置之前先把两样东西准备好一个能用的统一 Key以及博查 MCP 服务的连接信息。先说 Key。TaoToken 的控制台里可以创建 API Key这个 Key 后面会同时用于模型调用和工具服务的鉴权。创建入口在控制台的 API Keys 页面登录后新建一个复制出来先存好注意它通常只完整显示一次。如果你还没账号从官网进控制台即可。这里给几个后面会用到的地址方便你对照官网入口https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content控制台建 Keyhttps://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewriteAPI Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewriteAPI 的基础地址是 https://taotoken.net/api注意这个地址后面不加任何查询参数配置里填裸地址就行。再说博查 MCP 服务。博查的 MCP Server 以 SSE 方式暴露原生地址是 https://mcp.bochaai.com/sse鉴权走请求头里的 Authorization: Bearer 你的KEY。在统一 Key 方案下你把 Bearer 后面的值换成 TaoToken 签发的 Keyendpoint 按你实际接入的通道填写。MCP 服务声明本质上就是一段 JSON告诉 Trae有这么个服务地址在哪怎么鉴权。这里有个容易踩的点MCP 的配置是分层的有的客户端读全局配置有的读项目级配置。Trae 里通常是在 MCP 市场或设置面板里粘贴 JSON而不是直接改某个隐藏文件。所以你要做的第一件事是确认你当前操作的是全局还是项目级避免配了半天发现读的是另一个文件。我建议先配项目级验证通过后再决定要不要提到全局。另外提醒一句博查原生通道和统一 Key 通道的 endpoint 不一样别把两套配置混着抄。下面第 3 节给的是统一 Key 版本的完整片段路径和字段名保持原样你替换 Key 就能用。3. 可复制配置MCP 服务声明与 Trae 插件注册参数这一节是全文的核心配置片段请整段复制后只改 Key。先看 MCP 服务声明。在 Trae 的 MCP 配置入口一般是设置里的 MCP 面板或项目根目录下的 MCP 配置文件粘贴下面这段 JSON{ mcpServers: { bocha-web-search: { url: https://mcp.bochaai.com/sse, headers: { Authorization: Bearer 你的TAOTOKEN_API_KEY }, transport: sse, enabled: true } } }字段逐个说明。mcpServers是固定外层键里面每个子对象就是一个 MCP 服务键名bocha-web-search是你自己起的服务标识后面在智能体里引用它时用的就是这个名。url是 SSE 端点transport显式声明为sse有些客户端不写也能识别但写上更稳。headers里放鉴权头把你的TAOTOKEN_API_KEY换成第 2 节创建的那串 Key。enabled控制是否启用调试阶段保持 true。如果你用的是支持 TOML 的客户端等价写法是这样[mcp_servers.bocha-web-search] url https://mcp.bochaai.com/sse transport sse enabled true [mcp_servers.bocha-web-search.headers] Authorization Bearer 你的TAOTOKEN_API_KEY两种格式二选一别同时存在否则可能触发重复注册。接下来是 Trae 侧的插件注册参数。在 Trae 的 MCP 市场或插件面板里添加服务时如果它让你手填字段按下面这张表对照填字段填写值说明服务名称bocha-web-search与 JSON 里的键名保持一致传输方式SSE不要选 stdio服务地址https://mcp.bochaai.com/sse统一 Key 通道下的端点鉴权方式Bearer Token请求头注入Token你的TAOTOKEN_API_KEY控制台签发的那串超时30s搜索类请求建议不低于 20s填完保存Trae 会尝试建立 SSE 长连接。连接成功后服务列表里这个条目应该显示为已连接或绿色状态。如果显示红色或一直转圈先别急着改配置去第 5 节对照报错。这里必须强调三件套的完整性Base URL、Key、Model ID。MCP 服务本身只负责搜索但你的智能体在调用搜索前后还需要模型来决策和整理所以模型侧同样要配好。模型调用的 Base URL 填 https://taotoken.net/apiKey 用同一个 TaoToken KeyModel ID 按你实际选用的模型填。三件套缺一个智能体要么搜不了要么搜完整理不出来。配置写完后建议先别急着建智能体用第 4 节的验证请求确认 MCP 通道本身是通的。很多问题其实出在连接层先隔离验证能省掉大量排查时间。4. 验证请求从连通性测试到首次联网搜索调用配置保存后第一步不是建智能体而是单独验证 MCP 服务能不能通。Trae 的 MCP 面板通常提供一个“测试连接”或“刷新工具列表”的按钮点一下如果服务正常它会拉取到博查暴露的工具清单一般能看到一个搜索类工具参数包含 query、freshness、count、summary 等。如果面板没有测试按钮就用一次最小请求来验证。博查 Web Search 的请求体结构大致如下你可以先在支持直接调用 MCP 工具的调试入口里跑一次{ query: 阿里巴巴2024年ESG报告, freshness: noLimit, summary: true, count: 10 }参数含义query是自然语言查询词freshness控制时间范围noLimit表示不限也可以填具体区间summary为 true 时返回摘要字段count是返回条数最大 50调试阶段建议先给 10减少等待。正常返回的结构里code为 200data.webPages.value是一个数组每个元素包含name标题、url、snippet摘要、siteName站点名、dateLastCrawled抓取时间等字段。看到这些字段说明 MCP 通道和鉴权都没问题。通道验证通过后再建智能体。在 Trae 里新建一个智能体把bocha-web-search这个 MCP 服务挂上去然后写系统提示词。提示词不用太复杂核心是告诉它什么时候该搜、搜完怎么处理你是一个可以调用博查 Web Search 的智能体。当用户的问题涉及实时信息、网页链接、新闻、版本号、财报等需要联网确认的内容时立即调用 bocha-web-search 工具输入相关关键词触发搜索。拿到返回结果后结合用户的具体需求对标题、摘要、链接进行筛选和整合输出清晰、有条理、带来源链接的回答。如果搜索结果不足以回答明确说明而不是编造。挂载完成后直接在对话里问一个需要联网的问题比如“帮我搜一下小猪佩奇相关的图片资源”。观察两件事一是智能体有没有真的触发工具调用面板里一般会显示工具调用记录二是返回结果里有没有带真实链接。如果工具被调用了、链接能点开、内容对得上整条链路就跑通了。实测下来从触发搜索到返回结果通常在几秒内返回的条目经过模型整理后会比原始 JSON 整齐很多。你可以让它按类型分组比如矢量素材、壁纸、商业图库分开列这样可读性更好。5. 常见报错排查401、local proxy failed 与 reading choices接入过程里最容易卡住的就那几个报错逐个说清楚。401 Invalid API KEY / 权限校验失败。这是最高频的。原因通常是三种Key 复制时带了空格或换行Bearer 后面少了个空格或者你用的是博查原生 Key 去连统一通道两边对不上。排查方法把Authorization的值单独拿出来确认格式是Bearer加一串无空格的字符。如果还报 401去控制台重新生成一个 Key 再试排除 Key 本身失效的可能。注意 401 和 403 要区分403 且 message 是余额不足那是账户额度问题不是 Key 格式问题。local proxy failed / 连接超时。这个报错一般出现在 SSE 长连接建立阶段说明 Trae 根本没连上 MCP 端点。先确认url字段没有多余空格transport写的是sse而不是stdio。如果配置都对还是失败检查本机网络是否能正常访问该端点以及是否有本地安全软件拦截了长连接。有些情况下是超时设得太短把超时从默认值调到 30s 再试。这个报错和 Key 无关别在鉴权上浪费时间。reading choices / 返回结构解析失败。这个通常发生在模型侧而不是 MCP 侧。当智能体拿到搜索结果后如果模型返回的格式不符合预期客户端解析choices字段时就会报错。常见诱因是模型 ID 填错或者 Base URL 指向了不兼容的端点。回到三件套检查Base URL 是不是 https://taotoken.net/apiKey 是不是同一个Model ID 是不是你实际开通的。三者一致后这个报错基本消失。OAuth 相关报错。如果你在配置里误开了 OAuth 流程而当前通道走的是 Bearer Token就会冲突。检查配置里有没有多余的oauth字段删掉它只保留headers里的 Authorization。工具列表为空。连接显示成功但拉不到任何工具。这多半是服务端返回了非预期内容或者enabled被设成了 false。先确认enabled为 true再点一次刷新。如果仍为空把配置删掉重新粘贴一遍避免旧配置残留。排查顺序建议固定下来先看连接状态再看鉴权最后看模型侧。连接层的问题占了大半先隔离掉能省很多事。6. 把统一 Key 通道用顺后续扩展与调用入口跑通一次搜索只是起点。统一 Key 通道真正的价值在于你后面接第二个、第三个工具时不用再重复折腾鉴权。比如你之后想再加一个代码检索 MCP、一个数据库查询 MCP只要它们支持 Bearer 鉴权都可以复用同一个 TaoToken Key配置结构也和第 3 节一样只是换个服务名和端点。如果你打算把这条链路用在长期编码或 Agent 场景里可以关注 Coding Plan 这条线它更适合需要持续调用模型和工具的开发流。入口在这里Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite模型对话验证模型是否正常https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite接入文档查参数细节https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewriteAPI Keys补发或轮换 Keyhttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite最后给一个实用习惯每次改完 MCP 配置先跑一次第 4 节的最小请求确认通道通了再进智能体对话。这样一旦出问题你能立刻判断是配置层还是模型层而不是在一堆可能性里瞎猜。搜索类工具最怕的就是“看起来连上了但实际没返回”用一次真实查询把它逼出来比任何状态指示灯都可靠。
