Connexions MCP pour les agents personnalisés

Les connexions MCP (Model Context Protocol) permettent à vos agents personnalisés de se connecter en toute sécurité à des applications externes. Avec les connexions MCP, vos agents peuvent lire des informations et prendre des mesures à l’aide de connexions préconfigurées avec des applications telles que Linear, Ramp, Canva, etc., ou se connecter à n’importe quelle application en configurant des connexions MCP personnalisées.

Remarque : les connexions MCP sont disponibles uniquement avec les forfaits Business et Enterprise.

Les connexions MCP permettent aux agents personnalisés d’interagir avec des outils et des services externes via le Model Context Protocol. Les outils MCP fonctionnent avec tous les types de déclencheurs, y compris les exécutions programmées, les exécutions déclenchées en fonction d’événements Notion ou Slack et les exécutions manuelles provenant de discussions ou de @mentions.

Caractéristiques principales :

• Serveurs préconfigurés : connectez-vous rapidement aux applications populaires sans aucune configuration supplémentaire.

• Serveurs personnalisés : connectez-vous à n’importe quel outil prenant en charge un serveur MCP hébergé à l’aide d’URL accessibles au public.

• Personnalisation : les outils pour chaque connexion peuvent être activés ou désactivés, et vous pouvez choisir d’exiger une confirmation avant l’exécution ou de laisser l’exécution se faire automatiquement.

Propriété unique : chaque connexion MCP est unique à un seul agent personnalisé et utilise les identifiants de la personne qui l’a authentifiée. Les connexions ne sont pas partagées entre les agents, même s’ils se connectent au même service.

Cela signifie que :

• Si vous configurez une connexion Figma pour l’agent A, l’agent B aura besoin de sa propre connexion Figma distincte.

• Vous devez vous connecter à chaque serveur MCP pour chaque agent que vous configurez.

• La révocation d’une connexion sur un agent n’affecte pas les autres agents.

Vous pouvez vous connecter aux applications suivantes sans aucune configuration supplémentaire :

• Linear

• Ramp

• Figma

• GitHub

• Stripe

• Sentry

• Attio

• HubSpot

• Amplitude

• Intercom

• Wiz

1. Ouvrez les paramètresde votre agent personnalisé.

2. Accédez à Outils et accès.

3. Cliquez sur Ajouter une connexion → Ajouter.

4. Choisissez un serveur préconfiguré.

5. Suivez les instructions d’authentification pour connecter votre compte.

6. Sélectionnez les outils du serveur que vous souhaitez que votre agent utilise. Ceux-ci varieront en fonction du serveur que vous choisissez.

7. Cliquez sur Enregistrer.

Si vous souhaitez vous connecter à un serveur MCP qui ne figure pas dans la liste préconfigurée :

1. Pour utiliser des connexions MCP d’agent personnalisées, un administrateur ou une administatrice de l’espace de travail doit activer cette option dans Paramètres → IA de Notion → Connecteurs IA → Activer les serveurs MCP personnalisés.

2. Une fois que l’administrateur ou l’administratrice de l’espace de travail a autorisé les connexions MCP personnalisées, ouvrez les paramètresde votre agent personnalisé.

3. Accédez à Outils et accès.

4. Cliquez sur Ajouter une connexion → Serveur MCP personnalisé.

5. Saisissez l’URL du serveur MCP.

6. Donnez un nom à la connexion.

7. Ajoutez toutes les informations d’authentification requises.

8. Cliquez sur Enregistrer.

Les serveurs MCP personnalisés peuvent prendre en charge l’une des méthodes de connexion suivantes ou les deux :

• OAuth

• Authentification basée sur l’en-tête

  (par exemple, clés API ou porteur de jetons)

Certains serveurs OAuth ne prennent pas en charge l’enregistrement dynamique des client·es (DCR, pour Dynamic Client Registration). Cela signifie que Notion doit préenregistrer une application client auprès du service tiers avant que la connexion OAuth puisse fonctionner. Si le serveur que vous souhaitez utiliser ne prend pas en charge le DCR, consultez sa documentation pour voir si vous pouvez utiliser une clé API ou un porteur de jeton à la place. Si aucune des deux options n’est disponible, le serveur MCP ne peut pas être utilisé avec les agents personnalisés.

Vous pouvez décider de la manière dont un agent personnalisé doit utiliser une connexion MCP dans les paramètresde votre agent, sousOutils et accès. Développez l’entrée de connexion MCP pour voir les outils disponibles et déterminer leur fonctionnement. Les outils peuvent être activés ou désactivés à l’aide du bouton adjacent.

Outils de lecture et d’écriture

• Les outils de lecture (par exemple : chercher, récupérer, répertorier, afficher) permettent à l’agent personnalisé de récupérer ou d’afficher des informations sans apporter de modifications aux systèmes externes.

• Les outils d’écriture (par exemple, créer, mettre à jour, supprimer, envoyer, publier) modifient les données dans les systèmes externes. Par défaut, ces outils

  nécessitent une confirmation avant que l’agent n’exécute l’action.

Exécuter automatiquement ou toujours demander

• L’exécution automatique permet à l’outil de fonctionner sans demander de confirmation

  à l’utilisateur ou l’utilisatrice. Ce paramètre est idéal pour les outils de lecture (chercher, récupérer, répertorier, afficher), car ils ne modifient pas les données.

• Toujours demander exige qu’une personne approuve ou annule une action avant son exécution. Il s’agit du paramètre par défaut pour les outils d’écriture (créer, mettre à jour, supprimer, envoyer) afin d’éviter les modifications involontaires.

Pour supprimer une connexion MCP

1. Ouvrez les paramètres de votre agent personnalisé.

2. Accédez à Outils et accès.

3. Trouvez la connexion MCP et cliquez sur Supprimer.

4. Cliquez sur Enregistrer.

5. Testez toujours votre agent après avoir apporté des modifications. Vous pouvez vous reconnecter à tout moment en vous authentifiant à nouveau.

Remarque : si vous supprimez une connexion, l’agent ne pourra plus accéder à ce service et les exécutions planifiées qui dépendent de ce serveur risquent d’échouer. Les flux de travail de votre agent peuvent s’interrompre si vous supprimez une connexion, avant même de cliquer sur Enregistrer.

Les connexions MCP respectent les niveaux d’autorisation utilisateur définis sur votre agent personnalisé. Voici ce que chaque niveau d’autorisation peut faire avec les outils connectés au protocole MCP.

Les utilisateurs disposant des autorisations Accès complet et Peut modifier pour un agent peuvent :

• Ajouter de nouvelles connexions MCP à l’agent

• Discuter avec l’agent et utiliser tous les outils connectés, même s’ils n’ont pas accès aux outils en dehors de l’agent personnalisé

• Afficher le journal d’activité de l’agent et l’utilisation de l’outil MCP

• Supprimer les connexions MCP existantes

• Reconnecter ou mettre à jour les identifiants du serveur MCP

Et pour les connexions MCP qu’ils configurent, les utilisateurs disposant des autorisations Accès complet et Peut modifier peuvent :

• Configurer les outils activés ou désactivés et modifier les paramètres d’exécution des outils (exécution automatique ou toujours demander)

Remarque : une fois qu’une connexion MCP est établie, seule la personne qui a authentifié la connexion MCP peut configurer et mettre à jour les paramètres de l’outil, même si d’autres disposent des autorisations Accès complet ou Peut modifier pour l’agent. L’agent utilise les identifiants et les autorisations de cette personne lorsqu’il accède au service externe.

Les utilisateurs disposant des autorisations Peut voir et Peut interagir avec un agent peuvent :

• Discuter avec l’agent et utiliser tous les outils connectés, même s’ils n’ont pas accès aux outils en dehors de l’agent personnalisé.

• Déclencher des actions de lecture et d’écriture par le biais de l’agent

• Approuver ou annuler les actions d’écriture lorsqu’une confirmation est requise

• Afficher les serveurs MCP connectés (dans les paramètres de l’agent)

Les utilisateurs avec les autorisations Peut voir et interagir ne peuvent pas :

• Ajouter ou supprimer des connexions MCP

• Modifier les outils activés

• Modifier les paramètres d’exécution de l’outil

• Afficher le journal d’activité complet de l’agent

Remarque : les actions d’écriture (comme la création ou la mise à jour d’éléments) nécessitent une confirmation par défaut pour éviter les modifications involontaires. Les utilisateurs verront une instruction indiquant précisément l’action que l’agent entreprendra avant son exécution.

Si les outils n’apparaissent pas après la connexion :

• Actualisez la page des paramètres de l’agent.

• Vérifiez que le serveur MCP s’est authentifié avec succès (cherchez une coche verte ou l’état « Connecté »).

• Vérifiez que le serveur est en ligne et qu’il renvoie les métadonnées de l’outil.

• Essayez de reconnecter le serveur, ou de le déconnecter et de le rajouter.

Si les exécutions de l’agent échouent avec des erreurs MCP :

• Vérifiez l’onglet Activité pour des messages d’erreur spécifiques.

• Vérifiez que votre connexion est toujours valide (les jetons ont peut-être expiré).

• Assurez-vous que la connexion est toujours activée dans les paramètres de l’agent.

• Essayez de reconnecter le serveur MCP pour actualiser les identifiants.

• Mettez à jour les instructions de votre agent pour mentionner le nom du serveur ou de l’outil que vous souhaitez utiliser. Par exemple : « utilise Linear MCP pour récupérer les métadonnées de cette simulation ».