Connecter un assistant IA externe

À quoi ça sert

Connecter un assistant IA externe consiste à lui donner l'adresse du serveur MCP de Deltia, puis à l'autoriser à agir avec votre compte. L'opération se fait une fois par outil et par poste.

L'onglet « Assistants IA (MCP) » vous donne tout ce qu'il faut : l'adresse à coller, et un exemple de configuration pour Claude Desktop, Claude Code, Cursor et VS Code. L'autorisation, elle, passe par votre navigateur : vous vous connectez à Deltia comme d'habitude, puis vous validez l'accès demandé par l'application.

Concepts clés

• URL du serveur MCP — l'adresse affichée dans l'onglet « Assistants IA (MCP) ». Elle se termine par /api/mcp et reprend l'adresse par laquelle vous accédez à Deltia. C'est la seule valeur à fournir à votre client, quel qu'il soit.
• Transport HTTP — le mode de connexion à choisir dans votre client. Selon l'outil, il s'appelle streamable-http ou http.
• Autorisation d'accès — la page qui s'ouvre dans votre navigateur au premier appel. Elle nomme l'application qui demande l'accès, votre adresse e-mail et la permission demandée.
• Contexte de l'organisation — le texte de présentation de l'entreprise rédigé par les administrateurs de votre organisation. Deltia le transmet à votre client à la connexion, pour que l'assistant comprenne le métier et le vocabulaire de l'organisation ; il ne donne accès à aucune donnée de plus.
• Client OAuth — l'application que vous avez autorisée. Son nom est celui que votre outil déclare ; il apparaît ensuite dans le journal d'audit.

Comment faire

Récupérer l'URL du serveur

1. Cliquez sur votre avatar, puis sur « Mon profil » et sur l'onglet « Assistants IA (MCP) ».
2. Dans la carte « URL du serveur MCP », cliquez sur l'adresse affichée : elle est copiée dans le presse-papiers, et le message « URL copiée » s'affiche.

L'adresse a la forme https://exemple.deltia.co/api/mcp. Utilisez celle qui s'affiche sur votre page, pas une adresse recopiée d'ailleurs.

Autoriser l'accès

1. Configurez votre client avec l'URL (voir les sections suivantes), puis démarrez-le.
2. Au premier appel, votre navigateur s'ouvre sur Deltia. Connectez-vous si vous ne l'êtes pas déjà.
3. La page « Autorisation d'accès » indique l'application qui demande l'accès et la permission demandée : « Interagir avec vos taches Deltia (consulter, créer, modifier) en votre nom ».
4. Cliquez sur « Autoriser ».

Vous êtes renvoyé vers votre client, qui peut désormais appeler Deltia. « Refuser » interrompt la connexion sans rien accorder.

Cette page décrit le serveur MCP « métier ». Le serveur MCP d'administration a sa propre adresse et demande une autre permission, « Administrer la configuration de Deltia (organisation et modules selon vos droits d'administrateur) en votre nom » : voir MCP Administration.

Configurer Claude Desktop

1. Ouvrez le fichier de configuration de Claude Desktop :
   • macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows : %APPDATA%\Claude\claude_desktop_config.json
2. Ajoutez l'entrée suivante sous mcpServers, en remplaçant l'adresse par celle de votre onglet « Assistants IA (MCP) ».

{
  "mcpServers": {
    "deltia": {
      "type": "streamable-http",
      "url": "https://exemple.deltia.co/api/mcp"
    }
  }
}

3. Redémarrez Claude Desktop, puis lancez une demande portant sur vos données Deltia pour déclencher l'autorisation.

Configurer Claude Code

1. Placez-vous à la racine de votre projet.
2. Exécutez la commande affichée dans l'onglet « Assistants IA (MCP) », avec votre adresse :

claude mcp add --transport http --scope project deltia https://exemple.deltia.co/api/mcp

3. Vérifiez avec claude mcp list que le serveur est bien listé.
4. Relancez Claude Code pour activer la connexion.

Le choix project enregistre la configuration dans un fichier .mcp.json versionné avec le reste du code, partagé entre les collaborateurs du projet. user enregistre à la place une configuration globale à votre machine. Le fichier ne contient que l'adresse : chaque collaborateur s'autorise avec son propre compte.

Configurer Cursor

1. Ouvrez Cursor, puis « Settings », « MCP », « Add MCP server ».
2. Renseignez le nom du serveur.
3. Collez l'URL du serveur MCP.
4. Choisissez le type streamable-http.

Configurer VS Code

1. Créez le fichier .vscode/mcp.json à la racine de votre projet.
2. Renseignez-y l'entrée suivante, avec votre adresse :

{
  "servers": {
    "deltia": {
      "type": "http",
      "url": "https://exemple.deltia.co/api/mcp"
    }
  }
}

3. Redémarrez l'éditeur.

Cette configuration vise GitHub Copilot Chat.

Tester la connexion sans éditeur

1. Lancez npx @modelcontextprotocol/inspector.
2. Collez l'URL du serveur MCP.

MCP Inspector permet de vérifier le déroulement de l'autorisation avant de configurer un vrai client. Utile quand une connexion échoue et que vous ne savez pas si le problème vient de l'outil ou du compte.

Référence

Valeurs à renseigner selon le client

L'URL est la même dans tous les cas : celle affichée dans l'onglet « Assistants IA (MCP) ».

Conditions pour que la connexion aboutisse

Un compte désactivé ou supprimé perd immédiatement l'accès, sans qu'il soit nécessaire de révoquer quoi que ce soit dans le client.

Durée de l'autorisation

L'autorisation accordée reste valable 30 jours et votre client la renouvelle tout seul ; le droit de renouvellement expire au bout de 90 jours. Après une longue période sans utilisation, la page d'autorisation s'ouvre à nouveau.

Une autorisation expirée est refusée dès l'appel suivant : votre client la renouvelle alors, ou la page d'autorisation s'ouvre à nouveau.

L'organisation associée à votre compte est recalculée à chaque appel : changer d'organisation ne laisse pas votre ancien accès ouvert.

Questions fréquentes

Dois-je saisir un mot de passe dans mon client ? Non. Aucun identifiant Deltia n'est stocké dans le fichier de configuration : seule l'adresse du serveur y figure. La connexion se fait dans le navigateur.

Puis-je connecter plusieurs outils en même temps ? Oui. Chaque outil s'autorise séparément et apparaît sous son propre nom dans le journal d'audit. Voir Consulter le journal d'audit.

Puis-je partager mon fichier de configuration avec un collègue ? Oui, il ne contient que l'adresse du serveur. Votre collègue devra s'autoriser avec son propre compte, et n'aura accès qu'à ses propres données.

Existe-t-il une page pour révoquer une autorisation ? Pas pour l'instant. Retirez la configuration de votre client, ou demandez à un administrateur de retirer le module MCP de votre compte.

Que se passe-t-il si le module MCP est retiré de mon compte ? Les appels de votre client sont refusés dès la demande suivante, même si son autorisation n'a pas expiré.