Six situations courantes, une conversation d'exemple pour chacune

À quoi sert une API prête pour les agents ?

Vous avez déjà des API : celles de votre produit, de vos outils internes, de vos partenaires. Apigent les transforme en outils qu'un assistant sait appeler, et vous laisse décider qui peut faire quoi.

Éditeurs de logiciels

Vos clients pilotent votre produit depuis leur assistant

Vos clients utilisent déjà Claude, Cursor ou un agent maison. Ils voudraient y retrouver votre produit sans que vous développiez une intégration par assistant.

Avec Apigent

  • Vous importez l'API que vous exposez déjà et choisissez les opérations offertes aux agents.
  • Vos clients se connectent avec leur compte chez vous : chacun ne voit et n'agit que sur ses données.
  • Une page publique donne l'adresse du serveur et la marche à suivre ; vous révoquez un accès en un clic.
  • Identité de l'éditeur
  • Connexion par utilisateur
  • Page publique
  • Journal par utilisateur
Claude · connecteur « Atelier » branché par un client

Crée un projet « Refonte du site » dans mon espace et invite marie@exemple.fr dessus, en lecture.

  • atelier_create_project201
  • atelier_invite_member200

Projet Refonte du site créé dans votre espace. Marie a reçu une invitation en lecture seule ; elle apparaîtra dans les membres dès qu'elle l'aura acceptée.

Support client

Répondre à un client sans ouvrir quatre outils

Une question simple demande d'aller voir le CRM, les commandes, la facturation et l'historique des tickets. L'information existe, elle est juste éparpillée.

Avec Apigent

  • Plusieurs API dans un même serveur MCP : l'assistant croise ce qu'il lit et rédige la réponse.
  • Lecture seule si vous le décidez : les opérations qui écrivent restent masquées.
  • Le journal montre, appel par appel, ce qui a été consulté et par qui.
  • Plusieurs applications
  • Lecture seule
  • Membres de l'équipe
  • Journal
Claude · serveur « Support » de l'équipe

Où en est la commande de Mme Rey, et a-t-elle une facture en retard ?

  • crm_search_contacts200
  • orders_list_by_customer200
  • billing_list_invoices200

Commande #48213 expédiée hier, livraison prévue jeudi. Une facture de 240 € est échue depuis 12 jours ; les deux précédentes ont été réglées à temps. Voulez-vous que je prépare une réponse ?

Opérations internes

Les gestes du quotidien, avec un garde-fou

Créer un compte, réassigner des tickets, relancer un traitement : des actions répétitives sur des outils d'administration, que l'on aimerait déléguer sans perdre le contrôle.

Avec Apigent

  • Les opérations sont choisies une par une ; ce qui n'est pas exposé n'existe pas pour l'agent.
  • Les outils qui écrivent ou suppriment sont annotés : le client demande confirmation avant d'agir.
  • Appels par minute et taille des réponses bornés, par serveur.
  • Annotations MCP
  • Confirmation avant d'agir
  • Limites
  • Membres
Claude · serveur « Admin » de l'équipe IT

Désactive le compte de Paul Martin et réassigne ses tickets ouverts à l'astreinte.

  • users_search200
  • tickets_list_open200
  • users_deactivateconfirmation demandée

Paul Martin a 4 tickets ouverts. Je vais désactiver son compte puis les réassigner à l'astreinte (Nadia cette semaine). Ces deux actions modifient des données : je confirme ?

Données métier

Poser des questions à vos chiffres

Les chiffres sont derrière une API de reporting ou de données. Chaque question un peu nouvelle finit en export, en tableur, ou en ticket pour l'équipe data.

Avec Apigent

  • L'API de données devient un serveur en lecture seule : l'assistant enchaîne les appels, calcule et présente.
  • Les réponses sont tronquées à la taille que vous fixez : pas de table de 50 000 lignes dans une conversation.
  • Les mêmes outils servent dans Claude pour un directeur et dans Cursor pour un analyste.
  • Lecture seule
  • Réponses bornées
  • Claude · Cursor
Claude · serveur « Reporting »

Le chiffre du mois par région, comparé au même mois l'an dernier ?

  • sales_by_region200 · 2026-08
  • sales_by_region200 · 2025-08

Août 2026 : 1,84 M€, +9 % sur un an. Île-de-France +14 %, Sud-Est +6 %, Nord stable ; l'Ouest recule de 3 %, porté par une seule enseigne en moins. Je détaille par enseigne ?

Développement

Vos propres API à portée de l'IDE

Pour tester un parcours, il faut relire la doc, écrire l'appel, corriger le format, recommencer. L'API du projet est décrite, mais pas à portée de main.

Avec Apigent

  • Le Swagger ou l'OpenAPI du projet, importé tel quel, devient des outils dans Cursor ou Claude Code.
  • Les appels sont justes du premier coup : paramètres, corps et schémas viennent de la description.
  • Un token par client, révocable ; un serveur pour le staging, un autre pour la production si besoin.
  • Import OpenAPI · Swagger · Postman
  • Un token par client
  • Cursor · Claude Code
Cursor · serveur « API staging »

Crée trois commandes de test avec des adresses en Belgique, puis vérifie que le calcul de TVA sort bien 21 %.

  • shop_create_order201 ×3
  • shop_get_order200 ×3

Trois commandes créées (#9021 à #9023). La TVA est bien à 21 % sur les deux premières ; la troisième, livrée en point relais, sort à 20 % : le taux semble venir de l'adresse de facturation, pas de livraison. Je regarde le code du calcul ?

Partenaires

Un accès agent, borné et nominatif

Un partenaire, un prestataire ou un client grand compte veut brancher son agent sur une partie de vos données. Pas toutes, pas pour tout le monde, et pas pour toujours.

Avec Apigent

  • Un serveur dédié qui n'expose que les opérations convenues, trois s'il le faut.
  • Des invités nommés, par adresse email vérifiée, ou un token par partenaire.
  • Révocation en un clic, et le journal de tout ce qui a été appelé, en votre nom ou au leur.
  • Invités
  • Opérations choisies
  • Révocable
  • Journal
Agent du partenaire logistique · serveur « Expéditions »

Les expéditions prévues aujourd'hui, et celles en retard de plus de 24 h.

  • ship_list_today200
  • ship_list_late200

128 expéditions aujourd'hui, dont 3 en retard de plus de 24 h (deux à Lyon, une à Nantes). Je vous envoie le détail des trois retards.

Le vôtre ressemble à l'un de ceux-là ?

Trois étapes, aucune ligne de code : importez la description de l'API, composez le serveur, branchez le client.

Ressources

Pour passer à la pratique.

  • Connecter un client MCP

    Claude Desktop, claude.ai, Claude Code, Cursor, et les clients stdio via mcp-remote.

    Guide
  • Distribuer votre serveur à vos utilisateurs

    Choisir qui peut se connecter, laisser chacun connecter son compte, partager la page publique.

    Guide