Assistants IA

Connecter un assistant

Brancher Claude, Cursor, ChatGPT ou Le Chat sur la passerelle Sage 100 de votre client, puis vérifier que tout fonctionne.

3 min de lectureMis à jour le 1 octobre 2026

La passerelle parle le protocole MCP (Model Context Protocol), le standard qui permet à un assistant IA d'utiliser des outils externes. Il vous faut deux informations :

L'adresse MCP : http://127.0.0.1:8765/mcp sur le serveur lui-même, ou l'adresse publique du relais Maillon ou du tunnel.
Une clé s100_..., créée avec les bons droits. Elle se transmet dans l'en-tête Authorization: Bearer s100_....

Configurer l'assistant

Claude Desktop se branche sur une adresse MCP distante avec une clé grâce à l'utilitaire mcp-remote (Node.js requis). Ouvrez Paramètres › Développeur › Modifier la configuration, puis ajoutez dans claude_desktop_config.json :

{
  "mcpServers": {
    "sage-100": {
      "command": "npx",
      "args": ["mcp-remote", "https://ADRESSE-MCP/mcp", "--header", "Authorization:${MAILLON_CLE}"],
      "env": { "MAILLON_CLE": "Bearer s100_..." }
    }
  }
}

Redémarrez Claude Desktop : les outils sage_... apparaissent dans le menu des outils de la conversation.

Capture à venir

Claude Desktop : le menu des outils affiche le serveur sage-100 et ses outils sage_context, sage_search, sage_get.

public/docs/captures/assistant-claude-desktop-outils.png

Le connecteur sage-100 et ses outils dans Claude Desktop.

Dans un terminal :

claude mcp add --transport http sage-100 https://ADRESSE-MCP/mcp --header "Authorization: Bearer s100_..."

Vérifiez avec claude mcp list, puis demandez « Quels dossiers Sage sont accessibles ? ».

Ajoutez le serveur dans .cursor/mcp.json (projet) ou ~/.cursor/mcp.json (tous les projets) :

{
  "mcpServers": {
    "sage-100": {
      "url": "https://ADRESSE-MCP/mcp",
      "headers": { "Authorization": "Bearer s100_..." }
    }
  }
}

Le serveur apparaît dans Paramètres › MCP, avec la liste de ses outils.

Les assistants utilisés dans le navigateur ajoutent un connecteur personnalisé à partir d'une adresse MCP publique, avec une autorisation OAuth plutôt qu'une clé. L'adresse du client, de la forme https://mcp.maillon.dev/c/…/mcp, est affichée dans la console, sur la vue d'ensemble du client, une fois la passerelle appairée au relais Maillon :

Dans l'assistant, ouvrez les réglages des connecteurs et choisissez Ajouter un connecteur personnalisé.
Collez l'adresse MCP du client.
Connectez-vous à Maillon quand l'assistant vous le demande, puis cliquez sur Autoriser. La page rappelle les droits et les dossiers qui vous ont été attribués.

Accès attribué par l'administrateur

L'autorisation n'est possible que si un administrateur du client, ou votre intégrateur, vous a donné accès dans la page Accès de la console. Les assistants connectés se retrouvent dans Mon compte, où vous pouvez les déconnecter.

Vérifier la connexion

Posez ces trois questions, dans l'ordre, à l'assistant :

« Quels dossiers Sage sont accessibles, et avec quels droits ? » (l'assistant appelle sage_context)
« Donnez-moi les 5 derniers devis du dossier BIJOU. » (appel à sage_search)
« Quel est l'encours du client CARAT ? » (appel à sage_finance)

Capture à venir

Conversation dans un assistant IA : la question sur les dossiers accessibles et la réponse listant le dossier BIJOU avec les droits read et documents.

public/docs/captures/assistant-premiere-question.png

Première question : l'assistant liste les dossiers et les droits de la clé.

Bien régler les validations

Lecture automatique, écriture surveillée

Les assistants compatibles demandent votre accord avant chaque appel d'outil. Vous pouvez autoriser d'office les outils de lecture, qui ne modifient rien. Gardez une validation manuelle sur les outils d'écriture et de suppression : c'est le dernier moment où l'utilisateur voit les valeurs avant qu'elles n'arrivent dans Sage.

Pour tester une écriture sans rien enregistrer, demandez à l'assistant d'utiliser validate_only : Sage vérifie toutes les valeurs et renvoie ses éventuels refus, sans créer de pièce.