Skip to main content
MCP

常见问题

您可以查阅有关 MCP 协议和 MCP 服务的常见问题。

MCP 协议

  1. MCP 协议是如何实现的？ MCP 是 Anthropic 提出的开源标准协议。详细实现请参考 MCP 官网。

云部署 MCP 服务

  1. Firecrawl/EverArt MCP Server 报错：请求用量受限/余额不足？ 请填入服务商 API-Key，并确保其免费额度或账户余额充足。
  2. 为什么我的 Notion/Github MCP Server 运行出错，提示没有足够的权限？ 请为您的 API-Key 授予足够的权限。具体操作请参考对应 MCP 服务的文档。

自定义 MCP 服务

  1. 所有 MCP 服务都可以正常部署使用吗？ 不保证。MCP 服务商可能修改或关闭服务，阿里云百炼仅提供获取渠道，不保证其一直可用。
  2. 自定义 MCP 服务部署失败了，应该怎么排查？ 请确认：
    1. MCP 服务本地可正常运行。
    2. MCP 服务可云端托管（无需浏览器/本地应用通信）。
    3. 部署时安装方式及配置代码正确。
    4. 已开通函数计算 FC 及相关权限，主账号未欠费。
  3. 我能否部署自己开发的 MCP 服务？
    • Node.js： 软件包发布到公共 npm 仓库，通过 npx <package-name> 部署。
    • Python： 软件包发布到 PyPI 仓库，通过 uvx <package-name> 部署。
    • 已部署在远程服务器： 通过 SSE 连接。
    详见自定义 MCP 服务。
  4. 阿里云百炼 MCP 服务能在其他 MCP 客户端（Cline、Cherry Studio）中使用吗？ 支持。MCP 既支持在平台内部（如智能体、工作流）进行配置，也支持通过外部调用集成至第三方应用（Cherry Studio、Cursor），详见外部调用。
  5. 阿里云百炼 MCP 服务能访问本地数据库吗？ 暂不支持。目前不能访问用户本地资源。
  6. 为什么我的 MCP 服务无法访问远程资源（例如云数据库）？ 因为 MCP 服务托管在函数计算 FC，无固定出口公网 IP。请为远程资源（如云数据库）配置函数计算 FC 的 IP 白名单或进行 VPC 网络打通。
  7. 我的 MCP Server 保存在私有 npm 仓库中，可以部署到阿里云百炼吗？ 暂不支持。请发布到公共 npm 仓库，或改用 SSE 连接方式。
  8. 我自己编写的 MCP Server，部署后会被别人使用吗？ 不会。仅限您的阿里云主账号及授权 RAM 用户访问。
  9. 为什么有些 MCP 服务无法在阿里云百炼上自定义部署？ 因为它们需要访问本地资源（如文件、硬件），云端环境无法访问。建议此类服务在本地部署。
  10. 我的 MCP Server 版本更新了，部署在阿里云百炼的自定义 MCP 服务也会更新吗？ 不会。通过 npx/uvx 部署的服务，版本更新后需手动重新部署。

自定义 MCP 服务错误码及排查方案

错误码问题及可能原因排查方案
11200044 - MCP_CONNECTION_REFUSED客户端无法与目标服务建立连接，连接被拒绝。可能原因：服务未启动；端口未开放或防火墙拦截；网络不可达或地址配置错误。执行 curl <服务地址> 测试连通性；查看下游服务日志确认 MCP 服务是否已启动；检查网关或防火墙配置是否有 IP 白名单等连接拒绝配置。
11200045 - MCP_CONNECTION_TIMEOUT连接建立超时。可能原因：网络延迟或丢包；服务端负载较高、响应慢；路由或网络不稳定；经代理访问时链路较长。建议先重试 2~3 次：如果偶尔可以正常访问，则是网络问题；如果持续出现问题，需要检查下游服务链路上的网关或防火墙配置。
11200046 - MCP_REQUEST_TIMEOUT连接已建立，但等待响应超时。可能原因：服务端处理耗时较长或资源不足；网络带宽或延迟导致响应慢。建议先重试 2~3 次。若仍失败：拆分业务减少单次请求耗时或对业务进行异步化；npx/uvx 部署可在函数计算 FC 控制台开启日志服务查看错误详情，可切换为极速模式减少冷启动耗时。
11200047 - MCP_NETWORK_ERROR网络可达性、域名解析或连接中断相关的异常。可能原因：域名无法解析或解析异常；连接在中途被对端或中间设备关闭；目标主机不可达或路由异常。建议先重试 2~3 次。若仍失败：执行 nslookup 确认域名解析正常，异常时更换 DNS 后重试；检查配置中的 url 字段，执行 curl <url> 测试服务是否响应。
11200048 - MCP_SSL_ERRORTLS/SSL 握手或证书校验失败。可能原因：证书过期、域名与证书不匹配或证书链不完整；本机不信任服务端证书（如自签名证书）；TLS 版本或加密套件不兼容；代理或网关改写了证书。在浏览器中打开服务地址查看证书是否过期或域名不匹配；使用自签名证书时按要求完成信任配置；关闭代理直连测试排查证书是否被代理改写。
11200049 - MCP_SERVER_HTTP_UNAUTHORIZEDHTTP 401，请求未携带有效认证或认证已失效。可能原因：未提供或未正确传递鉴权信息（如 Token、API Key）；Token 已过期、被撤销或格式错误；服务端要求特定请求头或 Cookie 未满足。查看下游 MCP 服务文档了解鉴权方式；在 MCP 服务中正确添加鉴权信息（如 Headers 中的 Authorization）；使用 curl 工具测试直连下游服务确保配置正确。
11200050 - MCP_SERVER_HTTP_FORBIDDENHTTP 403，已认证但无权限访问。可能原因：当前账号或角色不具备该 MCP 或实例的访问权限；存在 IP 或来源限制。查看下游 MCP 服务文档了解鉴权方式；使用 curl 工具测试直连下游服务确保配置正确。
11200051 - MCP_HTTP_RATE_LIMITHTTP 429，请求频率超过限流阈值。可能原因：短时间内请求次数过多；当前账号或实例的配额已用尽。降低调用频率；若响应中带有 Retry-After，按建议间隔重试；若业务需要更高配额，可联系 MCP 服务提供方申请。
11200052 - MCP_HTTP_CLIENT_ERRORHTTP 4xx 且非 400/401/403/404/405/429 的其它客户端错误。可能原因：请求方法、URL、请求头或请求体不符合服务端要求；请求体过大或 URL 过长；请求在服务端等待超时（如 408）。查看响应体中的具体状态码和错误信息，查阅下游 MCP 服务文档尝试解决；使用 curl 工具查看完整请求和响应以及下游 MCP 服务日志。
11200053 - MCP_HTTP_SERVER_ERRORHTTP 5xx，服务端或网关内部错误。可能原因：MCP 服务或网关异常、过载或维护中；依赖的下游服务不可用。建议先重试 2~3 次。若仍失败：查看响应错误详情以及下游 MCP 服务的日志；npx/uvx 部署可在函数计算 FC 控制台查看运行日志（需先开启日志服务）；使用 curl 工具查看完整请求和响应。
11200054 - MCP_PROTOCOL_ERROR响应无法按 MCP 协议正确解析。可能原因：服务端返回标准 JSON-RPC 错误（如解析错误、无效请求、方法不存在、参数无效、内部错误）；协议或版本不兼容。根据 JSON-RPC error code 修正请求格式、方法名或参数；确认配置中 type 与端点路径一致："sse" 对应 /sse，"streamableHttp" 对应 /mcp。
11200055 - MCP_SESSION_NOT_FOUND会话不存在或已过期。可能原因：服务端重启或会话过期后客户端仍使用旧会话；会话 ID 传递错误或丢失；服务端路由策略导致请求没有命中同一实例。优化下游 MCP 服务遵守标准的 MCP 协议行为；检查日志，MCP 下游服务可能出现异常重启导致会话丢失。
11200056 - MCP_UNKNOWN_ERROR无法归入上述分类的异常，返回信息中携带原始错误内容。可能原因：运行环境或依赖产生的未分类异常。根据返回的原始错误信息与上下文排查；npx/uvx 部署可在函数计算 FC 控制台开启日志服务查看运行日志。
11200057 - MCP_INIT_TIMEOUT初始化阶段未收到服务端就绪信号。可能原因：服务端未及时推送初始化数据；网络延迟或丢包；中间代理或网关对长连接支持异常。建议先重试 2~3 次。若仍失败：前往 MCP 管理核对接入地址和传输方式（sse 或 streamableHttp）；执行 curl <接入地址> 测试连通性；反向代理需启用长连接并设置足够超时时间；npx/uvx 部署可在函数计算 FC 控制台查看启动日志，基础模式有冷启动延迟可切换为极速模式。
11200058 - MCP_SERVER_HTTP_METHOD_NOT_ALLOWEDHTTP 405，端点不接受所使用的 HTTP 方法。可能原因：使用的传输方式与接入路径不匹配（如 SSE 与 Message 端点混用）；对同一 URL 使用了服务端不支持的方法（如误用 GET/POST）。确认配置中 type 与端点路径匹配："sse" 对应 GET /sse，"streamableHttp" 对应 POST /mcp。配置错误时在 MCP 管理中修改后重新部署；建议使用标准的 MCP SDK 实现下游 MCP 服务。
11200059 - MCP_SERVER_HTTP_NOT_FOUNDHTTP 404，请求路径不存在。可能原因：接入 URL 路径配置错误（如缺少路径前缀）；服务端路由或网关未将该路径转发到 MCP 服务；实例已下线或未正确部署。确认配置中 type 与端点路径匹配；前往 MCP 管理确认服务状态，未部署时重新部署；使用 curl 工具测试连通性。
11200060 - MCP_SERVER_HTTP_BAD_REQUESTHTTP 400，请求格式或参数不合法。可能原因：请求体不是合法 JSON 或不符合 MCP/JSON-RPC 格式；必填参数缺失或类型错误；请求头或查询参数未通过服务端校验。检查相关字段的类型和必填项是否与服务端要求一致；使用 curl 工具测试连通性。

接入智能体/工作流应用

  1. 为什么智能体应用无法调用 MCP 服务，或报参数错误？ 智能体根据提示词（Prompt）决定调用和参数。请尝试：
    1. 优化提示词，明确意图。
    2. 若无效，更换更强的推理模型（如千问 3 系列）。
  2. 调用 MCP 会导致模型输入或输出 Token 增加吗？ 会，调用 MCP 可能导致模型输入和输出 Token 增加。
    1. 输入 Token 增加：从 MCP 服务获取的内容会作为上下文传递给模型，直接增加输入 Token 数量。
    2. 输出 Token 增加：虽然调用 MCP 本身不直接产生输出 Token，但由于模型获得了更丰富的上下文信息，可能生成更详细、更完整的响应，从而间接增加输出 Token 数量。
  3. MCP 服务能否在调用千问 API 时接入？ 不可以。阿里云百炼 MCP 服务需集成在智能体或工作流应用中使用，不能直接在调用千问 API 时接入。
MCP
Skill
更新日志