跳到主要内容

将 Marcomm 连接到 Gemini Enterprise

Google Cloud 管理员把 Marcomm 的 MCP 服务器作为自定义 MCP 服务器添加到 Gemini Enterprise 后,成员即可在 Gemini 中用自己的账号使用 Marcomm。Gemini CLI 通过扩展连接。

  1. 1
    在 Google Cloud 中确认你拥有 Discovery Engine Editor 角色。打开你的 Gemini Enterprise 应用,进入 Connected data stores,添加一个 Custom MCP server。
  2. 2
    在 MCP Server URL 中填入 https://app.marcomm.works/api/mcp。Marcomm 通过 Streamable HTTP 响应,这是 Gemini Enterprise 唯一接受的传输方式。
  3. 3
    在 Authorization URL 中填入 https://marcomm.works/oauth/authorize(不带参数),在 Token URL 中填入 https://marcomm.works/api/oauth/token。
  4. 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. 5
    在 Client Secret 中填入任意文字,例如 unused。Marcomm 不签发也不校验密钥,登录由 PKCE 保护。
  6. 6
    在 Scopes 中填入 read write(只填 read 则为只读)。同时开启 Enable PKCE Support 和 Use HTTP Basic Authentication。
  7. 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 负责保护登录。

AI 工具