Espace IA · Connecteurs, la couche de récupération

La couche de récupération de l'IA au-delà des frontières des systèmes

Ce que l'IA a vu pour chaque décision passe par la couche des connecteurs. Microsoft Graph, SharePoint, le serveur MCP, le sidecar de planning, l'e-mail entrant, les webhooks sortants, le gestionnaire d'intégrations OAuth. Isolé par organisation, et chaque appel d'outil par l'IA est journalisé avec son entrée, son résultat et la personne derrière.

Authentification OAuth 2.1 + PAT Jetons isolés par organisation Identifiants dans Key Vault

La couche de récupération derrière les décisions de l'IA

Le modèle de décision à trois zones d'Onplana (voir l'article complet (en anglais)) applique dans la zone d'action et propose dans la zone de suggestion. À chaque décision, l'IA raisonne sur un contexte, et l'essentiel de ce contexte ne se trouve pas dans la base de données d'Onplana. Les connecteurs sont la voie par laquelle il arrive.

Chaque appel d'outil par l'IA, depuis l'assistant de l'application ou un agent connecté, est journalisé avec l'outil, son entrée, son résultat, la personne et l'heure. Les propriétaires et administrateurs de l'organisation lisent ces entrées à partir du forfait Enterprise sur la page Audit Logs, sous Agent Activity. Le prompt complet et le contexte récupéré par le modèle ne sont pas conservés : l'entrée montre ce que l'IA a fait, pas tout ce qu'elle a lu.

Tous les connecteurs suivent la même ligne : OAuth là où le système amont l’exige (Microsoft Graph, SharePoint, clouds de fichiers tiers), PAT pour les clients programmatiques (MCP, API REST, webhooks), isolement par organisation dès la création, de sorte qu'un jeton de l'organisation A ne peut ni lire ni écrire dans l'organisation B, et chaque appel d'outil par l'IA qui y passe journalisé.

Sept connecteurs disponibles aujourd'hui

Sens, authentification, forfait et rôle de chacun. La liste des intégrations s'étoffe selon la demande des clients ; les éditeurs avec un fort recoupement passent en premier.

Serveur MCP

BidirectionnelTous les forfaits

Le catalogue d'outils d'Onplana exposé via le Model Context Protocol. Claude Desktop, Cursor, Goose, Continue et tout autre client compatible MCP peuvent se connecter et utiliser 346 outils typés (lire des projets, créer des tâches, saisir des temps, interroger les risques, lancer des revues de gouvernance). Les mêmes contrôles et le même journal que le chat de l'application.

Authentification : OAuth 2.1 avec Dynamic Client Registration (RFC 7591), ou Personal Access Token

Microsoft Graph (M365)

BidirectionnelTous les forfaits, liens de fichiers Professional+

OAuth par utilisateur vers Microsoft Graph pour l'e-mail (Mail.ReadWrite), le calendrier (Calendars.ReadWrite), les publications dans les canaux Teams (ChannelMessage.Send), les fichiers (Files.ReadWrite) et les personnes (User.Read). Les fonctions d'IA s'en servent pour résumer un fil, planifier une réunion avec les parties prenantes, publier des points d'avancement dans les canaux Teams et joindre des documents SharePoint aux tâches.

Authentification : OAuth par utilisateur, jetons renouvelés via lib/oauthTokens.ts, invalid_grant renseigne revokedAt

Sites SharePoint + bibliothèques de documents

EntrantProfessional+

Parcourez les sites SharePoint auxquels la personne a accès et joignez des documents SharePoint aux tâches ou aux projets sans les copier dans Onplana. Mode lié (le fichier reste dans SharePoint, Onplana garde le lien). L'intégration affiche aussi les métadonnées du document dans l'espace de travail du projet.

Authentification : Reprend la portée OAuth de l'utilisateur dans Microsoft Graph

Webhook d'e-mail entrant (boîte du projet)

EntrantTous les forfaits

Chaque projet reçoit une adresse e-mail entrante. Transférez-y un e-mail et il devient une nouvelle tâche, l'objet comme titre et le corps comme description. Une réponse à l'e-mail d'une tâche arrive en commentaire sur cette tâche, et un mot de statut sur sa première ligne peut faire avancer la tâche. Les pièces jointes ne sont pas conservées. Les demandes des parties prenantes ne restent pas dans les boîtes en attendant un tri manuel.

Authentification : Webhook public sur /api/inbound-email, rattaché au projet par l'adresse entrante

Sidecar de planning (import .mpp / .xml / .xer)

EntrantTous les forfaits (outil public)

Importez un fichier Microsoft Project (.mpp, .mpx, .xml MSPDI, .xer Primavera) et le sidecar basé sur MPXJ le transforme en arbre de tâches Onplana : tâches, dépendances (FS/SS/FF/SF + décalage), ExtendedAttributes en champs personnalisés, référence + coût prévu (depuis MSPDI). La détection des risques par l'IA s'exécute ensuite sur le planning importé.

Authentification : Import dans l'application (multer, 50 Mo au maximum) ou la version publique gratuite sur /tools/schedule-health-check

Webhooks sortants

SortantBusiness+

Événements de projets, tâches, commentaires, membres et migrations (project.created, task.status_changed, comment.created, migration.completed et d'autres). Charges signées en HMAC-SHA256, nouvelles tentatives espacées, historique de livraison par point de terminaison. Branchez Onplana sur Zapier, n8n, votre propre chaîne ETL ou votre runbook de réponse aux incidents.

Authentification : Secret par webhook, en-tête de charge signée (X-Webhook-Signature)

Gestionnaire d'intégrations OAuth

BidirectionnelBusiness+

L'interface d'administration de l'organisation pour connecter des services tiers (Google Drive, Microsoft 365 avec OneDrive et SharePoint, Box et Dropbox). Le cycle de vie des jetons passe par lib/oauthTokens.ts : renouvellement quand ils sont périmés, révocation à la déconnexion, marquage comme morts sur invalid_grant. La déconnexion est douce (la ligne est conservée, ses jetons vidés), pas une suppression définitive.

Authentification : Permission au niveau de l'organisation (org.integration.manage, ADMIN et plus par défaut)

Microsoft Planner : gardez Planner, ajoutez le portefeuille

Business+

Les équipes continuent de travailler dans Planner. Reliez leurs plans à un portefeuille Onplana en une seule étape, et chaque plan devient un projet tenu à jour par un abonnement Microsoft Graph : une modification dans Planner fait relire le plan à Onplana, qui recalcule l'avancement et les dates du projet.

  • Un statut pour chaque plan, d'après les dates et le pourcentage d'achèvement de Planner. Un plan sans dates est indiqué comme non évalué.
  • Des dépendances entre tâches de plans différents, choisies depuis le portefeuille et tracées sur sa frise chronologique.
  • Jalons en retard, dépendances menacées, problèmes et risques ouverts sur l’ensemble des plans, chaque ligne menant à l’élément.
  • Intégrations liste les plans reliés avec leur dernière synchronisation, « Synchroniser maintenant » et « Délier ». Planner reste maître des champs des tâches ; Onplana ne réécrit rien.

Authentification : la connexion Microsoft de la personne qui relie, avec les permissions Tasks et Groups ; chaque notification de changement est vérifiée avec un secret conservé par abonnement.

Gardez Planner. Ajoutez le portefeuille.

Authentification + sécurité

Trois éléments qui valent de la même façon pour chaque connecteur.

Identifiants dans Key Vault

Les secrets clients d'Onplana pour les tiers (Microsoft, Google, hCaptcha, Stripe, etc.) sont dans Azure Key Vault, renouvelés à part par l'exploitation. Les jetons OAuth de chaque utilisateur sont chiffrés dans des lignes OauthConnection.

Jetons isolés par organisation

Chaque PAT et chaque jeton OAuth appartient à une seule organisation dès sa création. Les appels des connecteurs ne peuvent pas franchir les frontières d'une organisation, car l'organizationId est lié à la ligne du jeton et n'est jamais lu dans un en-tête de requête.

Une entrée pour chaque appel d'outil par l'IA

Chaque appel d'outil par l'IA via un connecteur écrit son entrée : l'outil, son entrée, son résultat, la personne et l'heure. Les webhooks sortants ajoutent une ligne WebhookDelivery avec le corps complet de la requête et de la réponse + la durée. L'e-mail entrant passe par l'historique habituel des tâches et des commentaires.

Ce que les connecteurs ne font pas

La liste honnête pour cette couche.

Envoyer des e-mails à votre place

L'e-mail Outlook est en brouillon uniquement : une IA écrit le brouillon dans votre propre boîte, et vous le relisez et l'envoyez. Une publication dans un canal Teams n'a pas de brouillon, donc l'outil ne publie pas sans confirmation explicite, et l'agent de l'application ne peut pas publier du tout. Les webhooks sortants se déclenchent sur les événements auxquels vous êtes abonné.

Franchir les frontières d'une organisation

Un PAT ou un jeton OAuth créé dans l'organisation A n'atteint pas les données de l'organisation B. Les personnes membres de plusieurs organisations connectent chacune séparément. C'est imposé côté serveur, sur la ligne du jeton, pas sur l'en-tête de requête.

Contourner les limites du forfait

L'accès aux connecteurs suit le forfait de l'organisation : le serveur MCP, l'e-mail entrant ainsi que l'e-mail, le calendrier et Teams via Microsoft Graph sont disponibles sur tous les forfaits, y compris le forfait gratuit, les liens de fichiers SharePoint et OneDrive à partir du forfait Professional et les webhooks sortants à partir du forfait Business. Le contrôle est côté serveur ; un client MCP peut s'authentifier, mais les appels qui dépassent le forfait renvoient 402 avec le chemin de mise à niveau.

Mener seuls un travail en plusieurs étapes entre systèmes

Les connecteurs exposent des fonctions ; le chat de l'application et les agents externes les pilotent un appel à la fois. Les enchaînements d'agents en plusieurs étapes, qui planifient et exécutent sur de nombreux appels, relèvent de la couche des agents.

Questions fréquentes

Comment les identifiants des connecteurs sont-ils stockés ?

En deux couches. Les secrets propres à Onplana (clés d'API Anthropic, points de terminaison Azure OpenAI, secrets clients OAuth tiers, identifiants SMTP, hCaptcha, Stripe, etc.) sont dans Azure Key Vault, renouvelés à part par l'exploitation. Les jetons OAuth de chaque utilisateur (ses jetons d'accès et de renouvellement Microsoft Graph) sont dans des lignes OauthConnection marquées de l'organisation, chiffrés et renouvelés automatiquement quand ils sont périmés. La déconnexion est une révocation douce : la ligne est conservée et ses jetons sont vidés.

Un connecteur peut-il franchir les frontières entre locataires ?

Non. Chaque appel de connecteur est lié à une seule organisation. Les appels depuis l'application passent par le même middleware withOrganization que l'API REST, si bien que chaque requête porte l'organizationId. Un PAT ou un jeton OAuth appartient à une organisation dès sa création : les appels d'un agent connecté prennent leur organisation dans le jeton, jamais dans un en-tête de requête. Les personnes membres de plusieurs organisations connectent chacune séparément.

Que contient le journal d'un appel de connecteur ?

Chaque appel d'outil par l'IA via un connecteur est journalisé avec l'outil, son entrée, son résultat, la personne et l'heure, et se lit sur la page Audit Logs, sous Agent Activity. Les webhooks sortants écrivent en plus dans WebhookDelivery, avec le corps complet de la requête et de la réponse et la durée. L'e-mail entrant passe par l'historique habituel des tâches et des commentaires. Un relecteur lit la piste sans branchement supplémentaire.

En quoi le serveur MCP diffère-t-il de l'API REST ?

Mêmes fonctions, autre protocole. Le serveur MCP parle Streamable HTTP (le standard de transport MCP) et répond à l'appel MCP tools/list avec un catalogue d'outils typés, si bien que les clients d'agents compatibles MCP découvrent seuls les actions d'Onplana. L'API REST parle HTTP+JSON et est documentée sur /api/openapi.json. Utilisez MCP depuis une session Claude Desktop ou Cursor, et REST depuis un script backend. Les deux appellent les mêmes gestionnaires, avec les mêmes contrôles et le même journal.

Puis-je obtenir un nouveau connecteur livré avec Onplana ?

Aujourd'hui, la liste des connecteurs est celle ci-dessus. Le gestionnaire d'intégrations + le renouvellement OAuth sont réutilisables ; le goulet d'étranglement est la configuration OAuth propre à chaque fournisseur + les définitions d'outils. L'équipe Onplana reçoit les demandes d'intégration à hi@onplana.com ; les éditeurs avec un fort recoupement de clients (par ex. Atlassian, ServiceNow, Salesforce) passent en priorité.

Pourquoi le sidecar de planning figure-t-il parmi les connecteurs ?

Parce qu'il va AU-DELÀ du modèle de données d'Onplana pour lire un format de fichier étranger. Le sidecar MPXJ en Java (une application conteneur distincte) lit les .mpp / .xml / .xer, renvoie la structure lue par HTTP, et la chaîne d'import d'Onplana l'écrit dans l'arbre du projet. C'est un connecteur vers le monde des fichiers Microsoft Project, comme l'intégration SharePoint est un connecteur vers le monde des clouds de documents.

Voyez les connecteurs dans votre organisation

Inscrivez-vous gratuitement, connectez Microsoft Graph ou importez un fichier .mpp en deux minutes, et regardez les fonctions d'IA puiser du contexte dans vos outils.