将 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 负责保护登录。