Acortador de URL de Gemini: dónde funcionan realmente las llamadas a herramientas

Gemini puede crear un enlace corto que funciona. Solo que no en el lugar donde la mayoría de la gente lo intenta primero.

La diferencia es más marcada que con otros asistentes, y se debe a una decisión arquitectónica de Google: la app de Gemini para consumidores no tiene ningún mecanismo para llamar a una API que sea tuya. Pídele que acorte una URL y obtendrás un slug con la forma correcta, pero sin nada detrás. Gemini CLI es otro producto con otra respuesta, y ahí vive la llamada a la herramienta. Por eso una decisión que parece una preferencia entre dos superficies de Google acaba determinando si tu equipo puede usar esto.

Este artículo cubre las tres superficies y lo que cada una puede hacer de verdad: la CLI mediante MCP, las llamadas a funciones en la API de Gemini y el chat preconfigurado. El artículo paralelo sobre ChatGPT llega a una conclusión distinta, por razones que conviene entender antes de elegir una superficie.

Por qué la app de Gemini no puede crear un enlace corto

Los Gems son la función de asistente personalizado de Gemini y, a primera vista, parecen el equivalente a un GPT personalizado. No lo son en el aspecto que importa aquí. Los Gems no tienen un equivalente a Actions. No tienen un campo de esquema OpenAPI. No tienen configuración de autenticación. No hay forma de dirigir uno a tu propio endpoint.

Los Gems pueden usar las extensiones propias de Google: Workspace, Maps y YouTube. Google las crea, no las configuras tú. Así que la diferencia de capacidad no es una diferencia de madurez que se solucione con un ajuste. Nada de lo que escribas en las instrucciones de un Gem le da acceso de red a tu API.

Por eso la app hace lo que haría cualquier asistente sin herramientas ante una solicitud de un enlace corto. Produce caracteres plausibles. Conviene saberlo antes de pasar una tarde entera intentando conseguirlo a base de instrucciones.

Primera vía: Gemini CLI mediante MCP

Gemini CLI admite el Model Context Protocol, lo que significa que el mismo @elido/mcp-server que sirve a Claude Desktop y Cursor funciona aquí sin código específico para Gemini. Configúralo una vez y create_link, list_links, query_analytics, generate_qr y list_workspaces aparecerán como herramientas invocables.

Añadir el servidor

La vía rápida es el comando integrado:

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

También puedes editar directamente el archivo de configuración. El ámbito de usuario está en ~/.gemini/settings.json, el ámbito del proyecto en .gemini/settings.json y el bloque va dentro de 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
    }
  }
}

El detalle de la expansión de env que causa problemas

Gemini CLI expande $VAR y ${VAR} dentro del bloque env, por eso la clave anterior es una referencia y no un secreto pegado. Úsala. Hacer commit de un .gemini/settings.json del ámbito del proyecto con una clave activa es un error fácil de cometer y lento de detectar.

Hay un detalle delicado en la documentación del servidor MCP de Google: una variable no definida se convierte en una cadena vacía en vez de producir un error. Así que un error tipográfico en el nombre de la variable no falla de forma evidente al iniciar. Falla después, en la primera llamada a una herramienta, como un error de autenticación. Perdí veinte minutos por un export que faltaba, todo ese tiempo releyendo el archivo equivocado, porque un error de autenticación apunta a la credencial y no al nombre de la variable que debía contenerla. Si el servidor se conecta, pero todas las llamadas devuelven «no autorizado», comprueba primero la variable.

Configura la clave y el siguiente resumen de campaña que redactes en el terminal podrá crear sus propios enlaces: empieza un espacio de trabajo y genera una clave con el alcance adecuado para esta integración.

Segunda vía: llamadas a funciones en la API de Gemini

Si estás creando algo en lugar de trabajar de forma interactiva, las llamadas a funciones son el mecanismo equivalente en la capa de la API. Declaras la función, el modelo devuelve una llamada estructurada cuando decide que hace falta, tu código ejecuta la solicitud y le devuelves el resultado.

La forma es la misma que en cualquier integración de herramientas. Describe create_link, ejecuta tú mismo la solicitud HTTP y devuelve la respuesta. Lo que ganas frente a MCP es control. Tú decides exactamente qué parámetros puede establecer el modelo y puedes rechazar cualquier cosa que no siga tu convención de nombres antes de que la solicitud salga de tu proceso. Lo que pierdes es portabilidad. Este cableado es tuyo y tendrás que mantenerlo; no te acompaña a ningún otro sitio.

Para la mayoría de los equipos, esta vía solo tiene sentido cuando el acortamiento es un paso dentro de un flujo automatizado más grande. Si solo quieres enlaces mientras trabajas, la CLI requiere menos código y menos cosas que mantener en ejecución.

Tercera vía: el chat preconfigurado

La opción sin configuración es un enlace que abre Gemini con la instrucción ya escrita:

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

Ese es el mecanismo detrás de los botones de la página de integraciones con LLM, comprobado en la superficie activa en abril de 2026. El comportamiento de los parámetros de consulta de cualquier producto de IA cambia, así que vuelve a probarlo si un botón deja de hacer lo que hacía.

Conviene ser realista sobre lo que esto te ofrece, teniendo en cuenta la primera sección. El asistente no tiene herramientas, así que redacta y tú ejecutas. Aun así, resulta útil. Un lanzamiento que necesita ocho variantes de UTM con una convención de nombres coherente es tedioso a mano y fácil de hacer bien para un modelo. Simplemente no termina con un enlace.

Qué vía encaja mejor

Lee esta tabla junto a la de ChatGPT y la asimetría es el punto clave. La superficie compartible de ChatGPT es la que puede contener una acción conectada, así que un equipo de marketing puede recibir un GPT personalizado que funciona. La superficie conectada de Gemini es un terminal. Si tus usuarios son profesionales de marketing, esa diferencia decide la plataforma antes que cualquier comparación de funciones.

Mantener la clave con el alcance adecuado

El servidor MCP guarda la credencial y el modelo nunca la ve, que es la estructura correcta. Aun así, eres tú quien decide qué puede hacer la credencial.

Emite una clave por integración en lugar de reutilizar una entre varias herramientas. Una clave para crear enlaces de forma interactiva necesita crear enlaces y leer analítica; no necesita eliminar enlaces ni tocar dominios personalizados. Cuando aparece algo inesperado en el registro de auditoría, una clave por integración te dice qué superficie lo produjo, y revocarla no rompe nada más.

El ámbito del proyecto merece una consideración adicional. Un .gemini/settings.json incluido en un repositorio compartido es práctico, pero también es un archivo que hereda cada colaborador. Mantén el secreto en el entorno y deja el archivo de configuración libre de cualquier cosa que no pegarías en una solicitud de cambios.

Límites honestos

Conviene fijar las expectativas sobre tres cosas.

La superficie de herramientas es pequeña a propósito. @elido/mcp-server está en la versión 0.1.x con cinco herramientas, y la administración del espacio de trabajo no está entre ellas deliberadamente. Invitar a personas, configurar dominios y cambiar de plan se hace en el panel, donde lo hace una persona con la sesión iniciada.

El trabajo masivo pertenece a otro sitio. Pedir cuarenta enlaces en una sola conversación produce errores de límite de tasa y un modelo que pierde la pista de qué slug correspondía a qué destino. Cuando pasen de unos pocos, usa la API o una importación de CSV.

Y la diferencia de la app no es temporal, al menos según lo anunciado hasta ahora. Planifica teniéndola en cuenta en lugar de esperar a que desaparezca. Si un equipo no técnico necesita crear enlaces desde una superficie de chat hoy, la respuesta honesta es otro asistente o el panel, no un Gem.

Lee el artículo principal → Conecta Elido con Claude y Cursor mediante MCP

Relacionado en el blog

• Acortador de URL de ChatGPT: qué funciona y qué lo finge - la misma pregunta, una respuesta diferente.
• Conecta Elido con Claude y Cursor mediante MCP - la referencia completa de MCP en la que se basa este artículo.
• Inicio rápido de la API del acortador de URL - la superficie REST que hay debajo de todas estas vías.
• Enlaces cortos como Terraform - cuando los enlaces pertenecen al código y no a un chat.