Documentation

Connecter un agent IA

Donnez à Claude, à ChatGPT ou à tout autre client MCP, connecté en votre nom, les outils pour vos bons de commande, vos factures et vos validations.

Vue d’ensemble

Le serveur MCP de Pleaxy donne à un agent IA, comme Claude ou ChatGPT, des outils pour vos bons de commande, factures, réceptions et validations. Vous le connectez à votre propre compte Pleaxy : il voit ce que vous voyez, dans les espaces de travail que vous choisissez, et chaque modification qu’il effectue est enregistrée à votre nom. Les décisions vous reviennent.

Il existe deux façons de le connecter. Une application qui se connecte aux serveurs MCP par URL, comme claude.ai, les applications Claude ou ChatGPT, utilise le serveur hébergé par Pleaxy, sans rien à installer. Un client MCP sur votre ordinateur, comme Claude Desktop, Claude Code ou Cursor, peut exécuter le serveur lui-même avec npx. Dans les deux cas, la connexion se fait de la même manière : Pleaxy s’ouvre dans votre navigateur, vous vous connectez, cochez les espaces de travail et autorisez l’agent.

Connecter une application par URL

Dans les paramètres de connecteurs de votre application, ajoutez un connecteur personnalisé avec cette adresse. Il n’y a ni ID client ni clé à saisir : l’application s’enregistre elle-même auprès de Pleaxy.

connector URL
https://mcp.pleaxy.ai/mcp
  1. Connectez. L’application ouvre Pleaxy dans votre navigateur. Connectez-vous comme d’habitude : mot de passe, clé d’accès ou authentification unique de votre entreprise.
  2. Choisissez les espaces de travail. Pleaxy indique quelle application fait la demande et vers où elle vous renverra. Cochez les espaces de travail que l’agent peut utiliser et sélectionnez Autoriser.
  3. Utilisez-le. De retour dans l’application, posez vos questions sur vos bons de commande ou vos factures. L’application conserve la connexion : vous n’avez pas à vous reconnecter pendant 30 jours.

L’exécuter sur votre ordinateur

Le serveur est publié sur npm sous le nom pleaxy-mcp et nécessite Node.js 22.18 ou version ultérieure. Connectez-le une fois depuis un terminal : Pleaxy s’ouvre dans votre navigateur, où vous vous connectez, cochez les espaces de travail et autorisez l’agent.

shell
export PLEAXY_API_BASE_URL="https://api.pleaxy.ai"
npx -y pleaxy-mcp login     # opens Pleaxy: sign in, tick the workspaces, Allow
npx -y pleaxy-mcp whoami    # who the server acts as, and its workspaces
npx -y pleaxy-mcp logout    # disconnects it

Ajoutez-le ensuite à la configuration de votre client MCP. Sans clé API définie, le serveur agit en votre nom. La connexion est stockée sur votre ordinateur, lisible par vous seul, et tous les clients MCP de cet ordinateur qui exécutent le serveur la partagent.

mcp config · json
{
  "mcpServers": {
    "pleaxy": {
      "command": "npx",
      "args": ["-y", "pleaxy-mcp"],
      "env": {
        "PLEAXY_API_BASE_URL": "https://api.pleaxy.ai"
      }
    }
  }
}

Espaces de travail

Un agent n’utilise que les espaces de travail que vous avez cochés en le connectant. Chaque outil prend un workspace, et list_workspaces les liste, de sorte qu’une seule connexion fonctionne pour tous. Si un seul espace de travail est autorisé, l’agent utilise celui-là.

Pour ajouter ou retirer un espace de travail, connectez à nouveau l’agent et cochez une autre sélection. Si vous perdez l’accès à un espace de travail dans Pleaxy, l’agent le perd aussi.

Ce qu’un agent peut faire

Un agent peut consulter et préparer tout ce que votre rôle permet : rechercher des bons de commande et des factures, vérifier les dépenses d’IA, rapprocher une facture, créer une demande d’achat. Les décisions, c’est autre chose. Valider ou refuser une facture, transmettre un écart en validation, enregistrer un paiement, créer ou valider un bon de commande, confirmer une réception, statuer sur une fiche de saisie de services et fixer le plafond de dépenses d’un fournisseur d’IA, ainsi que, pour un fournisseur, confirmer qu’un paiement est arrivé ou signaler qu’il ne l’est pas, vous sont envoyés sous forme de demandes d’agent. Vous confirmez ou annulez chacune d’elles dans Pleaxy dans les 24 heures, et rien ne se passe tant que vous ne l’avez pas fait. Refuser un bon de commande dont l’étape de validation vous désigne prend effet immédiatement, comme dans Pleaxy Assistant.

Un agent ne confirme jamais ses propres demandes, et il ne peut pas modifier vos paramètres de sécurité, vos clés API ni les membres de l’espace de travail. Pleaxy enregistre chaque modification qu’un agent effectue ou demande.

Vos agents connectés

Pleaxy vous prévient chaque fois qu’un agent se connecte à votre compte. Vous retrouvez chaque agent connecté, avec l’application dans laquelle il s’exécute, ses espaces de travail et sa dernière utilisation, dans Pleaxy sous Sécurité et connexion → Agents, où vous pouvez déconnecter chacun d’eux.

Une connexion dure 30 jours. Elle prend fin plus tôt si vous déconnectez l’agent, réinitialisez votre mot de passe, désactivez la validation en deux étapes ou si votre accès à Pleaxy est verrouillé. Connectez-le alors à nouveau. Vous pouvez avoir jusqu’à 20 agents connectés.

Intégrations avec une clé API

Pour une intégration qui fonctionne sans intervention humaine, le serveur sur votre ordinateur peut utiliser une clé API d’espace de travail au lieu de votre connexion (voir Agents IA (MCP)). Une clé agit dans un seul espace de travail, et les décisions lui sont refusées : elles nécessitent une personne. Le serveur hébergé n’accepte pas les clés API.

Nous contacter