Comment connecter les pièces actives au MCP étape par étape

Connecter Activepieces à MCP vous permet d'utiliser un assistant d'intelligence artificielle pour Créer, examiner et tester des automatisations en utilisant le langage naturel.Au lieu de créer manuellement chaque étape à partir de l'éditeur visuel, vous pouvez demander à l'assistant d'examiner les intégrations disponibles, de configurer un brouillon et de détecter les erreurs avant la publication.

Activepieces intègre son propre serveur compatible avec le Protocole de contexte modèleCe serveur fait office d'interface standardisée entre la plateforme d'automatisation et les clients tels que Claude Desktop, Claude.ai, Cursor ou Windsurf.

L'intégration actuelle va bien au-delà de la simple exposition de quelques actions. L'assistant peut interroger la structure du flux, rechercher des actions et des déclencheurs, gérer des tables, analyser les exécutions ayant échoué et, si vous lui accordez les autorisations appropriées, modifier ou publier des automatisations complètes.

Que vous permet de faire le serveur Activepieces MCP ?

Le serveur Activepieces MCP permet à un assistant compatible de travailler sur un projet au sein de la plateforme. Sa fonction principale n'est pas de remplacer le moteur d'automatisation, mais de fournir au modèle un ensemble d'outils contrôlés pour examiner et gérer les flux à travers une conversation.

Par exemple, vous pouvez lui demander de faire ce qui suit :

• Répertoriez les flux existants et vérifiez lesquels sont activés.
• Lisez la structure et la configuration d'une automatisation.
• Trouver l'action appropriée pour une tâche donnée.
• Créez un flux complet avec son déclencheur et ses actions.
• Ajoutez des conditions, des boucles ou des branches à un flux existant.
• Validez la configuration avant de la publier.
• Essayez chaque étape individuellement et examinez vos résultats.
• Examinez les exécutions ayant échoué et expliquez l'erreur rencontrée.
• Créer et modifier des tables ou des enregistrements Activepieces.

Vous pouvez également découvrir des actions appartenant aux différentes Pièces de la plateforme. Un élément est l'intégration qui rassemble les déclencheurs et les actions disponibles pour un service, tel que Gmail, Slack, Google Sheets ou HubSpot.

Il ne faut pas confondre cela avec le agents natifs d'ActivepiecesUn agent créé au sein de la plateforme participe à un processus d'automatisation et utilise un modèle pour prendre des décisions lors de son exécution. Le serveur MCP, quant à lui, permet à un assistant externe de construire, d'inspecter ou de gérer le projet.

Ce dont vous avez besoin pour connecter Activepieces à MCP

Avant de commencer, assurez-vous d'avoir les éléments suivants :

• Un compte Activepieces Cloud ou une installation autogérée mise à jour.
• Un projet pour lequel vous disposez des autorisations suffisantes.
• Un client compatible avec les serveurs MCP distants.
• Une adresse publique avec HTTPS si Activepieces est hébergé sur votre serveur.
• Les connexions nécessaires sont configurées au sein du projet.

Vous n'avez pas besoin d'installer Node.js ni d'exécuter un serveur MCP distinct. Activepieces inclut déjà le point de terminaison nécessaire et fournit une adresse similaire à celle-ci :

https://tu-instancia.example.com/mcp

Si vous utilisez des applications comme Slack, Google Drive ou un CRM, commencez par configurer leurs connexions depuis l'interface Activepieces. L'assistant pourra sélectionner une connexion existante, mais Vous ne recevrez pas votre mot de passe, votre clé API ni votre jeton OAuth..

Comment activer le serveur Activepieces MCP

Le serveur est activé depuis les paramètres du projet :

1. Connectez-vous à Activepieces.
2. Ouvrez le projet auquel vous souhaitez vous connecter.
3. Entrer Paramètres.
4. Sélectionner Serveur MCP.
5. Activez le serveur à l'aide du commutateur correspondant.
6. Consultez les catégories d'outils autorisés.
7. Copiez l'adresse indiquée dans URL du serveur.

Les autorisations sont appliquées par projet. Cela permet à un assistant de se connecter à un environnement de test sans pour autant lui donner accès aux flux de travail utilisés en production.

Pour une première connexion, il est conseillé de ne laisser activés que les outils de requête. Vous pourrez activer la création, les tests ou la publication une fois que vous aurez vérifié le comportement du client.

Comment connecter Claude Desktop, Cursor ou Windsurf

Les clients prenant en charge les serveurs MCP distants peuvent utiliser directement l'URL fournie par Activepieces. La structure de configuration générale est la suivante :

{
  "mcpServers": {
    "activepieces": {
      "url": "https://tu-instancia.example.com/mcp"
    }
  }
}

L'emplacement du fichier ou du paramètre dépend du client :

Client	Emplacement de la configuration
Curseur	.cursor/mcp.json pour le projet ou ~/.cursor/mcp.json à l'échelle mondiale
Bureau Claude sous Windows	%APPDATA%\Claude\claude_desktop_config.json
Bureau Claude sur macOS	~/Library/Application Support/Claude/claude_desktop_config.json
planche à voile	Paramètres MCP dans les préférences de l'éditeur
Claude.ai	Paramètres de l'organisation > Connecteurs > Ajouter > Connecteur personnalisé

Après avoir enregistré les paramètres, redémarrez le client si nécessaire. Lors de la première connexion, une fenêtre de navigateur s'ouvrira pour finaliser la configuration. L'autorisation OAuth avec Activepieces.

Connectez-vous, sélectionnez le projet approprié et accordez l'accès demandé. Le client stockera un jeton d'autorisation ; il n'est pas nécessaire de copier manuellement une clé API dans le fichier de configuration.

Les guides plus anciens peuvent afficher une commande similaire à npx mcp-remote et une adresse se terminant par /sseCette configuration correspondait à une implémentation précédente. Sur les clients compatibles actuels, vous devez utiliser la URL se terminant par /mcp.

Quels outils l'assistant peut-il utiliser ?

Activepieces organise ses outils MCP en plusieurs catégories. Les outils de Découverte Elles sont en lecture seule et restent toujours accessibles. Les catégories permettant de modifier les données peuvent être activées ou désactivées dans chaque projet.

Catégorie	Ce que cela vous permet de faire
Découverte	Afficher les flux, les connexions, les éléments, les tables, les exécutions et les erreurs de validation.
Gestion des flux	Créer, dupliquer, renommer, publier, activer, désactiver ou supprimer des flux.
Construction du flux	Ajouter, mettre à jour et supprimer des déclencheurs ou des actions.
Routeur et branchement	Créer et modifier des branches conditionnelles.
Annotations	Ajoutez et gérez des notes directement dans le canevas.
Tables	Créez des tables, des champs et des enregistrements, et modifiez-les ou supprimez-les.
Tests et exécutions	Testez les flux, exécutez les actions, examinez les résultats et réessayez les exécutions ayant échoué.

Certaines opérations ont des conséquences importantes. L'outil permettant de supprimer un workflow supprime également ses versions et Elle ne permet pas d'annuler l'opérationDe même, une action peut consister à envoyer un courriel, à modifier un enregistrement ou à publier du contenu en utilisant une connexion réelle.

C’est pourquoi il est déconseillé d’activer automatiquement toutes les catégories. N’accordez à l’assistant que les autorisations nécessaires à la tâche en cours.

Comment créer un flux de travail Activepieces en utilisant le langage naturel

Une fois la connexion établie, vous pouvez décrire l'automatisation souhaitée. Plus les instructions sont précises, moins le modèle aura de décisions ambiguës à prendre.

Par exemple:

Créez un brouillon désactivé qui s'exécute du lundi au vendredi à 9h00, interroge les enregistrements en attente d'une table ActivePieces et envoie un résumé à Slack. Utilisez uniquement les connexions existantes. Validez et testez le flux, mais ne le publiez pas.

La procédure habituelle doit suivre cet ordre :

1. Examinez le projet : L'assistant vérifie les flux, les tables et les connexions disponibles.
2. Trouvez les outils : Identifiez le déclencheur et les actions les plus appropriées.
3. Examinez ses propriétés : récupère les champs obligatoires et les options autorisées.
4. Créer le brouillon : Créez le déclencheur et les étapes dans le bon ordre.
5. Valider la structure : Vérifiez les références, les branches vides et les champs incomplets.
6. Passez un test : exécute le flux ou certaines étapes avec des données contrôlées.
7. Examiner les résultats : Il indique les entrées, les sorties, les temps et les erreurs possibles.
8. Publier et activer : Veuillez effectuer ces actions uniquement après votre confirmation.

ActivePieces permet de créer un flux complet en une seule opération, mais cela ne signifie pas qu'il faille le publier sans l'avoir vérifié. Ouvrez le lien fourni par l'assistant et examinez attentivement les connexions, les expressions et les champs utilisés.

Si une connexion est manquante, l'assistant vous indiquera où la configurer, mais vous devrez tout de même terminer le processus d'autorisation via l'interface Activepieces. Cette conception permet de Connectez des agents d'IA aux systèmes internes sans exposer d'identifiants..

Comment fonctionne la recherche par action et par déclencheur

La fonction Recherche d'outils Il permet à l'assistant de décrire une tâche, telle que « envoyer un message à un canal Slack », et de recevoir les actions les plus pertinentes du catalogue.

Le processus de découverte comporte trois phases :

1. Découvrir: Rechercher des actions ou des déclencheurs à l'aide d'une description naturelle.
2. Inspecter: Il obtient le schéma complet et les champs de l'option choisie.
3. Exécuter ou compiler : Utilisez cette action ponctuellement ou intégrez-la dans un flux persistant.

La recherche d'outils est activée dans Activepieces Cloud. Dans les installations autogérées, vous devez l'activer à l'aide de cette variable :

AP_TOOL_SEARCH_ENABLED=true

La modification est prise en compte dynamiquement et ne nécessite pas de redémarrage de l'instance. Pour obtenir des résultats sémantiques, Activepieces requiert également un modèle d'embeddings et une base de données PostgreSQL avec l'extension appropriée. pgvector.

Vous pouvez fournir la clé utilisée pour les plongements le long de :

AP_OPENAI_API_KEY=tu_clave

Vous pouvez également configurer OpenAI comme fournisseur depuis l'administration de la plateforme. Si aucun modèle d'intégration n'est disponible ou si l'indexation sémantique échoue, la recherche d'outils continue de fonctionner. correspondances de mots clés.

Comment protéger l'accès Activepieces MCP

Le serveur utilise OAuth, limite les opérations au projet autorisé et ne renvoie pas les clés ou jetons stockés au client. Cependant, la protection des secrets n'élimine pas tous les risques : un assistant doté d'outils d'exécution peut… utiliser indirectement ces identifiants entreprendre des actions concrètes.

Appliquez ces mesures avant d'utiliser MCP avec des automatisations importantes :

• Créez un projet distinct pour les tests initiaux.
• Activez uniquement les catégories d'outils essentielles.
• Utilisez des comptes d'application avec des autorisations minimales.
• N’autorisez la publication, la suppression ou l’activation des flux que si cela est nécessaire.
• Demander une confirmation avant d'envoyer des messages ou de modifier des données externes.
• Vérifiez manuellement la structure avant de publier un brouillon.
• Examinez les exécutions et les journaux après chaque modification importante.
• Révoquez l'autorisation OAuth si l'appareil ou le client n'est plus utilisé.

Pour les processus financiers, les modifications CRM, les communications externes ou la suppression d'informations, il est conseillé Ajouter une validation humaine au flux de travail de l'IALe modèle peut préparer l'opération, mais une personne doit autoriser l'étape finale.

L'auto-hébergement vous permet de conserver Activepieces au sein de votre infrastructure, mais ne garantit pas automatiquement la conformité réglementaireLa sécurité optimale dépend également du proxy, de la base de données, des autorisations, des sauvegardes et des politiques organisationnelles.

Comment configurer MCP derrière un proxy inverse

Dans une installation autogérée, l'adresse publique d'Activepieces doit être accessible depuis le client MCP et utiliser un protocole HTTPS valide. Si l'instance est publiée à la racine d'un domaine, le point de terminaison sera généralement :

https://automatizacion.example.com/mcp

Lorsque Activepieces se trouve sous une sous-route, vous devez l'inclure dans AP_FRONTEND_URL:

AP_FRONTEND_URL=https://automatizacion.example.com/activepieces

Dans ce cas, le serveur MCP sera disponible à l'adresse suivante :

https://automatizacion.example.com/activepieces/mcp

Le proxy doit acheminer à la fois le trafic Activepieces et les points de terminaison utilisés lors de l'autorisation OAuth. Certains clients recherchent des routes. /.well-known/oauth-* directement à la racine du domaine. Si le client ignore l'en-tête de découverte, vous devrez créer une règle supplémentaire pour rediriger ces routes.

N’exposez pas directement un conteneur de test via HTTP. Utilisez un domaine stable, TLS et une configuration appropriée. AP_FRONTEND_URLcar une différence entre l'adresse interne et l'adresse publique peut interrompre la redirection OAuth.

Erreurs courantes lors de la connexion d'Activepieces avec MCP

Le client tente d'utiliser mcp-remote ou une adresse se terminant par /sse

Vous suivez un guide pour une version antérieure. Le serveur actuel est configuré à l'aide de son URL distante se terminant par /mcpSupprimez l'ancienne commande et réenregistrez le serveur.

L'option Serveur MCP n'est pas activée.

Entrer Paramètres > Serveur MCPActivez le service et copiez à nouveau l'adresse. Vérifiez également que vous travaillez sur le bon projet.

L'autorisation OAuth entre dans une boucle

Vérifiez que le message diffusé au public correspond exactement. AP_FRONTEND_URLSi vous utilisez une sous-route, vérifiez les règles du proxy et les points de terminaison de découverte OAuth.

L'assistant peut uniquement lire les flux.

Les outils de découverte sont en lecture seule. Activez-les explicitement. Gestion des flux, Construction du flux ou une autre catégorie requise par la configuration MCP du projet.

Les outils de recherche boursière ne s'affichent pas.

Dans une instance autogérée, vérifiez que AP_TOOL_SEARCH_ENABLED=trueSi la recherche fonctionne mais ne trouve que des correspondances littérales, vérifiez le fournisseur d'intégration et sa disponibilité. pgvector.

Le magicien trouve une action, mais ne peut pas l'exécuter.

L'intégration peut nécessiter une connexion inexistante ou présentant une erreur. Ouvrez Activepieces, configurez la connexion depuis l'interface, puis relancez l'exécution.

L'assistant travaille sur le mauvais projet.

Demandez-lui d'afficher les projets disponibles et de définir explicitement le contexte approprié. Les opérations suivantes seront limitées à ce projet.

Le flux est créé, mais il ne s'exécute pas.

Vérifiez s'il reste à l'état de brouillon, s'il a été publié et si son statut est ActivéVérifiez également que le déclencheur possède un échantillon valide et que toutes les connexions sont actives.

Le test fonctionne, mais l'exécution réelle échoue.

Consultez l'historique d'exécution et ouvrez le résultat de chaque étape. Le test a peut-être utilisé des données d'exemple différentes de celles reçues ultérieurement par le déclencheur réel.

L'assistant a préparé une action trop risquée.

Ne l'exécutez pas directement. Réduisez le nombre de catégories autorisées, modifiez l'invite pour exiger une confirmation et ajoutez une étape d'approbation humaine avant toute opération irréversible.

L'intégration d'ActivePieces à MCP transforme l'assistant en une interface de création et de gestion d'automatisations, mais n'accorde pas un accès illimité par défaut. Le serveur sépare les outils de requête des capacités d'écriture et conserve les identifiants au sein du projet.

La configuration recommandée consiste à activer le serveur MCP, à copier son URL, à autoriser le client via OAuth et à démarrer avec les outils en lecture seule. Vous pourrez ensuite activer progressivement la génération, les tests et la publication, en vérifiant chaque flux de travail avant de l'utiliser avec des données ou des comptes réels.