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