Pular para o conteúdo
MarcommAI

Conectar o Marcomm ao Gemini Enterprise

Um administrador do Google Cloud adiciona o servidor MCP do Marcomm ao Gemini Enterprise como servidor MCP personalizado, e as pessoas passam a usar o Marcomm no Gemini com o próprio login. O Gemini CLI se conecta por uma extensão.

  1. 1
    No Google Cloud, confirme que você tem o papel Discovery Engine Editor. Abra seu app do Gemini Enterprise, vá em Connected data stores e adicione um Custom MCP server.
  2. 2
    Informe https://app.marcomm.works/api/mcp em MCP Server URL. O Marcomm responde por Streamable HTTP, o único transporte que o Gemini Enterprise aceita.
  3. 3
    Informe https://marcomm.works/oauth/authorize (sem parâmetros) em Authorization URL e https://marcomm.works/api/oauth/token em Token URL.
  4. 4
    Para obter o Client ID, execute este comando uma vez no terminal e copie o client_id da resposta: 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
    Informe qualquer texto, como unused, em Client Secret. O Marcomm não emite nem confere segredo; o login é protegido por PKCE.
  6. 6
    Informe read write em Scopes (read sozinho dá acesso somente de leitura). Ative Enable PKCE Support e Use HTTP Basic Authentication.
  7. 7
    Adicione app.marcomm.works / marcomm.works à lista de saída permitida dos seus agentes e salve. Na primeira vez que alguém usa uma ferramenta do Marcomm, o Gemini pede que entre no Marcomm, escolha um espaço de trabalho e selecione Permitir.

Gemini CLI: execute gemini extensions install https://github.com/alex-digitalog/marcomm-gemini-extension.

Cada pessoa age em seu próprio nome, com o acesso que o papel dela no espaço de trabalho permite, igual ao Claude e ao ChatGPT. As configurações do espaço de trabalho em Configurações → Conexões de ferramentas de IA valem também para o Gemini.

Para o Gemini Enterprise, o Marcomm aceita só o endereço de redirecionamento https://vertexaisearch.cloud.google.com/oauth-redirect. O Client ID não tem segredo, então o PKCE protege o login, e o Marcomm recusa qualquer solicitação sem PKCE.

O Marcomm sempre emite um token de atualização, então offline_access não é necessário. Se você informar, ele é ignorado.

Perguntas frequentes

Preciso de um Client Secret no Gemini Enterprise?
O Gemini Enterprise exige o campo, então informe qualquer texto como unused. O Marcomm não emite nem confere segredo. O PKCE, que deve continuar ativado, protege o login.

Ferramentas de IA