- Activepieces, görsel iş akışları ve yapay zeka ajanları kullanarak yüzlerce uygulamayı birbirine bağlamanıza olanak tanıyan açık kaynaklı bir otomasyon platformudur.
- Model Bağlam Protokolü (MCP), Claude veya ChatGPT gibi sanal asistanların harici uygulamalarda gerçek eylemler gerçekleştirmesine olanak tanıyan evrensel bir standart görevi görür.
- Activepieces'in MCP ile entegrasyonu, parçalarınızı çalıştırılabilir araçlara dönüştürerek doğal dil ile tetiklenen çoklu uygulama akışları oluşturmanıza olanak tanır.
Activepieces'ı MCP ile bağlamak, yapay zekâ destekli bir asistan kullanmanıza olanak tanır. Doğal dil kullanarak otomasyonlar oluşturun, inceleyin ve test edin.Görsel düzenleyiciden her adımı manuel olarak oluşturmak yerine, sihirbazdan mevcut entegrasyonları incelemesini, bir taslak oluşturmasını ve yayınlamadan önce hataları tespit etmesini isteyebilirsiniz.
Activepieces, uyumlu kendi sunucusunu bünyesinde barındırır. Model Bağlam ProtokolüBu sunucu, otomasyon platformu ile Claude Desktop, Claude.ai, Cursor veya Windsurf gibi istemciler arasında standartlaştırılmış bir arayüz görevi görür.
Mevcut entegrasyon, yalnızca birkaç eylemi ortaya çıkarmaktan çok daha öteye gidiyor. Sihirbaz, akış yapısını sorgulayabilir, eylemleri ve tetikleyicileri arayabilir, tabloları yönetebilir, başarısız yürütmeleri analiz edebilir ve uygun izinleri verirseniz, Otomasyonların tamamını değiştirmek veya yayınlamak.
Activepieces MCP sunucusu size neler yapmanıza olanak tanır?

Activepieces MCP sunucusu, uyumlu bir sihirbazın platform içindeki bir proje üzerinde çalışmasına olanak tanır. Birincil işlevi otomasyon motorunun yerini almak değil, modele kontrollü bir araç seti sağlamaktır. Bir konuşma aracılığıyla akışları incelemek ve yönetmek.
Örneğin, ondan şunları yapmasını isteyebilirsiniz:
- Mevcut akışları listeleyin ve hangilerinin etkinleştirildiğini kontrol edin.
- Otomasyonun yapısını ve yapılandırmasını okuyun.
- Verilen görev için uygun bir eylem bulun.
- Tetikleyicileri ve eylemleriyle birlikte eksiksiz bir akış oluşturun.
- Mevcut bir akışa koşullar, döngüler veya dallanmalar ekleyin.
- Yayınlamadan önce yapılandırmayı doğrulayın.
- Adımları tek tek deneyin ve sonuçlarınızı inceleyin.
- Başarısız olan işlemleri inceleyin ve karşılaşılan hatayı açıklayın.
- Activepieces tablolarını veya kayıtlarını oluşturun ve değiştirin.
Ayrıca farklı kişilere ait hisseleri de keşfedebilirsiniz. Parçalar Platformun bir parçasıdır. Bir Parça, Gmail, Slack, Google Sheets veya HubSpot gibi bir hizmet için mevcut olan tetikleyicileri ve eylemleri bir araya getiren entegrasyondur.
Bu, şununla karıştırılmamalıdır: Activepieces'in yerli temsilcileriPlatform içinde oluşturulan bir ajan, otomasyon sürecinin bir parçasıdır ve yürütme sırasında kararlar almak için bir model kullanır. Öte yandan, MCP sunucusu, harici bir asistanın projeyi oluşturmasına, incelemesine veya yönetmesine olanak tanır.
Activepieces'i MCP ile bağlamak için gerekenler
Başlamadan önce, aşağıdaki malzemelere sahip olduğunuzdan emin olun:
- Activepieces Cloud hesabı veya güncellenmiş, kendi kendine yönetilen bir kurulum.
- Yeterli yetkiye sahip olduğunuz bir proje.
- Uzak MCP sunucularıyla uyumlu bir istemci.
- Activepieces sunucunuzda barındırılıyorsa, HTTPS özellikli bir genel adres gereklidir.
- Proje içerisinde gerekli bağlantılar yapılandırıldı.
Node.js kurmanıza veya ayrı bir MCP sunucusu çalıştırmanıza gerek yok. Activepieces zaten gerekli uç noktayı içeriyor ve buna benzer bir adres sağlıyor:
https://tu-instancia.example.com/mcp
Slack, Google Drive veya CRM gibi uygulamalar kullanıyorsanız, öncelikle bağlantılarını Activepieces arayüzünden yapılandırın. Sihirbaz mevcut bir bağlantıyı seçebilecektir, ancak Parolanızı, API anahtarınızı veya OAuth belirtecinizi almayacaksınız..
Activepieces MCP sunucusu nasıl etkinleştirilir?
Sunucu, proje ayarlarından etkinleştirilir:
- Activepieces'e giriş yapın.
- Bağlamak istediğiniz projeyi açın.
- Girmek Ayarlar.
- Seçme MCP Sunucusu.
- İlgili anahtarı kullanarak sunucuyu etkinleştirin.
- İzin verilen araç kategorilerini inceleyin.
- Gösterilen adresi kopyalayın. Sunucu URL'si.
Yetkilendirmeler proje bazında uygulanır. Bu, bir asistanın üretimde kullanılan iş akışlarına erişim izni verilmeden test ortamına bağlanmasına olanak tanır.
İlk bağlantı için yalnızca sorgulama araçlarını etkin bırakmanız önerilir. İstemcinin nasıl davrandığını doğruladıktan sonra oluşturma, test etme veya yayınlama işlemlerini etkinleştirebilirsiniz.
Claude Desktop, Cursor veya Windsurf'e nasıl bağlanır?

Uzaktan MCP sunucularını destekleyen müşteriler, Activepieces tarafından sağlanan URL'yi doğrudan kullanabilirler. Genel yapılandırma yapısı aşağıdaki gibidir:
{
"mcpServers": {
"activepieces": {
"url": "https://tu-instancia.example.com/mcp"
}
}
}
Dosyanın veya ayarın konumu istemciye bağlıdır:
| Müşteri | Yapılandırmanın konumu |
|---|---|
| İmleç | .cursor/mcp.json proje için veya ~/.cursor/mcp.json küresel olarak |
| Windows'ta Claude Masaüstü | %APPDATA%\Claude\claude_desktop_config.json |
| macOS'ta Claude Masaüstü | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Rüzgar sörfü | Editör tercihlerindeki MCP ayarları |
| Claude.ai | Organizasyon Ayarları > Bağlayıcılar > Ekle > Özel bağlayıcı |
Ayarları kaydettikten sonra, gerekirse istemciyi yeniden başlatın. İlk bağlantı sırasında, kurulumu tamamlamak için bir tarayıcı penceresi açılacaktır. Activepieces ile OAuth yetkilendirmesi.
Giriş yapın, doğru projeyi seçin ve istenen erişimi verin. İstemci bir yetkilendirme belirteci saklayacaktır; API anahtarını yapılandırma dosyasına manuel olarak kopyalamanıza gerek yoktur.
Eski kılavuzlarda buna benzer bir komut yer alabilir. npx mcp-remote ve ile biten bir adres /sseBu yapılandırma önceki bir uygulamaya karşılık geliyordu. Mevcut uyumlu istemcilerde, şunu kullanmalısınız: URL'nin sonu /mcp.
Asistan hangi araçları kullanabilir?
Activepieces, MCP araçlarını çeşitli kategorilere ayırır. Bu araçlar şunlardır: Keşif Bunlar salt okunur olup her zaman erişilebilir durumdadır. Verileri değiştirebilen kategoriler her projede etkinleştirilebilir veya devre dışı bırakılabilir.
| Kategori | Bu size neler yapmanıza olanak tanır? |
|---|---|
| Keşif | Akışları, bağlantıları, parçaları, tabloları, yürütmeleri ve doğrulama hatalarını görüntüleyin. |
| Akış Yönetimi | Akışları oluşturun, çoğaltın, yeniden adlandırın, yayınlayın, etkinleştirin, devre dışı bırakın veya silin. |
| Akış Oluşturma | Tetikleyicileri veya eylemleri ekleyin, güncelleyin ve silin. |
| Yönlendirici ve Dallanma | Koşullu dallanmalar oluşturun ve değiştirin. |
| Açıklamalar | Tuval içerisinde notlar ekleyin ve yönetin. |
| Tablolar | Tablolar, alanlar ve kayıtlar oluşturun, ayrıca bunları değiştirin veya silin. |
| Testler ve Çalıştırmalar | Akışları test edin, eylemleri gerçekleştirin, sonuçları inceleyin ve başarısız olan işlemleri yeniden deneyin. |
Bazı işlemlerin önemli sonuçları vardır. İş akışını silme aracı, aynı zamanda onun sürümlerini de siler. İşlemi geri alma olanağı sağlamaz.Benzer şekilde, bir işlem gerçekleştirmek, gerçek bir bağlantı kullanarak e-posta göndermeyi, bir kaydı değiştirmeyi veya içerik yayınlamayı içerebilir.
Bu nedenle, tüm kategorileri otomatik olarak etkinleştirmek önerilmez. Yalnızca asistanın mevcut görev için ihtiyaç duyduğu yetenekleri verin.
Doğal dil kullanarak Activepieces iş akışı nasıl oluşturulur?

Bağlantı kurulduktan sonra, ihtiyacınız olan otomasyonu tanımlayabilirsiniz. Talimat ne kadar hassas olursa, modelin vermesi gereken belirsiz kararlar da o kadar az olur.
Örneğin:
Pazartesiden cumaya her sabah saat 9:00'da çalışan, ActivePieces tablosundan bekleyen kayıtları sorgulayan ve özetini Slack'e gönderen devre dışı bırakılmış bir taslak oluşturun. Yalnızca mevcut bağlantıları kullanın. Akışı doğrulayın ve test edin, ancak yayınlamayın.
Olağan süreç şu sırayı izlemelidir:
- Projeyi inceleyin: Sihirbaz, mevcut akışları, tabloları ve bağlantıları kontrol eder.
- Araçları bulun: Tetikleyiciyi ve buna en uygun eylemleri belirleyin.
- Özelliklerini inceleyin: Gerekli alanları ve izin verilen seçenekleri getirir.
- Taslağı oluşturun: Tetikleyiciyi ve adımları doğru sırayla oluşturun.
- Yapıyı doğrulayın: Referansları, boş dalları ve eksik alanları kontrol edin.
- Bir test çözün: Kontrollü verilerle iş akışını veya belirli adımları yürütür.
- Sonuçları inceleyin: Girişleri, çıkışları, süreleri ve olası hataları gösterir.
- Yayınla ve etkinleştir: Bu işlemleri yalnızca onayınızdan sonra gerçekleştirin.
ActivePieces tek bir işlemle tüm bir akışı oluşturabilir, ancak bu, onu incelemeden yayınlamanız gerektiği anlamına gelmez. Sihirbaz tarafından döndürülen bağlantıyı açın ve kullanılan bağlantıları, ifadeleri ve alanları görsel olarak kontrol edin.
Eğer bir bağlantı eksikse, sihirbaz size nerede yapılandırabileceğinizi söyleyebilir, ancak yine de yetkilendirme işlemini Activepieces arayüzü üzerinden tamamlamanız gerekecektir. Bu tasarım, Yapay zekâ ajanlarını kimlik bilgilerini ifşa etmeden dahili sistemlere bağlayın..
Eylem ve tetikleyici arama nasıl çalışır?
Fonksiyon Araç Arama Bu özellik, asistana "Slack kanalına mesaj gönder" gibi bir görev tanımlama ve katalogdan en alakalı eylemleri alma olanağı sağlar.
Keşif akışı üç aşamadan oluşur:
- Keşfetmek: Doğal bir açıklama kullanarak eylemleri veya tetikleyicileri arayın.
- İncelemek: Seçilen seçeneğin tüm şemasını ve alanlarını elde eder.
- Çalıştır veya derle: Bu işlemi bir kez kullanın veya sürekli bir iş akışına dahil edin.
Activepieces Cloud'da Araç Arama özelliği etkinleştirilmiştir. Kendi kendine yönetilen kurulumlarda, bu özelliği şu değişkeni kullanarak etkinleştirmeniz gerekir:
AP_TOOL_SEARCH_ENABLED=true
Değişiklik dinamik olarak okunur ve örneğin yeniden başlatılmasını gerektirmez. Anlamsal sonuçlar elde etmek için Activepieces ayrıca bir gömme modeline ve uzantıya sahip bir PostgreSQL veritabanına ihtiyaç duyar. pgvector.
Gömme dosyaları için kullanılan anahtarı şu şekilde sağlayabilirsiniz:
AP_OPENAI_API_KEY=tu_clave
Platform yönetiminden OpenAI'yi sağlayıcı olarak da yapılandırabilirsiniz. Gömme modeli mevcut değilse veya anlamsal indeksleme başarısız olursa, Araç Arama işlevi çalışmaya devam eder. anahtar kelime eşleşmeleri.
Activepieces MCP erişimini nasıl koruyabilirsiniz?
Sunucu OAuth kullanır, işlemleri yetkilendirilmiş projeyle sınırlandırır ve saklanan anahtarları veya belirteçleri istemciye geri göndermez. Ancak, sırları korumak tüm riskleri ortadan kaldırmaz: yürütme araçlarına sahip bir sihirbaz... dolaylı olarak bu kimlik bilgilerini kullanmak Gerçek eylemleri gerçekleştirmek.
Büyük otomasyonlarla birlikte MCP'yi kullanmadan önce aşağıdaki önlemleri uygulayın:
- İlk testler için ayrı bir proje oluşturun.
- Yalnızca gerekli araç kategorilerini etkinleştirin.
- Minimum yetkilere sahip uygulama hesaplarını kullanın.
- Gerekmedikçe yayınlamaya, silmeye veya akışları etkinleştirmeye izin vermeyin.
- Mesaj göndermeden veya harici verileri değiştirmeden önce onay isteyin.
- Taslağı yayınlamadan önce yapıyı manuel olarak kontrol edin.
- Her büyük değişiklikten sonra yürütmeleri ve kayıtları inceleyin.
- Cihaz veya istemci artık kullanılmıyorsa OAuth yetkilendirmesini iptal edin.
Finansal süreçler, CRM değişiklikleri, dış iletişim veya bilgi silme işlemleri için tavsiye edilir. Yapay zeka iş akışına insan onayı ekleyin.Model operasyonu hazırlayabilir, ancak son adımın bir kişi tarafından onaylanması gerekir.
Kendi sunucunuzda barındırma, Activepieces'i kendi altyapınızda tutmanıza olanak tanır, ancak Bu durum, mevzuata uyumluluğu otomatik olarak garanti etmez.Nihai güvenlik aynı zamanda proxy'ye, veritabanına, izinlere, yedeklemelere ve kurumsal politikalara da bağlıdır.
Ters proxy'nin arkasında MCP nasıl yapılandırılır?
Kendi kendine yönetilen bir kurulumda, Activepieces genel adresine MCP istemcisinden erişilebilmeli ve geçerli HTTPS bağlantısı bulunmalıdır. Örnek bir etki alanının kök dizininde yayınlanıyorsa, tipik uç nokta şu olacaktır:
https://automatizacion.example.com/mcp
Activepieces bir alt rota altında olduğunda, onu mutlaka dahil etmelisiniz. AP_FRONTEND_URL:
AP_FRONTEND_URL=https://automatizacion.example.com/activepieces
Bu durumda, MCP sunucusuna şu adresten erişilebilecektir:
https://automatizacion.example.com/activepieces/mcp
Proxy, hem Activepieces trafiğini hem de OAuth yetkilendirmesi sırasında kullanılan uç noktaları iletmelidir. Bazı istemciler rota arar. /.well-known/oauth-* Doğrudan etki alanı kökünde. Eğer istemci keşif başlığını yok sayarsa, bu rotaları iletmek için ek bir kural oluşturmanız gerekecektir.
Test konteynerini doğrudan HTTP üzerinden açığa çıkarmayın. İstikrarlı bir alan adı, TLS ve uygun yapılandırma kullanın. AP_FRONTEND_URLÇünkü dahili ve dışa açık adres arasındaki bir tutarsızlık OAuth yönlendirmesini bozabilir.
Activepieces'i MCP ile bağlarken sık karşılaşılan hatalar

İstemci, mcp-remote veya /sse ile biten bir adres kullanmaya çalışıyor.
Şu anda daha önceki bir sürüme ait bir kılavuzu takip ediyorsunuz. Mevcut sunucu, uzaktan URL'si ile biten bir adres kullanılarak yapılandırılmıştır. /mcpEski komutu kaldırın ve sunucuyu yeniden kaydedin.
MCP Sunucusu seçeneği etkinleştirilmemiş.
Girmek Ayarlar > MCP SunucusuServisi etkinleştirin ve adresi tekrar kopyalayın. Ayrıca, doğru proje üzerinde çalıştığınızdan emin olun.
OAuth yetkilendirmesi bir döngüye giriyor.
Anonsun tam olarak eşleştiğini doğrulayın. AP_FRONTEND_URLAlt rota kullanıyorsanız, proxy kurallarını ve OAuth keşif uç noktalarını gözden geçirin.
Asistan yalnızca akışları okuyabilir.
Keşif araçları salt okunurdur. Bunları açıkça etkinleştirin. Akış Yönetimi, Akış Oluşturma veya projenin MCP yapılandırmasında istenen başka bir kategori.
Hisse senedi arama araçları görünmüyor.
Kendi kendini yöneten bir örnekte, şunları doğrulayın: AP_TOOL_SEARCH_ENABLED=trueArama çalışıyor ancak yalnızca birebir eşleşmeler buluyorsa, yerleştirme sağlayıcısını ve kullanılabilirliğini kontrol edin. pgvector.
Sihirbaz bir eylem buluyor ancak onu gerçekleştiremiyor.
Entegrasyon, henüz mevcut olmayan veya hata veren bir bağlantı gerektirebilir. Activepieces'ı açın, arayüzden bağlantıyı yapılandırın ve ardından tekrar çalıştırma isteğinde bulunun.
Asistan yanlış proje üzerinde çalışıyor.
Mevcut projeleri görüntülemesini ve doğru bağlamı açıkça belirlemesini isteyin. Sonraki işlemler bu projeyle sınırlı olacaktır.
Akış oluşturuldu, ancak çalışmıyor.
Hâlâ taslak halinde olup olmadığını, yayınlanıp yayınlanmadığını ve durumunu kontrol edin. EtkinleştirilmişAyrıca tetikleyicinin geçerli bir örneğe sahip olduğundan ve tüm bağlantıların aktif olduğundan emin olun.
Test başarılı oluyor, ancak asıl uygulama başarısız oluyor.
Yürütme geçmişini inceleyin ve her adımın sonucunu açın. Test, daha sonra gerçek tetikleyici tarafından alınan verilerden farklı örnek veriler kullanmış olabilir.
Asistan, çok riskli bir eylem hazırladı.
Doğrudan çalıştırmayın. İzin verilen kategori sayısını azaltın, onay gerektirecek şekilde uyarıyı değiştirin ve geri döndürülemez herhangi bir işlemden önce insan onayı aşaması ekleyin.
ActivePieces'ı MCP ile bağlamak, sihirbazı otomasyon oluşturma ve sürdürme arayüzüne dönüştürür, ancak varsayılan olarak sınırsız erişim sağlamaz. Sunucu, sorgu araçlarını yazma yeteneklerinden ayırır ve kimlik bilgilerini proje içinde tutar.
Önerilen kurulum, MCP sunucusunu etkinleştirmeyi, URL'sini kopyalamayı, istemciyi OAuth aracılığıyla yetkilendirmeyi ve salt okunur araçlarla başlamayı içerir. Ardından, canlı veriler veya hesaplarla kullanmadan önce her iş akışını inceleyerek, aşamalı olarak derleme, test etme ve yayınlama işlemlerini etkinleştirebilirsiniz.
İndeks
- 1 Activepieces MCP sunucusu size neler yapmanıza olanak tanır?
- 2 Activepieces'i MCP ile bağlamak için gerekenler
- 3 Activepieces MCP sunucusu nasıl etkinleştirilir?
- 4 Claude Desktop, Cursor veya Windsurf'e nasıl bağlanır?
- 5 Asistan hangi araçları kullanabilir?
- 6 Doğal dil kullanarak Activepieces iş akışı nasıl oluşturulur?
- 7 Eylem ve tetikleyici arama nasıl çalışır?
- 8 Activepieces MCP erişimini nasıl koruyabilirsiniz?
- 9 Ters proxy'nin arkasında MCP nasıl yapılandırılır?
- 10 Activepieces'i MCP ile bağlarken sık karşılaşılan hatalar
- 10.1 İstemci, mcp-remote veya /sse ile biten bir adres kullanmaya çalışıyor.
- 10.2 MCP Sunucusu seçeneği etkinleştirilmemiş.
- 10.3 OAuth yetkilendirmesi bir döngüye giriyor.
- 10.4 Asistan yalnızca akışları okuyabilir.
- 10.5 Hisse senedi arama araçları görünmüyor.
- 10.6 Sihirbaz bir eylem buluyor ancak onu gerçekleştiremiyor.
- 10.7 Asistan yanlış proje üzerinde çalışıyor.
- 10.8 Akış oluşturuldu, ancak çalışmıyor.
- 10.9 Test başarılı oluyor, ancak asıl uygulama başarısız oluyor.
- 10.10 Asistan, çok riskli bir eylem hazırladı.