使用 Resource Manager 遠端 MCP 伺服器

必要的角色

如要取得啟用 Resource Manager MCP 伺服器所需的權限，請要求管理員在您要啟用 Resource Manager MCP 伺服器的專案中，授予您服務使用情形管理員 (roles/serviceusage.serviceUsageAdmin) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

這個預先定義的角色具備啟用 Resource Manager MCP 伺服器所需的權限。如要查看確切的必要權限，請展開「Required permissions」(必要權限) 部分：

所需權限

如要啟用 Resource Manager MCP 伺服器，必須具備下列權限：

serviceusage.mcppolicy.get
serviceusage.mcppolicy.update

您或許還可透過自訂角色或其他預先定義的角色取得這些權限。

啟用或停用 Resource Manager MCP 伺服器

您可以使用 gcloud beta services mcp enable 指令，在專案中啟用或停用 Resource Manager MCP 伺服器。詳情請參閱以下各節。

在專案中啟用 Resource Manager MCP 伺服器

如果您使用不同的專案做為用戶端憑證 (例如服務帳戶金鑰、OAuth 用戶端 ID 或 API 金鑰) 和資源主機，則必須在這兩個專案中啟用 Resource Manager 服務和 Resource Manager 遠端 MCP 伺服器。

如要在Google Cloud 專案中啟用 Resource Manager MCP 伺服器，請執行下列指令：

gcloud beta services mcp enable SERVICE \
    --project=PROJECT_ID

更改下列內容：

PROJECT_ID： Google Cloud 專案 ID。
SERVICE：Resource Manager 的全域或區域服務名稱。例如 cloudresourcemanager.googleapis.com 或 cloudresourcemanager.us-central1.rep.googleapis.com。如要瞭解可用區域，請參閱 Resource Manager MCP 參考資料。

您已啟用 Resource Manager 遠端 MCP 伺服器，可在 Google Cloud 專案中使用。如果Google Cloud 專案未啟用 Resource Manager 服務，系統會提示您先啟用該服務，再啟用 Resource Manager 遠端 MCP 伺服器。

為確保安全，建議您只為 AI 應用程式運作所需的服務啟用 MCP 伺服器。

在專案中停用 Resource Manager MCP 伺服器

如要在Google Cloud 專案中停用 Resource Manager MCP 伺服器，請執行下列指令：

gcloud beta services mcp disable SERVICE \
    --project=PROJECT_ID

Resource Manager MCP 伺服器已停用，無法在 Google Cloud 專案中使用。

驗證及授權

Resource Manager MCP 伺服器會使用 OAuth 2.0 通訊協定搭配 Identity and Access Management (IAM) 進行驗證及授權。所有Google Cloud 身分都支援 MCP 伺服器驗證。

建議您使用 MCP 工具為代理商建立個別身分，以便控管及監控資源存取權。如要進一步瞭解驗證，請參閱「向 MCP 伺服器進行驗證」。

Resource Manager MCP OAuth 範圍

OAuth 2.0 會使用範圍和憑證，判斷經過驗證的主體是否有權對資源執行特定動作。如要進一步瞭解 Google 的 OAuth 2.0 範圍，請參閱「使用 OAuth 2.0 存取 Google API」。

Resource Manager 具有下列 MCP 工具 OAuth 範圍：

gcloud CLI 的範圍 URI	說明
`https://www.googleapis.com/auth/cloudresourcemanager.read-only`	僅允許讀取資料的權限。
`https://www.googleapis.com/auth/cloudresourcemanager.read-write`	有權讀取及修改資料。

在工具呼叫期間存取的資源可能需要其他範圍。如要查看 Resource Manager 要求的範圍清單，請參閱 Resource Manager API。

設定 MCP 用戶端，以使用 Resource Manager MCP 伺服器

AI 應用程式和代理程式 (例如 Claude 或 Gemini CLI) 可以例項化 MCP 用戶端，連線至單一 MCP 伺服器。AI 應用程式可以有多個連至不同 MCP 伺服器的用戶端。如要連線至遠端 MCP 伺服器，MCP 用戶端至少須知道遠端 MCP 伺服器的網址。

在 AI 應用程式中，尋找連線至遠端 MCP 伺服器的方法。系統會提示你輸入伺服器的詳細資料，例如名稱和網址。

如果是 Resource Manager MCP 伺服器，請視需要輸入下列內容：

伺服器名稱：Resource Manager MCP 伺服器
伺服器網址或端點：cloudresourcemanager.googleapis.com/mcp
傳輸：HTTP
驗證詳細資料：視驗證方式而定，您可以輸入 Google Cloud 憑證、OAuth 用戶端 ID 和密鑰，或是代理程式身分和憑證。如要進一步瞭解驗證，請參閱「向 MCP 伺服器進行驗證」。
OAuth 範圍：連線至 Resource Manager MCP 伺服器時要使用的 OAuth 2.0 範圍。

如需特定主機的指引，請參閱下列文章：

如需更多一般指引，請參閱下列資源：

可用的工具

唯讀 MCP 工具的 MCP 屬性會設為 mcp.tool.isReadOnlytrue。您可能只想透過機構政策，在特定環境中允許唯讀工具。

如要查看 Resource Manager MCP 伺服器的可用 MCP 工具詳細資料和說明，請參閱 Resource Manager MCP 參考資料。

列出工具

使用 MCP 檢查器列出工具，或直接將 tools/list HTTP 要求傳送至 Resource Manager 遠端 MCP 伺服器。tools/list 方法不需要驗證。

POST /mcp HTTP/1.1
Host: cloudresourcemanager.googleapis.com
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "method": "tools/list",
}

應用實例

Resource Manager 遠端 MCP 伺服器中的 search_projects 工具可讓 AI 代理程式動態探索及識別您有權存取的所有 Google Cloud 專案，以便在其他工具中執行指令。

這項工具會傳回結構化清單，其中包含專案 ID、專案編號和專案的生命週期狀態。以下是 Resource Manager MCP 伺服器的範例用途：

資源清單和無障礙稽核：列出並彙整您可存取的有效雲端專案。

使用者提示：List all my active Google Cloud projects.

代理程式動作：代理程式會將搜尋查詢傳送至 MCP 伺服器，以擷取並顯示您憑證下所有有效專案的摘要清單。
以父項為目標的搜尋：擷取特定資料夾或機構中的專案，縮小要求範圍。

使用者提示：Find all projects under Folder 223.

代理程式動作：代理程式會使用查詢 parent:folders/223 執行工具呼叫，傳回該行政邊界內的專案清單。
隱含情境解析：要求資源相關資訊時，不必提供特定專案 ID，代理程式會自動解析情境。

使用者提示：Check the status of my 'payment-processor' service.

代理程式動作：代理程式發現 Cloud Run 工具缺少 project_id。這項工具會使用 search_projects 尋找名稱含有 payment 的專案，找出可能的專案 (例如 payment-prod-123)，並要求您確認是否要繼續。
環境專屬探索：您可以在聊天介面中，依特定環境或機構結構篩選專案。

使用者提示：Which projects do I have access to in the staging environment?

代理程式動作：代理程式會針對您有權查看的所有標示或命名為 staging 的專案執行搜尋作業，並傳回特定專案 ID。

自訂 LLM 行為

search_projects 工具用途廣泛，但 LLM 不一定知道何時要查詢 Google Cloud 階層。如要在特定情境中呼叫工具，請在 Markdown 檔案中提供自訂情境，例如 ~/.gemini/GEMINI.md 或專案層級的 AGENTS.md。

後續步驟

請參閱 Resource Manager MCP 參考說明文件。
進一步瞭解 Google Cloud MCP 伺服器。