Aller au contenu principal
AGO

Configurer des agents IA avec le serveur MCP AGO

Connectez Claude Code ou un client MCP à AGO, choisissez les droits et vérifiez les brouillons avant publication. Adresse actuelle et méthode de test.

Mis à jour le 2 min de lecture

Le serveur MCP AGO permet à un assistant IA autorisé de consulter et de configurer un espace AGO. Les outils exposés dépendent des droits accordés à la connexion. Utilisez-le pour préparer les changements depuis votre environnement de développement ; le SDK JavaScript sert ensuite à intégrer l’agent dans l’application de vos clients.

L’adresse et l’authentification ci-dessous ont été vérifiées dans la référence MCP AGO le 11 novembre 2026.

Connecter l’espace avec des droits limités

Pour Claude Code, la configuration documentée est :

claude mcp add --transport http ago \
  https://your-workspace.api.useago.com/api/v1/mcp \
  --header "X-API-Key: YOUR_SCOPED_API_KEY"

Remplacez l’espace et la clé d’exemple par vos paramètres. Créez la clé dans Developer > API Keys, sélectionnez les droits nécessaires et gardez le secret hors du dépôt de code. Les clients OAuth utilisent la connexion décrite dans le guide d’intégration.

Découvrir les outils disponibles dans cet espace

La réponse MCP tools/list dépend de vos droits et des fonctionnalités activées. Si un outil n’apparaît pas, la connexion peut manquer d’une permission ; cela ne prouve pas que la fonctionnalité est absente de tous les espaces.

Commencez par un accès en lecture pour examiner la configuration. Accordez agents_config:write lorsque la tâche prévoit de modifier les agents. Ajoutez les droits sur les connaissances ou les conversations seulement si ces sources sont nécessaires.

Demander un brouillon et un plan de test

Pour un agent de gestion des retours, une demande illustrative serait :

Examine l’agent de support existant et les outils de commande disponibles. Propose un brouillon qui vérifie les conditions de retour, demande les informations manquantes et transmet les exceptions. Liste les changements et les tests avant toute publication.

L’assistant a besoin des vrais outils et des règles métier. Le nom d’une API ne lui permet pas de déduire votre politique de remboursement. Vérifiez les paramètres, les droits et le comportement en cas d’échec de chaque outil.

Le parcours documenté par AGO prépare les modifications dans un brouillon et teste des questions avant et après. Examinez le changement avant sa publication. Une proposition de prompt ne prouve pas que l’intégration a fonctionné.

Séparer la configuration de l’exécution côté client

Un identifiant MCP de gestion peut donner accès à la configuration ou aux données opérationnelles. Il ne doit pas être exposé dans le navigateur du client. L’expérience intégrée utilise l’authentification du SDK et les autorisations de l’application.

Avant publication, testez une demande autorisée, un refus et un outil indisponible. Appuyez-vous sur le guide de sécurité et le plan de test des tickets complexes, puis connectez l’agent avec le démarrage rapide du SDK.

Partager cet article
Maxime Thoonsen

Maxime Thoonsen

Cofondateur

Expert en IA et en opérations client, avec plus de 10 ans d’expérience dans la création de solutions capables de passer à l’échelle.