Encurtador de URLs do Gemini: onde as chamadas de ferramentas realmente funcionam

O Gemini consegue criar um link curto que funciona. Só não no lugar que a maioria das pessoas tenta primeiro.

A separação é mais nítida do que com outros assistentes, e tudo se resume a uma decisão arquitetural do Google: o aplicativo Gemini para consumidores não tem mecanismo para chamar uma API que pertença a você. Peça para ele encurtar uma URL e você recebe um slug com o formato certo e nada por trás. A CLI do Gemini é um produto diferente, com uma resposta diferente, e é lá que a chamada de ferramenta acontece. Por isso, uma decisão que parece ser uma preferência entre duas superfícies do Google acaba determinando se sua equipe consegue usar isso de fato.

Este artigo aborda as três superfícies e o que cada uma realmente consegue fazer: a CLI via MCP, chamadas de função na API do Gemini e o chat pré-preenchido. O artigo paralelo sobre ChatGPT chega a uma conclusão diferente, por motivos que vale a pena entender antes de escolher uma superfície.

Por que o aplicativo Gemini não pode criar um link curto

Gems são o recurso de assistente personalizado do Gemini e, à primeira vista, parecem o equivalente a um GPT personalizado. Mas não são, no aspecto que importa aqui. Os Gems não têm equivalente às Actions. Não têm um campo de esquema OpenAPI. Não têm configuração de autenticação. Não há como apontar um deles para seu próprio endpoint.

Os Gems podem usar extensões do próprio Google: Workspace, Maps e YouTube. Elas são criadas pelo Google, não configuradas por você. Portanto, a lacuna de capacidade não é uma lacuna de maturidade que desaparece com uma configuração. Nada que você escreva nas instruções de um Gem dará a ele acesso de rede à sua API.

Por isso, o aplicativo faz o que qualquer assistente sem ferramentas faria diante de um pedido de link curto. Ele produz caracteres plausíveis. É bom saber disso antes de passar uma tarde tentando contornar o problema com prompts.

Rota um: CLI do Gemini via MCP

A CLI do Gemini oferece suporte ao Model Context Protocol, o que significa que o mesmo @elido/mcp-server que atende ao Claude Desktop e ao Cursor funciona aqui sem código específico do Gemini. Configure-o uma vez e create_link, list_links, query_analytics, generate_qr e list_workspaces aparecerão como ferramentas que podem ser chamadas.

Adicionando o servidor

O caminho mais rápido é o comando integrado:

gemini mcp add -s user -e ELIDO_API_KEY=$ELIDO_API_KEY elido npx -y @elido/mcp-server

Ou edite diretamente o arquivo de configurações. O escopo do usuário fica em ~/.gemini/settings.json, o escopo do projeto fica em .gemini/settings.json, e o bloco deve ficar em mcpServers:

{
  "mcpServers": {
    "elido": {
      "command": "npx",
      "args": ["-y", "@elido/mcp-server"],
      "env": {
        "ELIDO_API_KEY": "$ELIDO_API_KEY",
        "ELIDO_WORKSPACE_ID": "$ELIDO_WORKSPACE_ID"
      },
      "timeout": 30000
    }
  }
}

O detalhe da expansão de env que causa problemas

A CLI do Gemini expande $VAR e ${VAR} dentro do bloco env, por isso a chave acima é uma referência, e não um segredo colado. Use essa abordagem. Fazer commit de um .gemini/settings.json com escopo de projeto e uma chave ativa é um erro fácil de cometer e demorado para perceber.

Há uma aresta importante na documentação do servidor MCP do Google: uma variável indefinida é resolvida como uma string vazia, em vez de gerar uma exceção. Assim, um erro de digitação no nome da variável não falha de forma explícita na inicialização. Ele falha depois, na primeira chamada de ferramenta, como um erro de autenticação. Perdi vinte minutos por causa de uma exportação ausente, todos eles relendo o arquivo errado, porque um erro de autenticação aponta para a credencial, e não para o nome da variável que deveria carregá-la. Se o servidor se conecta, mas todas as chamadas retornam não autorizado, verifique primeiro a variável.

Configure a chave, e o próximo briefing de campanha que você escrever no terminal poderá criar seus próprios links: comece um workspace e gere uma chave com escopo para essa integração.

Rota dois: chamadas de função na API do Gemini

Se você está criando algo, em vez de trabalhar de forma interativa, chamadas de função são o mecanismo equivalente na camada da API. Você declara a função, o modelo retorna uma chamada estruturada quando decide que ela é necessária, seu código executa a solicitação e você envia o resultado de volta.

O formato é igual ao de qualquer integração de ferramentas. Descreva create_link, execute a solicitação HTTP você mesmo e retorne a resposta. O que você ganha em relação ao MCP é controle. Você decide exatamente quais parâmetros o modelo pode definir e pode recusar qualquer coisa fora da sua convenção de nomenclatura antes mesmo de a solicitação sair do seu processo. O que você perde é portabilidade. Essa conexão é sua para manter e não acompanha você para lugar nenhum.

Para a maioria das equipes, essa rota só faz sentido quando o encurtamento é uma etapa dentro de um fluxo automatizado maior. Se você só quer links enquanto trabalha, a CLI exige menos código e menos coisas para manter em execução.

Rota três: o chat pré-preenchido

A opção sem configuração é um link que abre o Gemini com o prompt já escrito:

https://gemini.google.com/app?q=<url-encoded%20prompt>

Esse é o mecanismo por trás dos botões na página de integrações com LLMs, confirmado na superfície em produção em abril de 2026. O comportamento de parâmetros de consulta em qualquer produto de IA pode mudar, então teste novamente se um botão parar de fazer o que fazia antes.

Seja realista sobre o que isso oferece, considerando a primeira seção. O assistente não tem ferramentas, então ele faz o rascunho e você executa. Ainda assim, isso é útil. Um lançamento que precisa de oito variantes de UTM com uma convenção de nomenclatura consistente é tedioso de fazer manualmente e fácil para um modelo acertar. Só não termina com um link.

Qual rota se encaixa

Leia essa tabela junto com a do ChatGPT e a assimetria fica evidente. A superfície compartilhável do ChatGPT é a que pode conter uma ação conectada, então uma equipe de marketing pode receber um GPT personalizado funcional. A superfície conectada do Gemini é um terminal. Se seus usuários são profissionais de marketing, essa diferença decide a plataforma antes de qualquer comparação de recursos.

Mantendo a chave com escopo

O servidor MCP mantém a credencial e o modelo nunca a vê, que é o formato certo. Ainda assim, cabe a você decidir o que a credencial pode fazer.

Emita uma chave por integração, em vez de reutilizar uma entre ferramentas. Uma chave para a criação interativa de links precisa criar links e ler análises; ela não precisa excluir links nem acessar domínios personalizados. Quando algo inesperado aparece no log de auditoria, uma chave por integração informa qual superfície produziu aquilo, e revogá-la não interrompe mais nada.

O escopo do projeto merece uma reflexão adicional. Um .gemini/settings.json com commit em um repositório compartilhado é conveniente, mas também é um arquivo que todo colaborador herda. Mantenha o segredo no ambiente e deixe o arquivo de configurações sem nada que você não colaria em um pull request.

Limites honestos

Vale a pena alinhar três expectativas.

A superfície de ferramentas é pequena de propósito. @elido/mcp-server está na versão 0.1.x, com cinco ferramentas, e a administração do workspace deliberadamente não está entre elas. Convidar pessoas, configurar domínios e alterar planos continuam no dashboard, onde uma pessoa autenticada faz essas ações.

O trabalho em massa pertence a outro lugar. Pedir quarenta links em uma conversa produz erros de limite de taxa e um modelo que perde o controle de qual slug corresponde a qual destino. Depois de alguns links, use a API ou uma importação de CSV.

E, pelo que foi anunciado até agora, a lacuna do aplicativo não é temporária. Planeje considerando isso, em vez de esperar que desapareça. Se uma equipe não técnica precisa criar links a partir de uma superfície de chat hoje, a resposta honesta é usar outro assistente ou o dashboard, não um Gem.

Leia o artigo principal → Conecte o Elido ao Claude e ao Cursor com MCP

Relacionado no Blog

• Encurtador de URLs do ChatGPT: o que funciona e o que é uma simulação - a mesma pergunta, uma resposta diferente.
• Conecte o Elido ao Claude e ao Cursor com MCP - a referência completa de MCP em que este artigo se baseia.
• Início rápido da API de encurtamento de URLs - a superfície REST por trás de todas as rotas aqui.
• Links curtos como Terraform - quando os links pertencem ao código, e não a um chat.