Aller au contenu

Intégration API, GraphQL et MCP

Votre site ou votre outil interne doit échanger des données avec d’autres logiciels, offrir une connexion unique (SSO) à vos utilisateurs ou répondre à un assistant IA. Nous écrivons d’abord ce qui circule, puis nous le construisons.

Quand une extension ne suffit plus

Un formulaire doit créer une fiche dans le CRM. Les employés d’un client doivent entrer avec le compte de leur entreprise. Un assistant doit lire le contenu du site, ou déclencher une action, sans qu’on lui donne les accès d’administration.

Une intégration API sur mesure commence par la liste des échanges : qui appelle qui, quelles données passent, à quel moment, et ce qui se passe quand l’autre système ne répond pas. Chaque échange est développé, testé et surveillé, avec des reprises automatiques en cas d’échec. Vous savez à tout moment ce qui circule entre vos outils.

Quatre façons de relier vos systèmes

Chaque mandat reste dans un périmètre écrit. Si vous avez besoin d’un logiciel complet, c’est un projet d’application web.

API REST et GraphQL

Une API REST expose des ressources (pages, fiches, commandes). GraphQL laisse l’autre système demander exactement les champs dont il a besoin. Nous pouvons aussi écrire directement dans l’autre système, par son API, pour créer ou mettre à jour ses données. Le choix dépend des technologies que l’autre système prend déjà en charge.

Serveurs MCP

Un serveur MCP (Model Context Protocol) donne à un assistant IA, comme Claude ou ChatGPT, des outils bornés : lire une fiche, chercher un contenu, créer un brouillon. Vous choisissez les permissions qu’il reçoit, action par action : il ne peut rien faire de plus, ce qui évite les mauvaises surprises.

Authentification unique (SSO)

Vos utilisateurs se connectent une seule fois, avec le compte de leur entreprise (Microsoft, Google ou un autre fournisseur d’identité), en SAML ou OAuth, y compris avec plusieurs fournisseurs sur la même plateforme.

Webhooks et CRM

Un événement de votre site (formulaire, commande, inscription) part vers le CRM ou l’outil métier, avec une reprise si l’appel échoue.

Développement HubSpot

Ce qui est inclus

Spécification écrite

Chaque échange, chaque champ et chaque cas d’erreur sont décrits avant le développement : qui envoie quoi, à quel moment, dans quel format, et ce qui se passe si l’autre système ne répond pas.

Secrets hors du code

Clés et jetons gardés hors du code, dans une configuration protégée, avec des accès limités au strict nécessaire. Pour la sécurité : une fuite du code ne donne accès à rien, et chaque système ne voit que ce qu’il doit voir.

Documentation

Échanges, fonctionnalités et exploitation documentés (configuration, déploiement, surveillance), pour votre équipe ou un autre développeur.

Indépendance

Code, dépôt, comptes et clés d’accès sont à votre nom. Un autre développeur peut reprendre l’intégration à tout moment, documentation à l’appui.

Une intégration en production

Un exemple d’intégration en service, utilisée au quotidien par ses utilisateurs.
Cybersécurité

Vigelia

Authentification unique SAML avec plusieurs fournisseurs d’identité sur l’Académie Vigelia (LearnDash).

  • WordPress
  • LearnDash
  • SAML

Comment se déroule un projet d’intégration

Une analyse de votre projet précède la soumission : systèmes, données échangées, accès et cas d’erreur y sont décrits. Vous savez ce qui circulera entre vos outils avant que le développement commence.

  1. Cadrage

    Systèmes à relier, données échangées, accès et contraintes de sécurité : nous décrivons ce que fera l’intégration.

  2. Spécification

    Chaque échange, chaque champ et chaque cas d’erreur, validés avec vous, et avec l’éditeur de l’autre système si besoin.

  3. Développement et tests

    Développement en préproduction, tests automatisés et essais avec des comptes de test de chaque système.

  4. Mise en production

    Déploiement, surveillance des échanges et des échecs, documentation remise et passation à votre équipe.

Questions sur les intégrations

MCP signifie Model Context Protocol : une norme ouverte qui permet à un assistant IA, comme Claude ou ChatGPT, d’utiliser vos outils. Le serveur MCP lui propose des actions précises : lire, chercher, créer un brouillon. Vous décidez de la liste et des permissions, et l’assistant ne reçoit jamais le mot de passe du site.

REST si l’autre système a déjà des routes prévues, ou si les échanges sont simples. GraphQL si les écrans ont besoin de combinaisons de champs différentes. On le dit dans la spécification, pas après.

Oui, après lecture du code et des accès. Si la technologie sort de notre périmètre, nous le disons au premier échange.

Le prix dépend du nombre d’échanges, des systèmes en jeu et des cas d’erreur à prévoir. La spécification écrite sert de base à une soumission au forfait.

Une intégration relie des systèmes qui existent déjà. Une application web est un logiciel à part : SaaS, outil métier, tableau de bord.

API, GraphQL, MCP, SSO

Parlons de votre intégration

Décrivez les systèmes qui doivent se parler, et ce qu’un utilisateur ou un assistant doit pouvoir faire.