OpenAPI Explorer：OpenAPI MCP Server使用指南

一鍵配置

如果您在Cherry Studio或Cursor中使用MCP，可以通過官方提供的一鍵配置功能完成MCP配置。

手動設定

樣本一：操作非cn-hangzhou地區的資源時，可能會出現報錯或資料不準確。

MCP底層是通過x_mcp_region_id切換endpoint的。如果大模型未能根據您的輸入理解需要傳遞x_mcp_region_id，它將預設操作cn-hangzhou地區的資源。

您可以通過以下兩種方式實現：

• 在提問時明確告訴大模型需要設定 x_mcp_region_id。

  請幫我查詢regionId為cn-qingdao的ECS執行個體列表，並設定x_mcp_region_id。

• 在MCP服務端調整API的概述或請求參數RegionId描述。

  例如在API概述中補充“將使用者描述的地區傳遞給 x_mcp_region_id”，或在RegionId中添加“如果參數RegionId存在，必須將其與x_mcp_region_id一起傳遞”。

  操作步驟：

  1. 訪問我的MCP服務，單擊MCP服務作業欄的編輯按鈕。

  2. 選中待調優的API，單擊操作欄的編輯按鈕。

  3. 修改概述、API請求說明或API參數描述等。

  4. 儲存修改內容後，在用戶端需斷開MCP服務並重新串連，以使修改內容生效。

樣本二：刪除API中部分非必填參數。

由於API文檔中的參數是包括了所有情境，其中部分非必填參數可能在您的絕大多數的情境下並不需要使用，因此您可以在MCP服務端中刪除這些非必填參數。大模型在傳參時將不會“看到”這些被刪除的參數，這不僅可以降低大模型的錯誤率，還可以減少tokens的使用。

1. Tools中的API，在MCP用戶端是否都可以調用？

問題原因：不一定都能調用成功，具體情況取決於RAM使用者的許可權，如果RAM使用者沒有某個API的調用許可權，則大模型也將無法調用該API。

解決方案：可以為該RAM使用者授予相應API的許可權，具體操作請參見為RAM使用者授權。

2. 使用RAM使用者建立MCP Server時，提示無許可權進行MCP操作，請聯絡具有管理員權限的帳號授權。

解決方案：

• 為RAM使用者授予系統權限原則AliyunOpenAPIMCPServerFullAccess，具體操作，請參見為RAM使用者授權。

• 為RAM使用者授予自訂權限原則：

  1. 請聯絡具有管理員權限的帳號在RAM 控制台建立自訂權限原則，具體操作，請參見建立自訂權限原則。

     權限原則內容如下：

     點擊查看MCP Server操作相關權限原則

     該權限原則包括建立、更新、查詢及刪除MCP Server的許可權，以及查詢MCP系統工具的許可權。

     {
       "Version": "1",
       "Statement": [
         {
           "Action": [
             "openapiexplorer:*Mcp*",
             "ram:*Application*"
           ],
           "Resource": "*",
           "Effect": "Allow"
         }
       ]
     }

  2. 請聯絡具有管理員權限的帳號為該無許可權的RAM使用者授予自訂許可權，具體操作，請參見為RAM使用者授權。

3. 如果MCP Server串連端點（Endpoint）暴露了，是不是誰都可以用了？

MCP Server串連端點暴露後，其他人也不能用。當在用戶端中填入MCP Server串連端點儲存之後，會由用戶端實現OAuth的發現。首先，會彈出阿里雲控制台的授權登入頁面。完成授權後，將驗證MCP Server所屬的阿里雲主帳號與授權OAuth的RAM使用者所屬主帳號是否一致，只有在兩者一致的情況下，才能訪問MCP Server。