將 Marcomm 連線到 Gemini Enterprise
Google Cloud 管理員把 Marcomm 的 MCP 伺服器以自訂 MCP 伺服器加入 Gemini Enterprise 後,成員就能在 Gemini 中用自己的帳號使用 Marcomm。Gemini CLI 透過擴充功能連線。
- 1在 Google Cloud 確認你擁有 Discovery Engine Editor 角色。開啟你的 Gemini Enterprise 應用程式,前往 Connected data stores,新增一個 Custom MCP server。
- 2在 MCP Server URL 填入
https://app.marcomm.works/api/mcp。Marcomm 以 Streamable HTTP 回應,這是 Gemini Enterprise 唯一接受的傳輸方式。 - 3在 Authorization URL 填入
https://marcomm.works/oauth/authorize(不帶參數),在 Token URL 填入https://marcomm.works/api/oauth/token。 - 4要取得 Client ID,請在終端機執行一次下列指令,並從回應中複製
client_id:curl -X POST https://marcomm.works/api/oauth/register -H "Content-Type: application/json" -d '{"client_name":"Gemini Enterprise","redirect_uris":["https://vertexaisearch.cloud.google.com/oauth-redirect"]}' - 5在 Client Secret 填入任意文字,例如
unused。Marcomm 不核發也不驗證金鑰,登入由 PKCE 保護。 - 6在 Scopes 填入
read write(只填read則為唯讀)。同時開啟 Enable PKCE Support 與 Use HTTP Basic Authentication。 - 7把
app.marcomm.works/marcomm.works加入代理程式的對外連線允許清單並儲存。有人第一次使用 Marcomm 工具時,Gemini 會請他登入 Marcomm、選擇工作區並按允許。
Gemini CLI:執行 gemini extensions install https://github.com/alex-digitalog/marcomm-gemini-extension。
每個人都以自己的身分操作,權限取決於其在工作區中的角色,與 Claude、ChatGPT 相同。設定 → AI 工具連線 中的工作區設定同樣適用於 Gemini。
對於 Gemini Enterprise,Marcomm 只接受重新導向位址 https://vertexaisearch.cloud.google.com/oauth-redirect。Client ID 沒有金鑰,登入由 PKCE 保護,沒有 PKCE 的請求會被拒絕。
Marcomm 一律會核發重新整理權杖,因此不需要 offline_access。填入也會被忽略。
常見問題
- 在 Gemini Enterprise 中一定要填 Client Secret 嗎?
- Gemini Enterprise 要求填寫這一項,所以填入 unused 之類的任意文字即可。Marcomm 不核發也不驗證金鑰,必須保持開啟的 PKCE 負責保護登入。