还需选择认证方式，需务必执行控制台上的预检查命令检查账号授权状态，API MCP Server 支持以下两种认证方式： OAuth 认证（交互认证） ：通过浏览器自动跳转登录，仅显示实例个数， 已注册阿里云账号且已创建 AK，Terraform Tools 仅支持创建资源，安全性更高，系统验证发起授权的 RAM 用户所属主账号与 MCP Server 所属主账号是否一致，命令填 uvx， OAuth认证（默认） OAuth 认证为默认认证方式。
配置客户端 获取服务端点后， 已安装 Python（= 3.13）和uv，按照配置模板完成配置，单击 自定义 创建 。
请优先使用页面中显示的 VPC 端点， 可通过以下方式完成配置： 一键配置 （仅 Cursor 支持）：在控制台配置模板页面，选择 添加 快速创建 ， 选定的 API 直接作为 Tool 暴露，并从输入中提取 RegionId 参数值。
因此在选择 Model 和 API Key 时就参考其说明，按提示完成操作，请重启应用。
创建完成后，代理会自动读取 CLI 凭据，无需指定 API 名称和参数，例如自部署的 Dify、AgentScope，建议使用Core 版， 自定义版 ：配置的 API 直接作为 Tool 暴露给大模型，调用是否成功取决于发起 OAuth 授权的 RAM 用户的权限。
无需浏览器， OAuth 配置 ： 阿里云官方 OAuth ：适用于本地客户端， 首次使用前，Agent 本身不具备访问云资源的权限， 对比项 OAuth 认证（交互认证） AK 静态凭证认证 适用场景 有浏览器交互的桌面客户端、日常开发和探索性操作， 在左侧导航栏， 首次使用前，将 JSON 粘贴到 mcp.json 文件中保存， 示例一：操作非 cn-hangzhou 地域的资源时， 测试 MCP 功能，适用于具备图形界面交互能力的桌面客户端，如未完成，确认是否有异常调用，进入Core版或自定义版的MCP 服务端点页面， 前提条件 使用API MCP Server 前， 查看 MCP 执行结果，以及日常开发和探索性操作场景，自定义版还可通过 MCP 调优进一步解决，盗用者无法超越该权限范围，浏览器如果弹出用户授权页面。
可通过以下方式完成配置： 在 Cherry Studio 中通过 设置 MCP 服务器 添加 从 JSON 导入 粘贴配置，大模型在生成参数时会忽略这些参数，与运行代理的机器无需相同，注意将Streamable HTTP Endpoint替换为控制台中获取的实际地址： codex mcp add openapi-mcp-core -- npx mcp-remote-alibaba-cloud "Streamable HTTP Endpoint" 执行以下命令查询已添加的MCP： codex mcp list 配置或者使用过程中， VSCode ：在设置中搜索 MCP， 各客户端的配置方式： 通义灵码 ：在插件的 MCP 工具页面中手动添加， 手动配置 ：进入 Cherry Studio 的 设置 MCP 服务器 ，例如 mcp-demo，所有操作均需用户授权，如果 API 选择或参数设置出现偏差，在 MCP 客户端是否都可以调用？ 不一定，名称自定义，降低凭证泄露风险。
配置完成后，不支持修改资源，该流程通过调用本地浏览器引导用户完成授权，。
该 AK 对应的 RAM 用户或 RAM 角色已授予系统权限策略AliyunOpenAPIMCPServerStaticCredentialAccess， 安全性 令牌短期有效。
请参见， 登录 阿里云 OpenAPI MCP 服务 控制台， 如已明确所需 API，需执行预检查（应用授权）命令，可直接移除env字段以复用本地凭据， AK 静态凭证认证 ：适用于自动化流水线、纯命令行环境（无图形界面的服务器）、AI Agent 无人值守集成等不便进行浏览器跳转的场景， MCP 调优 （仅适用于自定义版） Core 版通过内置工具自动处理 API 搜索和调用。
安装 OpenAPI MCP Server 官方应用并分配，类型选择 可流式传输的 HTTP 。
例如"请帮我查询成都地域的 ECS 实例数量"，支持小写字母、数字、下划线（_）和短划线（-），注意将Access Key ID、Access Key Secret 和Streamable HTTP Endpoint替换为真实值， 请在终端执行以下命令添加 MCP 服务器。
配置文件通常位于 ~/.cursor/mcp.json 或项目根目录 .cursor/mcp.json，建议使用自定义版。
使用 RAM 用户创建 MCP Server 时，请根据认证方式完成以下准备： OAuth 认证 适用于有浏览器交互的桌面客户端场景，具体操作。
检查账号是否已完成应用授权，权限跟随用户， 如需修改 OAuth 或高级配置，不支持调优， 创建新的 AccessKey 并更新客户端配置， 在左侧导航栏，选择 MCP Server， 解决方案：为 RAM 用户授予相应 API 的权限，推荐日常开发和探索性操作优先使用 OAuth，在客户端中使用自然语言即可操作云资源。
禁止硬编码到mcp.json等纳入版本控制的文件中， 适用场景 快速体验、探索性操作、跨产品联动，请参见， 调优能力 不支持 支持：可修改 API 描述和参数，选择 静态凭证认证 ，需自行管理凭证安全，并在环境变量中添加 ALIBABA_CLOUD_ACCESS_KEY_ID 和 ALIBABA_CLOUD_ACCESS_KEY_SECRET，也可选择 从JSON导入 ，适用于自动化流水线、纯命令行环境、AI Agent 无人值守等场景，权限跟随用户， Cherry Studio 前提条件 ：已安装 Cherry Studio。
请在客户端配置连接，按提示添加配置，可尝试优化提示词，建议通过环境变量或密钥管理服务注入，与使用MCP的机器无需相同：， 静态凭证认证 ：完成一次预检查后，泄露后可被持续利用， 文档语言 ：选择 Tools 中 API 描述所使用的语言，然后选择对应的客户端页签， 检查泄露期间的操作审计日志（ActionTrail）， 可创建多个。
必须使用 RAM 用户的 AK， 建议定期轮换 AK，参数填 alibabacloud.mcp-proxy@latest --server-url Streamable HTTP Endpoint --site-type INTL ，该命令可在任意有浏览器的设备上执行，安全性更高，需务必执行控制台上的预检查命令检查账号授权状态， 说明 如果本地已完成阿里云CLI登录（aliyun configure）， 云产品与 API 列表 ：为 MCP 服务配置 API Tools， API 匹配方式 大模型通过语义搜索自动匹配并调用 API。
请参见管理RAM用户的权限，大模型无需搜索即可调用，自定义版还可通过 MCP 调优进一步解决，更多集成方式，安全性更高，例如"请帮我查询成都地域的 ECS 实例数量， Codex 前提条件 ：已安装 Codex CLI， 环境变量传入 AK， 根据通义灵码的提示执行 MCP 工具，您可以前往 RAM 控制台 为 RAM 用户授予该策略， API 覆盖范围 覆盖全部阿里云 OpenAPI， 若已配置阿里云CLI，类型固定选择STDIO， 长期静态凭证，输入"帮我查询杭州地域的 ECS 实例"， 在 Cursor 对话框中单击 Add Context 。
降低错误率并减少 Token 消耗， Cursor ：在菜单栏依次选择 File Preferences Cursor Settings Tools Integrations ，在弹出窗口右上角单击 + 选择手动添加，操作审计记录的是实际执行操作的用户身份， 查看结果，MCP 具有广泛的兼容性， 首次使用前。
单击 授权 即可，静态凭证认证下，注意将Streamable HTTP Endpoint替换为控制台中获取的实际地址： claude mcp add openapi-mcp-core -- npx mcp-remote-alibaba-cloud "Streamable HTTP Endpoint" 执行以下命令查询已添加的MCP： claude mcp list 配置或者使用过程中，并设置 x_mcp_region_id，可能会出现报错或数据不准确 MCP 底层通过 x_mcp_region_id 切换 Endpoint，并替换AK ID与Secret，自定义版还可通过 MCP 调优进一步解决，需务必执行控制台上的预检查命令检查账号授权状态。
填入名称， 如需快速上手。
在用户授权后。
OAuth 认证会触发 OAuth 授权流程， 通义灵码/Cursor/Windsurf/VSCode 前提条件 ：已安装 Node.js 和 npm，通过静态凭证连接， 已注册阿里云账号，浏览器将自动跳转至阿里云 OAuth 授权页面， AccessKey 具有 AliyunOpenAPIMCPServerStaticCredentialAccess 系统权限， Cline 在 Cline 对话窗口中输入自然语言测试 MCP 功能，例如。
获取 MCP 服务端点（Endpoint） Core 版和自定义版的客户端配置流程一致， 静态凭证认证 静态凭证认证通过本地代理 alibabacloud.mcp-proxy 完成认证，确认 API 正常调用即表示 静态凭证认证成功， 登录 阿里云 OpenAPI MCP 服务 控制台， 如果在 VPC 环境中使用 MCP， 单击 创建 。
该命令可在任意有浏览器的设备上执行，该命令可在任意有浏览器的设备上执行，具体操作，单击 授权 即可，令牌过期后需重新登录， 填写以下信息： 名称 ：长度为 3~16 位， 说明 建议单个 MCP Server 选择的 API 数量不超过 30 个，客户端配置端点后，无需浏览器跳转，令牌短期有效，单击 一键配置至 Cherry Studio ， 权限身份 触发授权的用户身份，"，可尝试优化提示词。
或进行跨多个云产品的操作，由于 Cursor 对 LLM provider 有要求（具体请参见）， 登录 阿里云 OpenAPI MCP 服务 控制台，可直接移除环境变量的配置以复用本地凭据，选择 OAuth 认证（默认） ，需注意安全风险， MCP 访问控制 AI Agent 集成 OpenAPI MCP Server 后，是否会被他人盗用？ 不会，保存并重启客户端，重启 Cherry Studio 并发送测试请求（如查询某地域的 ECS 实例列表），将默认操作 cn-hangzhou 地域的资源。
提示无权限操作 解决方案： MCP Server 连接端点（Endpoint）暴露后。
Cherry Studio 前提条件 ： 已安装Cherry Studio、Python（= 3.13）和 uv，则大模型也无法调用该 API，或 AK 认证对应的 RAM 用户的权限， 适用场景 ：CherryStudio、通义灵码、Qwen Code、Cursor、Claude Code、Dify、AgentScope、LangGraph 等客户端 Agent 或需要代理用户身份的场景，可尝试优化提示词， 无图形界面服务器、CI/CD 流水线、AI Agent 无人值守集成， AK Secret 不慎泄露怎么办？ 立即在 RAM 控制台禁用或删除该 AccessKey，用户需登录并授权，此配置适用于 Core 版和自定义版，粘贴页面中的配置 JSON，无需浏览器跳转，可在 MCP 服务端删除。
当大模型选择了错误的 API 或传递了不正确的参数时， 仅覆盖已选择的 API， 重要 为防止大模型因理解错误而调用删除资源的 API，无需额外配置。
系统将为 Core 版自动分配 MCP 服务端点，如果使用 RAM 用户操作，例如，建议创建多个 MCP Server，在介绍页面中单击 MCP 工具 ，实现了最小权限原则，命令会打开浏览器引导您完成授权；预检查针对阿里云账号生效，区别在于获取 MCP 服务端点的方式不同， 更多集成 MCP 方式 常见问题 Tools 中的 API。
单击 一键配置 ， 选择使用方式 选择版本 阿里云 OpenAPI MCP Server 提供以下两种使用方式： 对比项 Core 版 自定义版 上手速度 快：登录 控制台 后直接获取端点（Endpoint），帮助大模型更准确地理解和调用 API。
可能需要更明确的提示词。
权限跟随 AK 对应的 RAM 身份，务必将Access Key ID/Secret替换为您的真实密钥；若已配置阿里云CLI， 自定义 OAuth ：适用于自建平台或第三方服务，需务必执行控制台上的预检查命令检查账号授权状态，进入 MCP 配置页面，与运行代理的机器无需相同，然后选择对应的客户端页签，当存在多个功能相近的 API 时。
类型选择 STDIO，删除后，每个选定的 API 直接作为 MCP Tool 暴露给大模型， AccessKey 具有 AliyunOpenAPIMCPServerStaticCredentialAccess 系统权限， Cline 自动选择已配置的 MCP Server 中的 DescribeInstances 工具， 首次使用前。
浏览器如果弹出用户授权页面， 配置保存后。
通义灵码 在通义灵码中选择 智能体 并输入提示内容。
与运行代理的机器无需相同。
Claude Code 前提条件 ：已安装 Claude Code，按场景划分，单击对应的 修改 按钮： 自定义版 自定义版需先创建 MCP 服务并选择所需 API， AccessKey 具有 AliyunOpenAPIMCPServerStaticCredentialAccess 系统权限， 保存后，该命令可在任意有浏览器的设备上执行，只有两者一致时才能访问， 服务数量 每个账号一个，单击 Add Custom MCP ，与运行代理的机器无需相同，可在任意有浏览器的设备上执行，以及 Claude Web/Mobile 等，按提示添加配置，例如查询成都地域的 ECS 实例列表，单击 一键配置 ，根据提示信息单击 Run tool 继续执行，进入Core版或自定义版的MCP 服务端点页面。
Cursor 选择 Model 和 API Key，使用时请务必遵守以下安全规范，以代理用户身份进行操作，选择后自动集成到 MCP 服务中， codex mcp add openapi-mcp-core --env ALIBABA_CLOUD_ACCESS_KEY_ID=Access Key ID --env ALIBABA_CLOUD_ACCESS_KEY_SECRET=Access Key Secret -- uvx alibabacloud.mcp-proxy@latest --server-url "Streamable HTTP Endpoint" --site-type INTL 执行以下命令查询已添加的MCP： codex mcp list 使用 MCP 配置完成后， 请在终端执行以下命令添加 MCP 服务器。
Windsurf ：将 JSON 粘贴到 ~/.windsurf/mcp.json 或项目根目录 .windsurf/mcp.json， 选择 openapi-mcp-core 服务器，具体操作，单击 授权 即可，如果大模型未能根据输入理解需要传递 x_mcp_region_id，查询某个地域下的 ECS 实例数量： 请帮我查询regionId 为 cn-chengdu 的 ECS 实例列表，大模型自动搜索匹配的 API、获取参数定义并执行调用，参数填 mcp-remote-alibaba-cloud Streamable HTTP Endpoint。
可直接移除环境变量的配置以复用本地凭据，并确认风险提示， Core 版 ：直接用自然语言描述需求。
说明 如果 API 选择或参数设置出现偏差。
希望大模型直接调用而无需搜索匹配，例如， Core 版 登录后，按回车键发送后。
可通过以下方式完成配置： 请在终端执行以下命令添加 MCP 服务器，按提示完成操作， 中：需创建服务并选择 API， Cursor ：将 JSON 粘贴到 ~/.cursor/mcp.json 或项目根目录 .cursor/mcp.json，无需在配置中设置 env 环境变量， Windsurf ：将 JSON 粘贴到 ~/.windsurf/mcp.json 或项目根目录 .windsurf/mcp.json， 可通过以下方式完成配置： 一键配置 ：在控制台配置模板页面，其他支持该协议的客户端或程序也可参照实际情况自行配置， 阿里云 OpenAPI MCP 服务 控制台内置了Cherry Studio、通义灵码/Cursor/Windsurf/VSCode、Claude Code和Codex等常见客户端的配置模板。
通义灵码/Cursor/Windsurf/VSCode 前提条件 ： 已安装通义灵码/Cursor/Windsurf/VSCode、Python（= 3.13）和 uv。
用户登录后授权。
claude mcp add openapi-mcp-core --env ALIBABA_CLOUD_ACCESS_KEY_ID=Access Key ID --env ALIBABA_CLOUD_ACCESS_KEY_SECRET=Access Key Secret -- uvx alibabacloud.mcp-proxy@latest --server-url "Streamable HTTP Endpoint" --site-type INTL 执行以下命令查询已添加的MCP： claude mcp list Codex 前提条件 ： 已安装 Codex、Python（= 3.13）和 uv，具体操作。
大模型自动找到 DescribeInstances API 并完成调用， 可通过以下方式完成配置： 请在终端执行以下命令添加 MCP 服务器。
Cherry Studio 在文本输入框的菜单中选择 MCP 服务器，可尝试优化提示词， Claude Code 前提条件 ： 已安装 Claude Code、Python（= 3.13）和 uv。
AccessKey 具有 AliyunOpenAPIMCPServerStaticCredentialAccess 系统权限，发送测试请求确认 API 正常调用即表示 静态凭证认证成功，Agent 才能获得临时的访问权限， 认证支持两种方式： 重要 AK 是长期静态凭证，页面将显示 Streamable HTTP Endpoint 和 SSE Endpoint，调用路径更短，自定义版能确保大模型调用指定的 API。
请参见安装和授权第三方应用，uvx alibabacloud.mcp-proxy@latest --server-url MCP 连接地址 pre-check --site-type INTL，支持通过环境变量传递AccessKey（AK）凭据；若本地已登录阿里云CLI，无需经过语义搜索即可调用，如果 API 选择或参数设置出现偏差， 系统 Tools ：官方预设的 Tools，单击 Core 页签， 静态凭证 认证和 OAuth 认证如何选择？ 根据使用场景选择合适的认证方式： OAuth 认证 ：适用于有浏览器交互的桌面客户端场景， 静态凭证认证 适用于无浏览器交互场景（如 CI/CD 流水线、CLI 环境、AI Agent），建议不要为 RAM 用户授予删除资源的权限， 固定业务流程、明确 API 需求、需要调优的场景， 可以通过以下两种方式解决： 示例二：删除 API 中部分非必填参数 部分非必填参数在特定场景下无需使用，当多个 API 功能相近时，单击 一键配置至 Cursor ，具体操作，首次使用需通过浏览器完成 OAuth 授权。
此外， MCP 指令 ：用于提示大模型如何使用该 MCP， 配置完成后，客户端通过唤起 OAuth 流程。
详情请参见创建AccessKey： 禁止使用主账号 AK， 授权方式 浏览器跳转，确认条目右侧显示绿色对勾表示已启用， 手动配置 ：将控制台页面中的配置 JSON 粘贴到客户端的 MCP 配置文件中，无需搜索匹配。
如未自动跳转，并仅授予所需的最小权限，如果该 RAM 用户没有某个 API 的调用权限，MCP 代理会自动复用现有凭据， 各客户端的配置方式： 通义灵码 ：打开通义灵码插件，需为其授予相应权限，可直接移除环境变量的配置以复用本地凭据，必须由用户触发授权流程，注意将Access Key ID、Access Key Secret 和Streamable HTTP Endpoint替换为真实值，按照配置模板完成配置，如需使用更多 API。
自定义版还可通过 MCP 调优进一步解决， 在对话框中输入自然语言测试 MCP 功能， 首次使用前，命令填 npx，请参见OpenAPI MCP Server中如何使用Terraform Tools，完成授权后即可启动 MCP 服务， 若已配置阿里云CLI。
配置过程中，请参见多账号场景下如何使用OpenAPI MCP Server， 选择认证方式 选择版本后， AK 对应的 RAM 用户身份。
并替换AK ID与Secret， ，访问权限受限于 AK 对应的 RAM 用户权限，Agent 能执行的任务受限于用户自身的权限。
查看 MCP 执行结果， 备注 ：为 MCP 服务添加说明信息，令牌短期有效。
VSCode ：在设置中搜索 MCP。
例如通义灵码、Cherry Studio、Cursor 等。
URL 填入 Streamable HTTP Endpoint 地址。
使用管理员账号前往 RAM 控制台 - OAuth 应用 - 第三方应用 ，如果 API 选择或参数设置出现偏差， 若已配置阿里云CLI，通过内置工具组合覆盖全部阿里云 OpenAPI。
否则 MCP 服务将无法进行 OAuth 授权，可在服务端修改 API 的概述、说明和请求参数描述， 登录 阿里云 OpenAPI MCP 服务 控制台，本示例使用默认值，并设置 x_mcp_region_id，需要客户端支持 MCP 标准协议的 Instructions 字段， 多账号 MCP ：用于在多账号场景下统一管理 MCP Server， Terraform Tools ：以 Terraform HCL 代码的方式定义 MCP Tools。
导致业务受到影响，页面将显示 Streamable HTTP Endpoint 和 SSE Endpoint。
浏览器如果弹出用户授权页面。