Connecter Claude à digna¶

Ce guide connecte Claude 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 le mode de connexion¶

Pour une installation digna qui s'exécute au sein du réseau de votre entreprise, utilisez Claude Code ou Claude Desktop avec une passerelle locale.

Claude Code¶

1. Ajouter le serveur¶

Placez la clé d'API dans une variable d'environnement, puis ajoutez le serveur :

export DIGNA_API_KEY='<api key>'
claude mcp add --transport http --scope user digna https://digna.example.com/mcp --header "Authorization: Bearer $DIGNA_API_KEY"

Votre shell remplace $DIGNA_API_KEY par sa valeur lorsque vous exécutez la commande ; Claude Code enregistre donc la clé dans sa propre configuration.

--scope détermine où le serveur est disponible :

2. Partager le serveur avec votre équipe (facultatif)¶

Pour fournir le même serveur à toutes les personnes d'un projet, ajoutez un fichier .mcp.json à la racine du projet. N'écrivez pas la clé dans le fichier. Claude Code remplace ${DIGNA_API_KEY} à partir de l'environnement de chaque personne :

{
  "mcpServers": {
    "digna": {
      "type": "http",
      "url": "https://digna.example.com/mcp",
      "headers": {
        "Authorization": "Bearer ${DIGNA_API_KEY}"
      }
    }
  }
}

Chaque personne définit DIGNA_API_KEY avec sa propre clé. La première fois que Claude Code trouve le fichier, il demande s'il faut utiliser les serveurs qu'il contient.

3. Vérifier la connexion¶

Depuis votre shell :

claude mcp list

Le serveur digna doit afficher ✔ Connected. Dans une session Claude Code, exécutez /mcp pour voir le serveur et ses outils.

Claude Desktop avec une passerelle locale¶

Le fichier de configuration de Claude Desktop démarre des serveurs MCP locaux sur votre machine. Une petite passerelle, le paquet open source mcp-remote, s'y exécute et transmet chaque requête au point de terminaison digna avec votre clé d'API. Comme la passerelle s'exécute sur votre machine, cela fonctionne avec digna au sein du réseau de votre entreprise.

1. Installer Node.js¶

La passerelle nécessite Node.js 18 ou ultérieur. Claude Desktop utilise la version de Node.js installée sur votre système. Vérifiez-la avec :

node --version

2. Modifier le fichier de configuration¶

Ouvrez claude_desktop_config.json :

• macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows : %APPDATA%\Claude\claude_desktop_config.json

Ajoutez le serveur digna. Si le fichier contient déjà une section mcpServers, ajoutez-y l'entrée digna :

{
  "mcpServers": {
    "digna": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://digna.example.com/mcp",
        "--transport",
        "http-only",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer <api key>"
      }
    }
  }
}

3. Redémarrer Claude Desktop¶

Quittez complètement Claude Desktop et relancez-le. Dans une nouvelle conversation, cliquez sur + et ouvrez Connectors : digna doit y figurer et être activé.

Connecteur personnalisé¶

Un connecteur personnalisé rend digna disponible dans claude.ai, Claude Desktop et les applications mobiles Claude, sans aucune configuration locale. C'est le cloud d'Anthropic qui se connecte au point de terminaison ; cela ne fonctionne donc que si :

• Le point de terminaison digna est joignable depuis Internet en HTTPS
• Votre organisation Claude dispose de l'option Request headers dans la boîte de dialogue Add custom connector. Anthropic la propose en bêta à un nombre limité d'organisations

1. Ouvrir les paramètres des connecteurs¶

• Forfaits Free, Pro, Max et Ultra : allez dans Customize > Connectors et cliquez sur Add custom connector.
• Forfaits Team et Enterprise : un Owner va dans Organization settings > Connectors, clique sur Add, puis sur Custom, et choisit Web si le type est demandé.

2. Saisir les détails du connecteur¶

1. MCP server URL : https://digna.example.com/mcp
2. Authentication : No sign-in
3. Request headers : choisissez authorization comme nom d'en-tête, saisissez Bearer <api key> comme valeur, y compris le mot Bearer et l'espace, et cochez Required.
4. Cliquez sur Add.

Avec les forfaits Team et Enterprise, les membres se connectent ensuite sous Customize > Connectors, où le connecteur porte le libellé Custom.

Claude ne peut pas modifier l'en-tête d'un connecteur existant. Pour utiliser une nouvelle clé, supprimez le connecteur et ajoutez-le à nouveau.

Dépannage de Claude¶

claude mcp list affiche Failed to connect¶

Exécutez claude mcp get digna pour en voir la raison. Un 401 signifie que la clé a été refusée ; voir 401 Unauthorized. Claude Code signale aussi les espaces ou un saut de ligne au début ou à la fin de la clé, qui apparaissent souvent lors du copier-coller.

digna n'apparaît pas dans Claude Desktop¶

• Vérifiez que Node.js 18 ou ultérieur est installé : node --version.
• Vérifiez que claude_desktop_config.json est un JSON valide. Une virgule manquante empêche le chargement de tous les serveurs du fichier.
• Quittez complètement Claude Desktop, pas seulement la fenêtre, et relancez-le.

Le connecteur personnalisé ne parvient pas à joindre le serveur¶

Le cloud d'Anthropic ne parvient pas à joindre le point de terminaison. Vérifiez qu'il est joignable depuis Internet en HTTPS avec un certificat valide, ou connectez-vous plutôt via Claude Code.

Voir aussi¶

• Présentation des agents IA : point de terminaison, clé d'API, sécurité et dépannage général
• Gemini : connecter Antigravity ou Gemini CLI
• digna Agentic : ce que les agents IA peuvent faire avec digna