排查注册问题

如果您在注册或配置关联的应用时遇到问题，请参阅下表，了解常见出错提示、原因和问题排查步骤。

问题	错误消息	原因	修复/问题排查步骤
未指定的“提取工具”失败	“未能提取 MCP 服务器详情。请重试。”（或提取工具按钮失败，但没有具体出错提示）。	由于网址无效、服务器离线或网络连接错误，一站式管理中心无法完成对 MCP 端点的请求。	验证以下事项： 仔细检查您的 MCP 端点网址是否准确，并且使用的是 https://。 确保 MCP 服务器正在运行。 确认您的 MCP 服务器可通过公共互联网访问（Google 无法访问 localhost 或专用内网地址）。
无法访问 MCP 服务器	“无法访问 MCP 服务器”	Google 的后端无法与您的 MCP 端点建立连接。	常见原因和解决方法包括： 防火墙限制：确保您的防火墙或 WAF 不会屏蔽 Google 的出站 IP 范围。 API Gateway 规则：验证您的 API Gateway 是否接受 POST 请求，并且在 MCP initialize 握手期间不会拒绝 Google 的 clientInfo。 子网域不匹配：如果您使用专用子网域（例如 gemini.mcp.company.com），请确保其 /.well-known/oauth-protected-resource 元数据与该子网域匹配，而不是指向其他基本网域 (mcp.company.com)。
MCP 传输不受支持 (HTTP 405)	“MCP 服务器拒绝了请求 (HTTP 405 Method Not Allowed)。请确保该网址指向接受 POST 请求的可流式传输 HTTP 端点，而不是旧版 SSE 端点。	端点网址指向旧版 HTTP+SSE 端点，该端点仅接受 GET 请求或拒绝 JSON-RPC POST 请求。	更新 MCP 服务器和端点网址，以使用 MCP 可流式传输 HTTP 传输，该传输可接受针对 initialize 和 tools/list 的 POST 请求。
缺少 OAuth 受保护资源文件	“MCP 服务器上不存在 /.well-known/oauth-protected-resource 文件”	Google 尝试了 OAuth 2.0 受保护资源元数据发现 (RFC 9728)，但失败了。	如果 MCP 服务器不需要身份验证：此错误通常是因为 MCP 端点网址存在拼写错误或缺少路径段（例如，https://mcp.example.com 而不是 https://mcp.example.com/mcp），并返回 HTTP 404 或 500，导致客户端回退到 OAuth 发现。验证您的确切 MCP 端点路径是否会针对未经身份验证的 POST initialize 和 tools/list 请求返回 HTTP 200 OK，然后在访问凭证中的您的服务器是否需要授权？下选择否。 如果您的 MCP 服务器需要身份验证：请在 MCP 服务器上托管一个有效的 /.well-known/oauth-protected-resource JSON 文件，并在 authorization_servers 数组中声明您信任的授权服务器。
OAuth 授权服务器元数据缺失或无效	“OAuth 服务器上不存在 /.well-known/oauth-authorization-server 文件”或“包含无效或不完整的 JSON”	您的 OAuth 服务器未在 /.well-known/oauth-authorization-server 处公开有效的 RFC 8414 元数据文档。	在 /.well-known/oauth-authorization-server（或 /.well-known/openid-configuration）托管包含 authorization_endpoint 和 token_endpoint 的有效 RFC 8414 发现文档。 或者，在凭证部分中，手动输入自定义授权端点和自定义令牌端点网址。
域名验证失败	网域证书显示“验证失败”或“验证失败”，并显示提示消息（例如 HTTP 404、不允许重定向或令牌不匹配）。	Google 无法验证您在 https://<domain>/.well-known/google-connected-apps 的质询令牌。	找不到文件 (HTTP 404)：确保下载的 google-connected-apps.json 内容已发布到 https://<domain>/.well-known/google-connected-apps（网址路径中不含 .json 扩展名）。 禁止重定向：直接通过 HTTP 200 OK 提供验证载荷；请勿将 /.well-known/google-connected-apps 重定向到其他网址。 令牌不匹配：确认 JSON 响应包含 "verification_tokens": ["<YOUR_TOKEN>"]，其中包含为您的开发者账号生成的精确令牌。
动态客户端注册 (DCR) 或 CIMD 失败	“动态客户端注册 (RFC 7591) 失败”、“OAuth 服务器不支持动态客户端注册 (RFC 7591)”或“客户端 ID 元数据文档 (CIMD) 注册失败”	自动 OAuth 客户端注册失败或不受 OAuth 提供商支持，或者 Google 的重定向 URI 被拒绝。	确保您的 OAuth 服务器将服务器身份验证凭证（https://oauth-redirect.googleusercontent.com/r/<app-id>-<sanitized-domain> 等）下显示的所有 6 个应用专用 Google 重定向 URI 列入许可清单。请注意，许多 OAuth 2.1 服务器会拒绝通配符 (*) 重定向 URI。 如果您的 OAuth 提供商不支持 CIMD 或 RFC 7591 DCR，请在访问凭证中选择预注册（适用于用户委托的 OAuth）或机器对机器（OAuth 客户端凭证），并提供静态客户端 ID 和客户端密钥。
OAuth 登录弹出式窗口被屏蔽或为空白	在工具同步或测试期间，系统显示“您的浏览器拦截了身份验证弹出式窗口”，或 OAuth 登录窗口无法正常显示。	浏览器弹窗拦截器或登录页面上的严格 X-Frame-Options / Content-Security-Policy 标头阻止了弹窗流程。	请在浏览器中允许控制台显示弹出式窗口，然后重试。 在使用您的开发者凭证进行身份验证下的访问凭证中，从通过弹出式窗口进行身份验证切换到通过重定向进行身份验证（备用），以便身份验证流程在同一标签页中以全屏模式打开。
缺少 MCP 服务器指令	警告消息：“MCP 服务器无指令。我们建议您向服务器架构添加指令。	您的 MCP 服务器未在其 initialize 响应中返回 instructions 字段。	在初始化 MCP 服务器时明确定义系统指令（服务器定义中的 instructions 参数）。 对于无状态或自定义 HTTP 实现，请确保 instructions 字段包含在 initialize 方法的 JSON-RPC 响应载荷中，然后选择重新同步工具。
界面资源大小限制或不支持的 MIME 类型	提取问题错误卡片：“累计资源大小不能超过 100 MB。”或“资源‘<uri>’的 MIME 类型‘<type>’不受支持。”	您的 MCP 服务器返回的界面资源总大小超出了限制，或使用了不受支持的 MIME 类型。	请缩减服务器返回的所有清单界面资源的累计大小，使其不超过上限。 确保所有界面资源都使用以下受支持的 MIME 类型之一：text/html、text/html;profile=mcp-app、text/javascript 或 text/css。
图标上传卡住或显示“意外错误”	在应用详细信息中上传应用图标时，上传过程卡在加载旋转图标上，或显示“发生了意外错误。请重试”（通常带有代码 4E696748）。	通常由浏览器会话过时、浏览器扩展程序冲突或身份验证状态缓存导致。	请按顺序尝试以下步骤： 使用新的浏览器个人资料：使用干净的浏览器个人资料打开一个新窗口。 使用无痕模式/无痕浏览模式：在无痕浏览窗口中登录 Google 一站式管理中心，然后上传图标。 清除缓存：在重试之前，请清除浏览器的缓存和 Cookie，并验证您的图标是否为有效的 512 像素 × 512 像素 PNG 或 JPEG 文件，且大小不超过 1 MB。