Kako korak za korakom povezati ActivePieces z MCP

Povezava Activepieces z MCP vam omogoča uporabo pomočnika umetne inteligence za Ustvarjajte, pregledujte in testirajte avtomatizacije z uporabo naravnega jezika.Namesto ročnega ustvarjanja vsakega koraka v vizualnem urejevalniku lahko čarovnika prosite, naj pred objavo pregleda razpoložljive integracije, nastavi osnutek in zazna napake.

Activepieces ima vgrajen lasten strežnik, ki je združljiv z Model Context ProtocolTa strežnik deluje kot standardiziran vmesnik med platformo za avtomatizacijo in odjemalci, kot so Claude Desktop, Claude.ai, Cursor ali Windsurf.

Trenutna integracija daleč presega zgolj prikazovanje nekaj dejanj. Čarovnik lahko poizveduje po strukturi toka, išče dejanja in sprožilce, upravlja tabele, analizira neuspešne izvedbe in, če mu dodelite ustrezna dovoljenja, spremeniti ali objaviti celotne avtomatizacije.

Kaj vam omogoča strežnik Activepieces MCP?

Strežnik Activepieces MCP omogoča združljivemu čarovniku delo na projektu znotraj platforme. Njegova glavna funkcija ni nadomestiti mehanizem za avtomatizacijo, temveč modelu zagotoviti nadzorovan nabor orodij za pregledovati in upravljati tokove skozi pogovor.

Na primer, lahko ga prosite, naj stori naslednje:

• Naštejte obstoječe tokove in preverite, kateri so omogočeni.
• Preberite strukturo in konfiguracijo avtomatizacije.
• Poiščite ustrezno dejanje za dano nalogo.
• Ustvarite celoten tok s sprožilcem in dejanji.
• Dodajte pogoje, zanke ali veje obstoječemu toku.
• Pred objavo preverite konfiguracijo.
• Preizkusite posamezne korake in preverite svoje rezultate.
• Preglejte neuspešne izvedbe in razložite nastalo napako.
• Ustvarjanje in spreminjanje tabel ali zapisov Activepieces.

Odkrijete lahko tudi delnice, ki pripadajo različnim Kosi platforme. A Piece je integracija, ki združuje sprožilce in dejanja, ki so na voljo za storitev, kot so Gmail, Slack, Google Preglednice ali HubSpot.

Tega ne smemo zamenjevati z domači agenti ActivepiecesAgent, ustvarjen znotraj platforme, je del procesa avtomatizacije in uporablja model za sprejemanje odločitev med izvajanjem. Strežnik MCP pa zunanjemu asistentu omogoča gradnjo, pregled ali upravljanje projekta.

Kaj potrebujete za povezavo Activepieces z MCP

Preden začnete, se prepričajte, da imate naslednje elemente:

• Račun Activepieces Cloud ali posodobljena namestitev s samostojnim upravljanjem.
• Projekt, za katerega imate zadostna dovoljenja.
• Odjemalec, združljiv z oddaljenimi strežniki MCP.
• Javni naslov s HTTPS, če je Activepieces gostovan na vašem strežniku.
• Potrebne povezave, konfigurirane znotraj projekta.

Ni vam treba namestiti Node.js ali zagnati ločenega strežnika MCP. Activepieces že vključuje potrebno končno točko in ponuja naslov, podoben temu:

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

Če uporabljate aplikacije, kot so Slack, Google Drive ali CRM, najprej konfigurirajte njihove povezave iz vmesnika Activepieces. Čarovnik bo lahko izbral obstoječo povezavo, vendar Gesla, ključa API ali žetona OAuth ne boste prejeli..

Kako aktivirati strežnik Activepieces MCP

Strežnik se aktivira iz nastavitev projekta:

1. Prijavite se v Activepieces.
2. Odprite projekt, ki ga želite povezati.
3. Vnesite Nastavitve.
4. Izberite Strežnik MCP.
5. Aktivirajte strežnik z ustreznim stikalom.
6. Preglejte kategorije dovoljenih orodij.
7. Kopirajte naslov, prikazan v URL strežnika.

Avtorizacije se uporabljajo za vsak projekt posebej. To omogoča asistentu, da se poveže s testnim okoljem, ne da bi mu bilo treba odobriti dostop do delovnih tokov, ki se uporabljajo v produkciji.

Za začetno povezavo je priporočljivo, da pustite omogočena samo orodja za poizvedbe. Ustvarjanje, testiranje ali objavljanje lahko aktivirate, ko preverite, kako se odjemalec obnaša.

Kako povezati Claude Desktop, Cursor ali Windsurf

Stranke, ki podpirajo oddaljene strežnike MCP, lahko neposredno uporabijo URL, ki ga zagotavlja Activepieces. Splošna konfiguracijska struktura je naslednja:

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

Lokacija datoteke ali nastavitve je odvisna od odjemalca:

Stranka	Lokacija konfiguracije
Kazalec	.cursor/mcp.json za projekt oz. ~/.cursor/mcp.json globalno
Claude Desktop v sistemu Windows	%APPDATA%\Claude\claude_desktop_config.json
Claude Desktop v sistemu macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Deskanje na deski	Nastavitve MCP v nastavitvah urejevalnika
Claude.ai	Nastavitve organizacije > Povezovalniki > Dodaj > Povezovalnik po meri

Ko shranite nastavitve, po potrebi znova zaženite odjemalca. Med prvo povezavo se bo odprlo okno brskalnika za dokončanje nastavitve. Avtorizacija OAuth z Activepieces.

Prijavite se, izberite pravilen projekt in odobrite zahtevani dostop. Odjemalec bo shranil avtorizacijski žeton; ključa API ni treba ročno kopirati v konfiguracijsko datoteko.

Starejši priročniki lahko prikazujejo ukaz, podoben npx mcp-remote in naslov, ki se konča na /sseTa konfiguracija je ustrezala prejšnji implementaciji. Na trenutno združljivih odjemalcih morate uporabiti URL, ki se konča z /mcp.

Katera orodja lahko uporabi asistent?

Activepieces svoja orodja MCP organizira v več kategorij. Orodja za Odkritje So samo za branje in so vedno na voljo. Kategorije, ki omogočajo spreminjanje podatkov, je mogoče omogočiti ali onemogočiti v vsakem projektu.

Kategorija	Kaj vam omogoča
Odkritje	Oglejte si tokove, povezave, dele, tabele, izvedbe in napake pri preverjanju.
Upravljanje pretoka	Ustvarjanje, podvajanje, preimenovanje, objavljanje, omogočanje, onemogočanje ali brisanje potekov.
Gradnja pretoka	Dodajanje, posodabljanje in brisanje sprožilcev ali dejanj.
Usmerjevalnik in razvejanje	Ustvarjanje in spreminjanje pogojnih vej.
Opombe	Dodajajte in upravljajte zapiske znotraj platna.
Mize	Ustvarjajte tabele, polja in zapise ter jih spreminjajte ali brišite.
Testiranje in zagoni	Preizkusite poteke, izvedite dejanja, pregledajte rezultate in poskusite znova neuspešne izvedbe.

Nekatere operacije imajo znatne posledice. Orodje za brisanje poteka dela izbriše tudi njegove različice in Ne dovoljuje razveljavitve operacijePodobno lahko izvajanje dejanja pošlje e-pošto, spremeni zapis ali objavi vsebino z uporabo prave povezave.

Zaradi tega ni priporočljivo samodejno omogočiti vseh kategorij. Pomočnik mora odobriti le tiste zmogljivosti, ki jih potrebuje za trenutno opravilo.

Kako ustvariti delovni tok Activepieces z uporabo naravnega jezika

Ko je povezava vzpostavljena, lahko opišete potrebno avtomatizacijo. Bolj kot je navodilo natančnejše, manj dvoumnih odločitev bo moral model sprejeti.

Na primer:

Ustvarite onemogočen osnutek, ki se izvaja od ponedeljka do petka ob 9.00, poizveduje po čakajočih zapisih iz tabele ActivePieces in pošilja povzetek v Slack. Uporabite samo obstoječe povezave. Preverite in preizkusite potek, vendar ga ne objavite.

Običajni postopek bi moral slediti temu vrstnemu redu:

1. Preučite projekt: Čarovnik preveri razpoložljive tokove, tabele in povezave.
2. Poiščite orodja: Določite sprožilec in dejanja, ki najbolj ustrezajo.
3. Preglejte njegove lastnosti: pridobi obvezna polja in dovoljene možnosti.
4. Ustvari osnutek: Sestavite sprožilec in korake v pravilnem vrstnem redu.
5. Potrdite strukturo: Preverite reference, prazne veje in nepopolna polja.
6. Naredite test: izvede tok ali določene korake z nadzorovanimi podatki.
7. Preglejte rezultate: Prikazuje vhodne podatke, izhodne podatke, čase in morebitne napake.
8. Objavi in ​​omogoči: Ta dejanja izvedite šele po vaši potrditvi.

ActivePieces lahko ustvari celoten tok v eni sami operaciji, vendar to ne pomeni, da ga morate objaviti, ne da bi ga pregledali. Odprite povezavo, ki jo vrne čarovnik, in vizualno preverite uporabljene povezave, izraze in polja.

Če povezava manjka, vam lahko čarovnik pove, kje jo konfigurirati, vendar boste morali postopek avtorizacije še vedno dokončati prek vmesnika Activepieces. Ta zasnova pomaga pri Povežite agente umetne inteligence z notranjimi sistemi brez razkritja poverilnic.

Kako deluje iskanje po dejanjih in sprožilcih

Funkcija Iskanje orodij Pomočniku omogoča, da opiše nalogo, na primer »pošlji sporočilo v kanal Slack«, in prejme najustreznejša dejanja iz kataloga.

Tok odkrivanja ima tri faze:

1. Odkrijte: iščite dejanja ali sprožilce z uporabo naravnega opisa.
2. Pregled: Pridobi celotno shemo in polja izbrane možnosti.
3. Izvedi ali zgradi: Dejanje uporabite enkrat ali ga vključite v trajen tok.

Iskanje orodij je omogočeno v storitvi Activepieces Cloud. V samostojno upravljanih namestitvah ga morate aktivirati s to spremenljivko:

AP_TOOL_SEARCH_ENABLED=true

Sprememba se bere dinamično in ne zahteva ponovnega zagona instance. Za pridobitev semantičnih rezultatov Activepieces potrebuje tudi model vdelave in bazo podatkov PostgreSQL s pripono . pgvector.

Ključ, ki se uporablja za vdelave, lahko navedete tako, da:

AP_OPENAI_API_KEY=tu_clave

OpenAI lahko konfigurirate tudi kot ponudnika v skrbništvu platforme. Če model vdelave ni na voljo ali semantično indeksiranje ne uspe, iskanje orodij še naprej deluje z uporabo ujemanja ključnih besed.

Kako zaščititi dostop do Activepieces MCP

Strežnik uporablja OAuth, omejuje operacije na pooblaščeni projekt in ne vrača shranjenih ključev ali žetonov odjemalcu. Vendar pa zaščita skrivnosti ne odpravi vseh tveganj: čarovnik z orodji za izvajanje lahko posredno uporabljajo te poverilnice za izvajanje resničnih dejanj.

Pred uporabo MCP z večjimi avtomatizacijami uporabite te ukrepe:

• Za začetno testiranje ustvarite ločen projekt.
• Aktivirajte samo bistvene kategorije orodij.
• Uporabljajte račune aplikacij z minimalnimi dovoljenji.
• Ne dovolite objavljanja, brisanja ali omogočanja potekov, razen če je to potrebno.
• Pred pošiljanjem sporočil ali spreminjanjem zunanjih podatkov zahtevajte potrditev.
• Pred objavo osnutka ročno preverite strukturo.
• Po vsaki večji spremembi preglejte izvedbe in dnevnike.
• Prekliči avtorizacijo OAuth, če naprava ali odjemalec ni več v uporabi.

Za finančne procese, spremembe CRM-ja, zunanje komuniciranje ali brisanje informacij je priporočljivo Dodajte človeško odobritev v potek dela umetne inteligenceModel lahko pripravi operacijo, vendar mora oseba odobriti zadnji korak.

Samostojno gostovanje vam omogoča, da Activepieces obdržite znotraj svoje infrastrukture, vendar ne zagotavlja samodejno skladnosti s predpisiKončna varnost je odvisna tudi od proxyja, baze podatkov, dovoljenj, varnostnih kopij in organizacijskih pravilnikov.

Kako konfigurirati MCP za obratnim proxyjem

V samoupravljani namestitvi mora biti javni naslov Activepieces dostopen iz odjemalca MCP in imeti veljaven HTTPS. Če je primerek objavljen v korenu domene, bo tipična končna točka:

https://automatizacion.example.com/mcp

Ko je Activepieces pod podruto, ga morate vključiti v AP_FRONTEND_URL:

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

V tem primeru bo strežnik MCP na voljo na naslovu:

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

Proxy mora posredovati tako promet Activepieces kot tudi končne točke, uporabljene med avtorizacijo OAuth. Nekateri odjemalci iščejo poti /.well-known/oauth-* neposredno v korenu domene. Če odjemalec prezre glavo odkrivanja, boste morali ustvariti dodatno pravilo za posredovanje teh poti.

Testnega vsebnika ne izpostavljajte neposredno prek HTTP-ja. Uporabite stabilno domeno, TLS in ustrezno konfiguracijo. AP_FRONTEND_URLsaj lahko neskladje med internim in javnim naslovom prekine preusmeritev OAuth.

Pogoste napake pri povezovanju aktivnih elementov z MCP

Odjemalec poskuša uporabiti mcp-remote ali naslov, ki se konča na /sse

Sledite navodilom za starejšo različico. Trenutni strežnik je konfiguriran z oddaljenim URL-jem, ki se konča na /mcpOdstranite stari ukaz in ponovno registrirajte strežnik.

Možnost strežnika MCP ni omogočena

Vnesite Nastavitve > Strežnik MCPAktivirajte storitev in znova kopirajte naslov. Preverite tudi, ali delate na pravilnem projektu.

Avtorizacija OAuth vstopi v zanko

Preverite, ali se javni naslov natančno ujema. AP_FRONTEND_URLČe uporabljate podruto, preglejte pravila proxyja in končne točke odkrivanja OAuth.

Pomočnik lahko samo bere poteke

Orodja za odkrivanje so samo za branje. Izrecno jih omogočite. Upravljanje pretoka, Gradnja pretoka ali drugo kategorijo, ki jo zahteva konfiguracija MCP projekta.

Orodja za iskanje delnic se ne prikazujejo

V samoupravljanem primeru preverite, ali AP_TOOL_SEARCH_ENABLED=trueČe iskanje deluje, vendar najde le dobesedna ujemanja, preverite ponudnika vdelave in razpoložljivost. pgvector.

Čarovnik najde dejanje, vendar ga ne more izvesti.

Integracija lahko zahteva povezavo, ki še ne obstaja ali pa v njej prihaja do napake. Odprite Activepieces, konfigurirajte povezavo iz vmesnika in nato znova zahtevajte izvedbo.

Asistent dela na napačnem projektu.

Prosite ga, naj prikaže razpoložljive projekte in izrecno nastavi pravilen kontekst. Nadaljnje operacije bodo omejene na ta projekt.

Tok je ustvarjen, vendar se ne izvaja.

Preverite, ali je še vedno osnutek, ali je bil objavljen in ali je njegov status OmogočenoPreverite tudi, ali ima sprožilec veljaven vzorec in ali so vse povezave aktivne.

Test deluje, dejanska izvedba pa ne uspe

Preglejte zgodovino izvajanja in odprite rezultat vsakega koraka. Test je morda uporabil vzorčne podatke, ki se razlikujejo od tistih, ki jih je nato prejel dejanski sprožilec.

Pomočnik je pripravil preveč tvegano dejanje.

Ne zaženite ga neposredno. Zmanjšajte dovoljene kategorije, spremenite poziv tako, da zahteva potrditev, in dodajte fazo človeške odobritve pred vsako nepovratno operacijo.

Povezava ActivePieces z MCP spremeni čarovnika v vmesnik za gradnjo in vzdrževanje avtomatizacij, vendar privzeto ne omogoča neomejenega dostopa. Strežnik ločuje orodja za poizvedbe od zmogljivosti pisanja in hrani poverilnice znotraj projekta.

Priporočena nastavitev vključuje aktiviranje strežnika MCP, kopiranje njegovega URL-ja, avtorizacijo odjemalca prek OAuth in začetek uporabe orodij samo za branje. Nato lahko postopoma omogočite gradnjo, testiranje in objavljanje ter pregledate vsak delovni tok, preden ga uporabite z živimi podatki ali računi.