Connecter Gemini à digna¶
Ce guide connecte les outils Gemini de Google au digna MCP Server. Vous avez besoin du point de terminaison MCP de votre installation digna et d'une clé d'API, comme décrit dans la présentation des agents IA.
Les exemples utilisent https://digna.example.com/mcp comme point de terminaison. Remplacez-le par le vôtre.
Choisir votre outil¶
| Outil | Pour | Configuration |
|---|---|---|
| Antigravity CLI, IDE et application | Les outils d'agent de Google. Antigravity CLI a remplacé Gemini CLI pour les comptes Google individuels en juin 2026 | mcp_config.json |
| Gemini CLI | Licences Gemini Code Assist Standard et Enterprise, et clés d'API Gemini payantes | settings.json ou gemini mcp add |
| Application Gemini Enterprise | — | Non pris en charge. Son connecteur MCP personnalisé se connecte avec OAuth ou un compte de service Google Cloud, alors que le digna MCP Server s'authentifie avec des clés d'API |
Tous ces outils se connectent depuis la machine sur laquelle ils s'exécutent ; ils fonctionnent donc avec digna au sein du réseau de votre entreprise, tant que cette machine peut joindre le point de terminaison.
Antigravity¶
Antigravity lit ses serveurs MCP dans mcp_config.json, partagé par la CLI, l'IDE et l'application.
1. Ouvrir mcp_config.json¶
| Portée | Fichier |
|---|---|
| Tous vos projets | ~/.gemini/config/mcp_config.json |
| Un espace de travail | .agents/mcp_config.json dans l'espace de travail |
Pour ouvrir le fichier utilisé :
- CLI : tapez
/mcpet appuyez sur Enter pour ouvrir le gestionnaire MCP. - IDE : dans le panneau latéral de l'agent, ouvrez le menu …, sélectionnez MCP Servers, puis Manage MCP Servers, puis View raw config.
- Application : allez dans Customizations > Installed > MCP Servers et utilisez Copy Config File Path.
2. Ajouter le serveur digna¶
Ajoutez l'entrée digna. Si le fichier contient déjà une section mcpServers, ajoutez-la à celle-ci :
{
"mcpServers": {
"digna": {
"serverUrl": "https://digna.example.com/mcp",
"headers": {
"Authorization": "Bearer <api key>"
}
}
}
}
Antigravity n'atteint les serveurs distants qu'en HTTP streamable, le transport qu'utilise le digna MCP Server. Indiquez le point de terminaison dans serverUrl ; la clé httpUrl de Gemini CLI n'est pas prise en charge.
3. Vérifier la connexion¶
Dans la CLI, tapez /mcp : le gestionnaire MCP affiche le serveur digna avec son état et ses outils, et peut recharger la configuration et afficher les journaux de connexion. Dans l'IDE, le serveur apparaît sous Manage MCP Servers.
Protégez le fichier
mcp_config.json contient la clé d'API en clair. Gardez un fichier d'espace de travail .agents/mcp_config.json hors du contrôle de version, et ne permettez qu'à votre propre compte de lire le fichier global.
Gemini CLI¶
1. Ajouter le serveur¶
Placez la clé d'API dans une variable d'environnement, puis ajoutez le serveur :
export DIGNA_API_KEY='<api key>'
gemini mcp add --transport http --scope user --header "Authorization: Bearer $DIGNA_API_KEY" digna https://digna.example.com/mcp
Votre shell remplace $DIGNA_API_KEY par sa valeur lorsque vous exécutez la commande ; Gemini CLI enregistre donc la clé dans ses paramètres. Sans --scope user, le serveur est ajouté uniquement au projet actuel.
2. Ou modifier settings.json¶
La commande ci-dessus écrit dans settings.json. Pour modifier le fichier vous-même :
| Portée | Fichier |
|---|---|
| Tous vos projets | ~/.gemini/settings.json |
| Un projet | .gemini/settings.json dans le projet |
{
"mcpServers": {
"digna": {
"httpUrl": "https://digna.example.com/mcp",
"headers": {
"Authorization": "Bearer <api key>"
}
}
}
}
Utilisez httpUrl, la clé pour le HTTP streamable. La clé voisine url sélectionne l'ancien transport SSE, que le digna MCP Server ne propose pas. N'utilisez pas de tiret bas dans le nom du serveur.
Laissez trust désactivé
Gemini CLI demande confirmation avant chaque appel d'outil, sauf si le serveur a "trust": true. Laissez trust désactivé pour digna, afin de confirmer chaque modification qu'un agent apporte à votre configuration.
3. Vérifier la connexion¶
Depuis votre shell :
Le serveur digna doit apparaître comme connecté. Dans une session Gemini CLI, exécutez /mcp pour voir le serveur et ses outils.
Dépannage de Gemini¶
Le serveur apparaît comme déconnecté¶
- Vérifiez que le point de terminaison se termine par
/mcpet qu'il est joignable depuis votre machine. - Vérifiez le nom de la clé :
serverUrldans Antigravity,httpUrldans Gemini CLI. - Un
401signifie que la clé a été refusée ; voir 401 Unauthorized.
Gemini CLI ne démarre plus pour mon compte¶
Depuis juin 2026, les comptes Google individuels utilisent Antigravity CLI au lieu de Gemini CLI. Déplacez l'entrée digna vers mcp_config.json comme décrit sous Antigravity, et renommez httpUrl en serverUrl.
Voir aussi¶
- Présentation des agents IA : point de terminaison, clé d'API, sécurité et dépannage général
- Claude : connecter Claude Code, Claude Desktop ou un connecteur personnalisé
- digna Agentic : ce que les agents IA peuvent faire avec digna