要在自己的AI应用或Agent中接入秘塔AI搜索的MCP服务，必须完成客户端配置、API密钥授权与工具调用三步闭环，缺一不可——跳过任意环节都会导致metaso_web_search等工具调用失败，返回401或空结果。下面将详细介绍每一步的具体操作和注意事项。

获取并配置API密钥

登录秘塔AI正式官网（metaso.cn）→点击右上角头像→进入「API密钥管理」→点击「创建新密钥」→复制生成的密钥字符串。

注意：【YOUR_API_KEY必须是实时生成的新密钥，旧密钥或测试密钥无法调用metaso_web_reader】

将密钥粘贴到你的MCP客户端配置文件中，替换示例里的占位符。配置格式必须严格遵循JSON结构，字段名大小写敏感，url末尾不能多加斜杠。

小提示：如果密钥包含特殊字符（如+、/），建议用双引号包裹整个字符串，避免JSON解析错误。

配置MCP Server连接参数

有两种方式连接秘塔MCP服务器，根据你的应用场景选择其一。

方法一：使用标准HTTP端点

在客户端配置中写入以下server定义：

{
  "mcpServers": {
    "metaso": {
      "url": "https://metaso.cn/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

此方法适用于大多数常规任务，响应速度快，适合简单搜索查询。

方法二：使用SSE协议端点

将url替换为：https://modelscope.cn/mcp/servers/events/metaso-sse，其余字段保持不变。该端点支持Server-Sent Events，适合长任务如深度研究模式下的分块返回。

注意：两个端点不可混用，选其一即可；若同时配置，客户端可能因协议冲突静默失败。

小提示：如果使用SSE端点，请确保客户端支持流式响应，否则可能无法正常接收数据。

验证接入是否成功

完成配置后，按以下步骤验证：

• 第一步：启动你的MCP客户端，确保日志中间出现“Connected to metaso server”字样。
• 第二步：调用metaso_web_search工具，传入最简参数：{ "q": "test" }。
• 第三步：观察返回——成功时会包含至少1条result对象，且每个result有url、title、summary字段；若返回空数组或报错“Unauthorized”，说明API密钥未生效或配置格式错误。

这一步操作起来很简单，直接把最小参数发过去就行，但必须确认返回里有真实网页摘要，不能只看状态码200就认为接入成功。

常见问题：

• Q：返回401错误怎么办？
  A：检查API密钥是否过期或未正确替换占位符；确认Headers中的“Bearer”前缀和空格是否完整。
• Q：返回空数组（[]）？
  A：可能是查询参数格式错误，确保q字段是字符串；或者网络环境限制导致无法访问外部API。
• Q：日志显示“Connected”但工具无响应？
  A：检查客户端是否支持MCP协议版本，建议升级到最新版。

完成以上三步后，即可在自己的AI应用或Agent中成功调用秘塔AI搜索的MCP服务。如果仍然遇到问题，请检查配置中的JSON格式是否严格正确，尤其是大小写和引号。