使用说明

更新时间：2026-03-05

调用 MCP 服务需要先完成身份鉴权，本文档将按照实际的接入流程，依次为您提供鉴权说明、使用方式说明以及其他帮助。

鉴权说明

当前 MCP Server 仅支持 API Key 的鉴权方式，开始前您需要获取一个 API Key ，并为 API Key 配置合适的权限范围。

一、创建API Key

登录后，前往 API Key 管理页，点击「创建 API Key」按钮。

二、配置权限范围

权限配置部分，可选择「全部产品权限」或「自定义权限」。推荐选择「自定义权限」。
产品权限部分，选择「 AI 开放能力」。
勾选您需要的接口。为避免 MCP 使用过程中遇到未授权的问题，建议为 API Key 配置 AI 开放能力下的「全部接口」权限。
点击「确定」按钮，即可创建您的 API Key 。

三、创建短期 API Key（可选）

基于安全性考虑，您也可以选择换取短期 API Key 进行接口调用。可参考创建短期 API Key。

本步骤为可选步骤。如您想快速完成接口调通，可以跳过本步骤。

如果您选择使用短期 API Key ，请注意 API Key 的有效期，避免过期后无法使用。

四、资源获取

大多数 AI 开放能力都为已实名认证的客户提供了免费测试额度，创建 AI 开放能力的 API Key 后即可调用这些额度。

如果您还没有完成实名认证，可前往实名认证。
如果您想查看图像增强与特效的免费额度，可前往资源列表。
如果您的免费额度耗尽，可以前往购买页，购买更多资源。

如果您想了解更多有关API Key的鉴权机制，可参考 API Key 鉴权机制。

使用说明

一、用前须知

建议使用上下文长度在 64k token 以上的大模型。受限于 MCP 协议的实现方式，使用 MCP 协议需要大模型具备较长的上下文长度，短上下文的大模型会直接报错。经过实际测试，64k token 以上的上下文长度可以获得较好的效果。
MCP 依赖大模型的判断能力来选取正确的工具，建议使用效果领先的大模型。
通过 MCP 协议调用的请求总大小建议不超过4MB，否则可能会报错。
在 Cursor、Claude 等客户端配置好 MCP Server 后，通常需要重启客户端以更新 MCP 配置。如您确认 MCP Server 的配置正确但无法正常使用，可尝试重启客户端。
如果能力的输入/输出是多模态的（例如图片、语音文件），需要您使用的 MCP client 支持对应的文件格式。图像增强与特效工具的输出都包含图片，请确认您的 client 是支持 image 类型输出的。可以参考 client 示例了解哪些 client 支持对应格式，或者参考官方开发文档自己实现一个 client 。

二、通过 HTTP SSE 传输方式使用 MCP Server

对于支持 HTTP SSE 传输的 Client (如 Cursor )，建议您使用此方式，无须安装其他前置依赖。

配置

mcp_server_url：替换成要使用的 MCP Server 的URL。
- 图像增强：https://aip.baidubce.com/mcp/image_enhance/sse
- 图像特效：https://aip.baidubce.com/mcp/image_effect/sse
- 获取更多 MCP Server 地址： MCP Server 地址
api_key: 替换成您的 API Key。
- 可于 API Key 管理页查看。
- 注意需要进行URL编码后填入，否则可能会导致连接失败。
尖括号<>在调用时需要删除。

Plain Text

1{
2    "mcpServers": {
3      "mcpserver_1": {
4        "url": "<mcp_server_url>?Authorization=Bearer%20<url encoded api key>"
5      }
6    }
7}

三、通过 stdio 传输方式使用 MCP Server

对于不支持 HTTP SSE 传输的 Client (如 Claude )，可以使用此方式。百度AI开放能力目前尚未提供原生的 stdio 传输方式，可通过第三方工具 supergateway 实现。

安装

安装node.js：请参考 nodejs官网。

配置

mcp_server_url：替换成要使用的 MCP Server 的URL。
- 图像增强：https://aip.baidubce.com/mcp/image_enhance/sse
- 图像特效：https://aip.baidubce.com/mcp/image_effect/sse
- 获取更多 MCP Server 地址： MCP Server 地址
api_key: 替换成您的 API Key。
- 可于 API Key 管理页查看。
尖括号<>在调用时需要删除。

Plain Text

1{
2  "mcpServers": {
3    "mcpserver_1": {
4      "command": "npx",
5      "args": [
6        "-y",
7        "supergateway",
8        "--sse",
9        "<mcp_server_url>",
10        "--header",
11        "Authorization: Bearer <api key>"
12      ]
13    }
14  }
15}

其他帮助

一、实践演示

为了帮助第一次使用 MCP 的开发者快速上手使用，百度智能云还提供常见 Client 使用方式举例，您可以前往查看：

二、联系我们

如果您对于文档内容有任何疑问，可以通过以下方式联系我们：

百度智能云控制台内提交工单；
进入 AI 社区交流；
提交合作咨询。

简介

支持MCP接入的图像增强与特效工具清单