Raccourcisseur d'URL Gemini : là où les appels d'outils fonctionnent vraiment

Gemini peut créer un lien court fonctionnel. Mais pas là où la plupart des gens essaient d'abord.

La séparation est plus nette qu'avec les autres assistants, et elle tient à une décision d'architecture prise par Google : l'application Gemini grand public ne dispose d'aucun mécanisme pour appeler une API que vous possédez. Demandez-lui de raccourcir une URL et vous obtenez un slug qui a la bonne forme, mais rien derrière. Gemini CLI est un autre produit, avec une réponse différente, et c'est là que se trouve l'appel d'outil. C'est pourquoi une décision qui ressemble à une préférence entre deux interfaces Google détermine en réalité si votre équipe peut utiliser cette solution.

Cet article couvre les trois interfaces et ce que chacune peut réellement faire : la CLI avec MCP, les appels de fonctions dans l'API Gemini et le chat prérempli. L'article parallèle consacré à ChatGPT aboutit à une conclusion différente, pour des raisons qu'il vaut mieux comprendre avant de choisir une interface.

Pourquoi l'application Gemini ne peut pas créer de lien court

Les Gems sont la fonctionnalité d'assistant personnalisé de Gemini et, à première vue, ressemblent à l'équivalent d'un GPT personnalisé. Mais ils ne le sont pas sur le point qui nous intéresse ici. Les Gems n'ont pas d'équivalent aux Actions. Aucun champ de schéma OpenAPI. Aucune configuration d'authentification. Aucun moyen de relier un Gem à votre propre point de terminaison.

Les Gems peuvent utiliser les extensions de Google : Workspace, Maps et YouTube. Celles-ci sont conçues par Google, et non configurées par vos soins. Le manque de capacité n'est donc pas un retard de maturité qui se résout avec un réglage. Rien de ce que vous écrivez dans les instructions d'un Gem ne lui donne accès à votre API par le réseau.

Aussi l'application fait-elle ce que fait n'importe quel assistant dépourvu d'outils lorsqu'on lui demande un lien court. Elle produit des caractères plausibles. Il vaut mieux le savoir avant de passer un après-midi à essayer de contourner le problème avec des prompts.

Première voie : Gemini CLI avec MCP

Gemini CLI prend en charge le Model Context Protocol, ce qui signifie que le même @elido/mcp-server qui sert Claude Desktop et Cursor fonctionne ici sans code spécifique à Gemini. Configurez-le une fois et create_link, list_links, query_analytics, generate_qr et list_workspaces apparaissent comme des outils appelables.

Ajouter le serveur

La voie rapide passe par la commande intégrée :

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

Vous pouvez aussi modifier directement le fichier de paramètres. La portée utilisateur se trouve dans ~/.gemini/settings.json, la portée projet dans .gemini/settings.json, et le bloc se place sous 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
    }
  }
}

Le détail du développement des variables env qui pose problème

Gemini CLI développe $VAR et ${VAR} à l'intérieur du bloc env, c'est pourquoi la clé ci-dessus est une référence plutôt qu'un secret collé en clair. Utilisez cette méthode. Valider un .gemini/settings.json de portée projet contenant une clé active est une erreur facile à commettre et lente à détecter.

La documentation du serveur MCP de Google signale un piège important : une variable non définie devient une chaîne vide au lieu de déclencher une erreur. Une faute de frappe dans le nom de la variable n'échoue donc pas clairement au démarrage. Elle échoue plus tard, lors du premier appel d'outil, sous la forme d'une erreur d'authentification. J'ai perdu vingt minutes à cause d'un export manquant, à relire le mauvais fichier, parce qu'une erreur d'authentification fait penser aux identifiants plutôt qu'au nom de la variable censée les transporter. Si le serveur se connecte mais que chaque appel revient non autorisé, vérifiez d'abord la variable.

Configurez la clé, et la prochaine note de campagne que vous rédigerez dans le terminal pourra créer ses propres liens : démarrer un espace de travail et générer une clé limitée à cette intégration.

Deuxième voie : appels de fonctions dans l'API Gemini

Si vous construisez quelque chose plutôt que de travailler de manière interactive, les appels de fonctions sont le mécanisme équivalent au niveau de l'API. Vous déclarez la fonction, le modèle renvoie un appel structuré lorsqu'il estime qu'il est justifié, votre code exécute la requête, puis vous lui transmettez le résultat.

La forme est la même que pour toute intégration d'outil. Décrivez create_link, exécutez vous-même la requête HTTP et renvoyez la réponse. Par rapport à MCP, vous gagnez en contrôle. Vous décidez exactement quels paramètres le modèle peut définir et vous pouvez refuser tout ce qui sort de votre convention de nommage avant même que la requête ne quitte votre processus. En contrepartie, vous perdez en portabilité. Cette connexion est à maintenir vous-même et ne vous suit nulle part.

Pour la plupart des équipes, cette voie n'a de sens que lorsque le raccourcissement n'est qu'une étape d'un flux automatisé plus vaste. Si vous voulez simplement créer des liens pendant votre travail, la CLI demande moins de code et moins de processus à maintenir.

Troisième voie : le chat prérempli

L'option sans configuration est un lien qui ouvre Gemini avec le prompt déjà rédigé :

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

C'est le mécanisme qui se trouve derrière les boutons de la page des intégrations LLM, vérifié sur l'interface en ligne en avril 2026. Le comportement des paramètres de requête peut changer sur n'importe quel produit d'IA : refaites donc un test si un bouton cesse de fonctionner comme avant.

Soyez lucide sur ce que cela vous apporte, compte tenu de la première section. L'assistant n'a aucun outil, il prépare donc le contenu et vous l'exécutez. Cela reste utile. Un lancement qui nécessite huit variantes UTM selon une convention de nommage cohérente est fastidieux à faire à la main et facile à faire correctement pour un modèle. Mais le processus ne se termine pas par un lien.

Quelle voie choisir

Lisez ce tableau à côté de celui consacré à ChatGPT : c'est l'asymétrie qui compte. L'interface partageable de ChatGPT est celle qui peut héberger une action connectée, une équipe marketing peut donc recevoir un GPT personnalisé fonctionnel. L'interface connectée de Gemini est un terminal. Si vos utilisateurs sont des spécialistes du marketing, cette différence détermine la plateforme avant toute comparaison de fonctionnalités.

Limiter la portée de la clé

Le serveur MCP conserve les identifiants et le modèle ne les voit jamais, ce qui est la bonne architecture. Il vous reste toutefois à décider ce que ces identifiants peuvent faire.

Attribuez une clé à chaque intégration plutôt que d'en réutiliser une pour plusieurs outils. Une clé destinée à la création interactive de liens doit pouvoir créer des liens et lire les analyses ; elle n'a pas besoin de supprimer des liens ni de toucher aux domaines personnalisés. Lorsqu'un événement inattendu apparaît dans le journal d'audit, une clé propre à l'intégration vous indique quelle interface l'a produit, et sa révocation ne casse rien d'autre.

La portée projet mérite une réflexion supplémentaire. Un .gemini/settings.json validé dans un dépôt partagé est pratique, mais c'est aussi un fichier dont héritent tous les contributeurs. Conservez le secret dans l'environnement et laissez dans le fichier de paramètres uniquement ce que vous accepteriez de coller dans une pull request.

Des limites à connaître

Voici trois points sur lesquels il vaut mieux être clair.

L'ensemble d'outils est volontairement limité. @elido/mcp-server est en version 0.1.x avec cinq outils, et l'administration de l'espace de travail n'en fait délibérément pas partie. Inviter des personnes, configurer des domaines et changer d'offre restent des opérations à effectuer dans le tableau de bord par une personne connectée.

Le travail en volume se fait ailleurs. Demander quarante liens dans une seule conversation produit des erreurs de limite de débit et un modèle qui ne sait plus quel slug correspond à quelle destination. Au-delà de quelques liens, utilisez l'API ou un import CSV.

Et rien n'indique que la limitation de l'application soit temporaire. Tenez-en compte au lieu d'attendre qu'elle disparaisse. Si une équipe non technique doit créer des liens depuis une interface de chat aujourd'hui, la réponse honnête est d'utiliser un autre assistant ou le tableau de bord, pas un Gem.

Consultez l'article de référence → Connecter Elido à Claude et Cursor avec MCP

À lire aussi sur le blog

• Raccourcisseur d'URL ChatGPT : ce qui fonctionne et ce qui fait semblant - la même question, une réponse différente.
• Connecter Elido à Claude et Cursor avec MCP - la référence MCP complète sur laquelle s'appuie cet article.
• Démarrage rapide de l'API de raccourcissement d'URL - l'interface REST sous-jacente à toutes les voies présentées ici.
• Les liens courts comme Terraform - lorsque les liens doivent vivre dans le code plutôt que dans un chat.