Connexions MCP pour les agents personnalisés

Les connexions MCP (Model Context Protocol) permettent à votre agent personnalisé de se connecter en toute sécurité à des applications externes. Grâce aux connexions MCP, votre agent peut lire des informations et effectuer des actions en utilisant des connexions préconfigurées avec des applications telles que Linear, Ramp, Figma, et plus encore, 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 services externes via le Model Context Protocol. Les outils MCP fonctionnent avec tous les types de déclencheurs, y compris les exécutions planifiées, les exécutions déclenchées par des événements Notion ou Slack, et les exécutions manuelles depuis une discussion ou des @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, de laisser l’exécution se faire automatiquement ou d’autoriser en permanence tous les outils d’un serveur.

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 :

• Amplitude

• Attio

• Box

• ClickHouse

• Figma

• GitHub

• HubSpot

• Intercom

• Linear

• Mercury

• Miro

• Mixpanel

• n8n

• Ramp

• Stripe

• Sentry

• Wiz

1. Ouvrez les paramètres de 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 Connecter.

Pour se connecter à un serveur MCP qui ne figure pas dans la liste préconfigurée, un administrateur de l’espace de travail doit d’abord activer cette option. Il existe deux paramètres distincts : l’un pour autoriser les serveurs MCP personnalisés, et l’autre pour décider si les membres peuvent installer n’importe quelle connexion ou uniquement celles que vous approuvez.

Pour autoriser des serveurs MCP personnalisés :

1. En tant qu’administrateur de l’espace de travail, accédez à Paramètres → Connexions.

2. Dans l’onglet Gérer, activez Activer les serveurs MCP personnalisés.

Pour choisir si les membres peuvent installer n’importe quelle connexion ou uniquement les connexions approuvées par l’administrateur :

1. En tant qu’administrateur de l’espace de travail, accédez à Paramètres → Connexions.

2. Dans l’onglet Gérer, recherchez la section Gérer les autorisations.

3. À côté de Limiter les connexions que les membres peuvent installer, choisissez une option :

   • Approuvées et recommandées : approuvez automatiquement toutes les connexions recommandées par Notion.

   • Approuvées uniquement : sélectionnez manuellement chaque connexion que les membres peuvent installer.

4. Sélectionnez Connexions approuvées pour examiner ce que les membres peuvent installer.

5. Sélectionnez Ajouter une connexion approuvée, puis choisissez ce que vous souhaitez autoriser :

   • Connexions : recherchez une connexion par nom ou par ID et ajoutez-la à la liste approuvée.

   • Serveur MCP personnalisé : ajoutez une URL de serveur MCP personnalisé spécifique que vous souhaitez autoriser.

6. Cliquez sur Enregistrer.

Une fois cela défini, toute personne dans l’espace de travail peut se connecter aux options approuvées lors de la configuration d’un agent personnalisé. Elles s’authentifieront avec leurs propres identifiants.

Pour ajouter un serveur MCP personnalisé à un agent personnalisé :

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

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

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

4. Vous devrez saisir l’URL du serveur MCP de l’outil ou du fournisseur auquel vous vous connectez (par exemple : l’équipe de l’outil interne de votre entreprise).

5. Donnez un nom à la connexion (Facultatif).

6. Ajoutez toutes les informations d’authentification requises.

7. Cliquez sur Connecter.

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 de client (DCR). Cela signifie que Notion doit pré-enregistrer une application cliente auprès du service tiers avant que la connexion OAuth ne 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 jeton porteur à la place. Si aucune de ces options n’est disponible, le serveur MCP ne peut pas être utilisé avec des agents personnalisés.

Vous pouvez décider de la manière dont un agent personnalisé doit utiliser une connexion MCP dans les paramètres de votre agent, sous Outils et accès. Développez l’entrée de la connexion MCP pour voir les outils disponibles et déterminer comment ils s’exécutent. Les outils peuvent être activés ou désactivés à l’aide du Menu dépliant 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 (ex. : créer, mettre à jour, supprimer, envoyer, publication) apportent des modifications aux données dans des systèmes externes. Par défaut, ils nécessitent une confirmationavant que l’agent n’exécute l’action.

Exécuter automatiquement ou toujours demander

• Exécution automatique permet à l’outil de procéder à l’exécution sans nécessiter de confirmation de la part de l’utilisateur. Ce paramètre est idéal pour les outils de lecture (Chercher, récupérer, liste, vue) car ils ne modifient pas les données.

• Toujours demander exige qu’un utilisateur approuve ou annule une action avant qu’elle ne s’exécute. 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.

• Toujours autoriser approuve de manière permanente tous les outils d’un serveur et supprime les futures demandes de confirmation.

Pour supprimer une connexion MCP

1. Ouvrez les paramètres de votre agent.

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

3. Trouvez la connexion MCP et cliquez sur Déconnecter.

4. Cliquez sur Déconnecter pour confirmer.

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

Remarque : Si vous supprimez une connexion, l’agent ne peut plus accéder à ce service et les exécutions planifiées qui dépendent de ce serveur peuvent échouer. Les flux de travail de votre agent pourraient être interrompus dès que vous vous déconnectez. Vous pouvez vous reconnecter à tout moment en vous authentifiant à nouveau.

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 via MCP.

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

• Ajouter de nouvelles connexions MCP à l’agent personnalisé.

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

• 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 authentifie la connexion MCP peut configurer et mettre à jour les paramètres des outils, même si d’autres personnes disposent des autorisations Accès complet ou Peut modifier pour l’agent personnalisé. L’agent utilise les identifiants et les autorisations de cette personne lors de l’accès au service externe.

Les utilisateurs disposant des autorisations Peut voir et interagir pour un agent personnalisé peuvent :

• Discutez avec l’agent personnalisé et utilisez 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 via l’agent.

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

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

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

• Ajouter ou supprimer des connexions MCP.

• Modifier les outils à activer.

• 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 toute modification involontaire. Les utilisateurs verront une instruction indiquant exactement l’action que l’agent va effectuer avant qu’il ne l’exécute.

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 l’exécution de l’agent personnalisé échoue 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 personnalisé pour mentionner le nom du serveur ou de l’outil que vous souhaitez utiliser. Par exemple : « Utilisez Linear MCP pour récupérer les métadonnées de ce mock. »