Hur man ansluter Activepieces till MCP steg för steg

Genom att koppla Activepieces till MCP kan du använda en assistent för artificiell intelligens för att Skapa, granska och testa automatiseringar med hjälp av naturligt språk.Istället för att manuellt bygga varje steg från den visuella redigeraren kan du be guiden att granska tillgängliga integrationer, skapa ett utkast och upptäcka fel innan publicering.

Activepieces har en egen server som är kompatibel med Modell Context ProtocolDenna server fungerar som ett standardiserat gränssnitt mellan automationsplattformen och klienter som Claude Desktop, Claude.ai, Cursor eller Windsurf.

Den nuvarande integrationen går långt utöver att bara exponera ett fåtal åtgärder. Guiden kan fråga flödesstrukturen, söka efter åtgärder och utlösare, hantera tabeller, analysera misslyckade körningar och, om du ger den lämpliga behörigheter, modifiera eller publicera kompletta automatiseringar.

Vad tillåter Activepieces MCP-servern dig att göra?

Activepieces MCP-servern låter en kompatibel guide arbeta med ett projekt inom plattformen. Dess primära funktion är inte att ersätta automatiseringsmotorn, utan att förse modellen med en kontrollerad uppsättning verktyg för granska och hantera flöden genom en konversation.

Du kan till exempel be den att göra följande:

• Lista de befintliga flödena och kontrollera vilka som är aktiverade.
• Läs strukturen och konfigurationen av en automatisering.
• Hitta en lämplig åtgärd för en given uppgift.
• Skapa ett komplett flöde med dess trigger och åtgärder.
• Lägg till villkor, loopar eller grenar i ett befintligt flöde.
• Validera konfigurationen innan du publicerar den.
• Prova individuella steg och granska dina resultat.
• Granska misslyckade körningar och förklara felet som uppstod.
• Skapa och ändra Activepieces-tabeller eller -poster.

Du kan också upptäcka aktier som tillhör de olika Bitar av plattformen. En Piece är den integration som sammanför de utlösare och åtgärder som är tillgängliga för en tjänst, till exempel Gmail, Slack, Google Sheets eller HubSpot.

Detta bör inte förväxlas med inhemska agenter för ActivepiecesEn agent som skapas i plattformen är en del av en automatiseringsprocess och använder en modell för att fatta beslut under körningen. MCP-servern, å andra sidan, tillåter en extern assistent att bygga, inspektera eller hantera projektet.

Vad du behöver för att ansluta Activepieces till MCP

Innan du börjar, se till att du har följande saker:

• Ett Activepieces Cloud-konto eller en uppdaterad självhanterad installation.
• Ett projekt som du har tillräckliga behörigheter för.
• En klient som är kompatibel med fjärr-MCP-servrar.
• En offentlig adress med HTTPS om Activepieces finns på din server.
• De nödvändiga anslutningarna som konfigurerats i projektet.

Du behöver inte installera Node.js eller köra en separat MCP-server. Activepieces inkluderar redan den nödvändiga slutpunkten och tillhandahåller en adress som liknar denna:

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

Om du använder applikationer som Slack, Google Drive eller ett CRM-system, konfigurera först deras anslutningar från Activepieces-gränssnittet. Guiden kommer att kunna välja en befintlig anslutning, men Du kommer inte att få ditt lösenord, din API-nyckel eller din OAuth-token..

Hur man aktiverar Activepieces MCP-servern

Servern aktiveras från projektinställningarna:

1. Logga in på Activepieces.
2. Öppna projektet du vill ansluta till.
3. Skriva in Inställningar.
4. Välja MCP-server.
5. Aktivera servern med motsvarande brytare.
6. Granska kategorierna av tillåtna verktyg.
7. Kopiera adressen som visas i Server-URL.

Behörigheter tillämpas per projekt. Detta gör det möjligt för en assistent att ansluta till en testmiljö utan att ge dem åtkomst till de arbetsflöden som används i produktionen.

För en första anslutning är det lämpligt att endast lämna frågeverktygen aktiverade. Du kan aktivera skapande, testning eller publicering när du har verifierat hur klienten beter sig.

Hur man ansluter Claude Desktop, Cursor eller Windsurf

Kunder som stöder fjärr-MCP-servrar kan direkt använda URL:en som tillhandahålls av Activepieces. Den allmänna konfigurationsstrukturen är följande:

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

Platsen för filen eller inställningen beror på klienten:

Kund	Plats för konfigurationen
Markör	.cursor/mcp.json för projektet eller ~/.cursor/mcp.json globalt
Claude-skrivbordet på Windows	%APPDATA%\Claude\claude_desktop_config.json
Claude Desktop på macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Vindsurfing	MCP-inställningar i redigerarinställningarna
Claude.ai	Organisationsinställningar > Kopplingar > Lägg till > Anpassad koppling

När du har sparat inställningarna, starta om klienten om det behövs. Under den första anslutningen öppnas ett webbläsarfönster för att slutföra installationen. OAuth-auktorisering med Activepieces.

Logga in, välj rätt projekt och bevilja den begärda åtkomsten. Klienten lagrar en auktoriseringstoken; det finns inget behov av att manuellt kopiera en API-nyckel till konfigurationsfilen.

Äldre guider kan visa ett kommando som liknar npx mcp-remote och en adress som slutar på /sseDen konfigurationen motsvarade en tidigare implementering. På nuvarande kompatibla klienter måste du använda URL som slutar på /mcp.

Vilka verktyg kan assistenten använda?

Activepieces organiserar sina MCP-verktyg i flera kategorier. Verktygen för Upptäckt De är skrivskyddade och förblir alltid tillgängliga. Kategorier som kan ändra data kan aktiveras eller inaktiveras i varje projekt.

Kategori	Vad det tillåter dig att göra
Upptäckt	Visa flöden, kopplingar, delar, tabeller, körningar och valideringsfel.
Flödeshantering	Skapa, duplicera, byt namn på, publicera, aktivera, inaktivera eller ta bort flöden.
Flödesbyggnad	Lägg till, uppdatera och ta bort utlösare eller åtgärder.
Router och förgrening	Skapa och ändra villkorliga grenar.
Annoteringar	Lägg till och hantera anteckningar i arbetsytan.
Tabeller	Skapa tabeller, fält och poster, samt ändra eller ta bort dem.
Testning och körningar	Testa flöden, kör åtgärder, granska resultat och försök igen med misslyckade körningar.

Vissa åtgärder har betydande konsekvenser. Verktyget för att ta bort ett arbetsflöde tar även bort dess versioner och Det tillåter inte att ångra operationenPå samma sätt kan en åtgärd skicka ett e-postmeddelande, ändra en post eller publicera innehåll med hjälp av en verklig anslutning.

Av denna anledning är det inte lämpligt att automatiskt aktivera alla kategorier. Bevilja endast de funktioner som assistenten behöver för den aktuella uppgiften.

Hur man skapar ett Activepieces-arbetsflöde med hjälp av naturligt språk

När kopplingen är upprättad kan du beskriva den automatisering du behöver. Ju mer exakt instruktionen är, desto färre tvetydiga beslut måste modellen fatta.

Till exempel:

Skapa ett inaktiverat utkast som körs måndag till fredag ​​kl. 9:00, frågar efter väntande poster från en ActivePieces-tabell och skickar en sammanfattning till Slack. Använd endast befintliga anslutningar. Validera och testa flödet, men publicera det inte.

Den vanliga processen bör följa denna ordning:

1. Granska projektet: Guiden kontrollerar tillgängliga flöden, tabeller och kopplingar.
2. Hitta verktygen: Identifiera utlösaren och de åtgärder som passar bäst.
3. Granska dess egenskaper: hämtar de obligatoriska fälten och de tillåtna alternativen.
4. Skapa utkastet: Bygg avtryckaren och stegen i rätt ordning.
5. Validera strukturen: Kontrollera referenser, tomma grenar och ofullständiga fält.
6. Gör ett test: kör flödet eller vissa steg med kontrollerad data.
7. Granska resultaten: Den visar indata, utgångar, tider och möjliga fel.
8. Publicera och aktivera: Utför dessa åtgärder endast efter din bekräftelse.

ActivePieces kan skapa ett helt flöde i en enda operation, men det betyder inte att du ska publicera det utan att granska det. Öppna länken som returneras av guiden och kontrollera visuellt de kopplingar, uttryck och fält som används.

Om en anslutning saknas kan guiden berätta var du ska konfigurera den, men du måste fortfarande slutföra auktoriseringsprocessen via Activepieces-gränssnittet. Denna design hjälper till att Anslut AI-agenter till interna system utan att exponera inloggningsuppgifter.

Så här fungerar åtgärds- och triggersökning

Funktionen Verktygssökning Det låter assistenten beskriva en uppgift, till exempel "skicka ett meddelande till en Slack-kanal", och ta emot de mest relevanta åtgärderna från katalogen.

Upptäcktsflödet har tre faser:

1. Upptäcka: sök efter handlingar eller utlösare med hjälp av en naturlig beskrivning.
2. Inspektera: Den hämtar det fullständiga schemat och fälten för det valda alternativet.
3. Utför eller bygg: Använd åtgärden en gång eller införliva den i ett beständigt flöde.

Verktygssökning är aktiverat i Activepieces Cloud. I självhanterade installationer måste du aktivera det med hjälp av denna variabel:

AP_TOOL_SEARCH_ENABLED=true

Ändringen läses dynamiskt och kräver inte omstart av instansen. För att få semantiska resultat kräver Activepieces även en inbäddningsmodell och en PostgreSQL-databas med tillägget. pgvector.

Du kan ange nyckeln som används för inbäddningarna genom att:

AP_OPENAI_API_KEY=tu_clave

Du kan också konfigurera OpenAI som en leverantör från plattformsadministrationen. Om ingen inbäddningsmodell är tillgänglig eller om semantisk indexering misslyckas fortsätter verktygssökningen att fungera med hjälp av sökordsmatchningar.

Hur man skyddar Activepieces MCP-åtkomst

Servern använder OAuth, begränsar åtgärder till det auktoriserade projektet och returnerar inte lagrade nycklar eller tokens till klienten. Att skydda hemligheter eliminerar dock inte alla risker: en guide med exekveringsverktyg kan indirekt använda dessa inloggningsuppgifter att utföra verkliga handlingar.

Tillämpa dessa åtgärder innan du använder MCP med större automatiseringar:

• Skapa ett separat projekt för initial testning.
• Aktivera endast de nödvändiga verktygskategorierna.
• Använd appkonton med minimala behörigheter.
• Tillåt inte publicering, borttagning eller aktivering av flöden om det inte är nödvändigt.
• Begär bekräftelse innan du skickar meddelanden eller ändrar externa data.
• Kontrollera strukturen manuellt innan du publicerar ett utkast.
• Granska körningarna och loggarna efter varje större ändring.
• Återkalla OAuth-auktorisering om enheten eller klienten inte längre används.

För ekonomiska processer, CRM-ändringar, extern kommunikation eller radering av information är det lämpligt Lägg till mänskligt godkännande i AI-arbetsflödetModellen kan förbereda operationen, men en person måste auktorisera det sista steget.

Med egenhosting kan du behålla Activepieces inom din infrastruktur, men garanterar inte automatiskt regelefterlevnadDen ultimata säkerheten beror också på proxy, databas, behörigheter, säkerhetskopior och organisationspolicyer.

Hur man konfigurerar MCP bakom en omvänd proxy

I en självhanterad installation måste Activepieces publika adress vara tillgänglig från MCP-klienten och ha giltig HTTPS. Om instansen publiceras i roten av en domän kommer den typiska slutpunkten att vara:

https://automatizacion.example.com/mcp

När Activepieces finns under en underrutt måste du inkludera den i AP_FRONTEND_URL:

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

I det här fallet kommer MCP-servern att vara tillgänglig på:

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

Proxyn måste vidarebefordra både Activepieces-trafik och slutpunkterna som används under OAuth-auktorisering. Vissa klienter letar efter rutter. /.well-known/oauth-* direkt vid domänroten. Om klienten ignorerar identifieringshuvudet måste du skapa en ytterligare regel för att vidarebefordra dessa rutter.

Exponera inte en testbehållare direkt över HTTP. Använd en stabil domän, TLS och korrekt konfiguration. AP_FRONTEND_URLeftersom en skillnad mellan den interna och den offentliga adressen kan förstöra OAuth-omdirigeringen.

Vanliga fel vid anslutning av Activepieces med MCP

Klienten försöker använda mcp-remote eller en adress som slutar på /sse

Du följer en guide för en tidigare version. Den aktuella servern är konfigurerad med sin fjärr-URL som slutar på /mcpTa bort det gamla kommandot och registrera servern på nytt.

MCP-serveralternativet är inte aktiverat

Skriva in Inställningar > MCP-serverAktivera tjänsten och kopiera adressen igen. Kontrollera också att du arbetar med rätt projekt.

OAuth-auktorisering går in i en loop

Kontrollera att den offentliga adressen stämmer exakt. AP_FRONTEND_URLOm du använder en underväg, granska proxyreglerna och OAuth-identifieringsslutpunkterna.

Assistenten kan bara läsa flödena

Identifieringsverktyg är skrivskyddade. Aktivera dem explicit. Flödeshantering, Flödesbyggnad eller en annan kategori som krävs från projektets MCP-konfiguration.

Aktiesökningsverktygen visas inte

I ett självhanterat fall, verifiera att AP_TOOL_SEARCH_ENABLED=trueOm sökningen fungerar men bara hittar bokstavliga träffar, kontrollera inbäddningsleverantören och tillgängligheten. pgvector.

Guiden hittar en åtgärd, men kan inte utföra den.

Integrationen kan kräva en anslutning som ännu inte finns eller så upplever den ett fel. Öppna Activepieces, konfigurera anslutningen från gränssnittet och begär sedan körning igen.

Assistenten arbetar med fel projekt.

Be den att visa tillgängliga projekt och explicit ange rätt kontext. Efterföljande åtgärder kommer att begränsas till det projektet.

Flödet skapas, men det körs inte.

Kontrollera om det finns kvar som utkast, om det har publicerats och om dess status är AktiveradKontrollera också att utlösaren har ett giltigt exempel och att alla anslutningar är aktiva.

Ett test fungerar, men själva körningen misslyckas

Granska körningshistoriken och öppna resultatet av varje steg. Testet kan ha använt exempeldata som skiljer sig från de som senare togs emot av den faktiska utlösaren.

Assistenten har förberett en åtgärd som är för riskabel.

Kör det inte direkt. Minska antalet tillåtna kategorier, ändra prompten så att bekräftelse krävs och lägg till ett steg för mänskligt godkännande innan en åtgärd som inte kan återställas.

Genom att ansluta ActivePieces till MCP förvandlas guiden till ett gränssnitt för att bygga och underhålla automatiseringar, men det ger inte obegränsad åtkomst som standard. Servern separerar frågeverktyg från skrivfunktioner och behåller autentiseringsuppgifterna inom projektet.

Den rekommenderade installationen innebär att aktivera MCP-servern, kopiera dess URL, auktorisera klienten via OAuth och börja med skrivskyddade verktyg. Du kan sedan successivt aktivera byggande, testning och publicering, och granska varje arbetsflöde innan du använder det med livedata eller konton.