Saltar para o conteúdo
MarcommAI

Ligue 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 seu próprio início de sessão. O Gemini CLI liga-se através de uma extensão.

  1. 1
    No Google Cloud, confirme que tem a função Discovery Engine Editor. Abra a sua aplicação do Gemini Enterprise, vá a Connected data stores e adicione um Custom MCP server.
  2. 2
    Indique 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
    Indique 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
    Indique qualquer texto, como unused, em Client Secret. O Marcomm não emite nem verifica segredo; o início de sessão é protegido por PKCE.
  6. 6
    Indique read write em Scopes (read sozinho dá acesso só 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 guarde. Na primeira vez que alguém usa uma ferramenta do Marcomm, o Gemini pede que inicie sessão 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 nome próprio, com o acesso que a sua função no espaço de trabalho permite, tal como no Claude e no ChatGPT. As definições do espaço de trabalho em Definições → Ligações de ferramentas de IA aplicam-se também ao 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, por isso o PKCE protege o início de sessão, e o Marcomm recusa qualquer pedido sem PKCE.

O Marcomm emite sempre um token de atualização, por isso offline_access não é necessário. Se o indicar, é ignorado.

Perguntas frequentes

Preciso de um Client Secret no Gemini Enterprise?
O Gemini Enterprise exige o campo, por isso indique qualquer texto como unused. O Marcomm não emite nem verifica segredo. O PKCE, que tem de ficar ativado, protege o início de sessão.

Ferramentas de IA