MCP ile Oluşturma
Flowera, AgentFlow'ları programatik olarak oluşturmanıza ve yönetmenize olanak tanıyan gömülü bir MCP sunucusu ile birlikte gelir — canvas üzerinde yapabileceğiniz her şey, node'ları sürüklemek yerine koddan veya bir yapay zeka kodlama asistanından yürütülür.
Bu sayfa geliştiriciler ve teknik kullanıcılar içindir. Akışları MCP üzerinden oluşturmak, API anahtarları, JSON istekleri ve node iç yapılarıyla çalışmak anlamına gelir. İlk kez bir bot oluşturuyorsanız, canvas üzerinde başlayın ve rahat hissettiğinizde buraya geri dönün — aşağıdaki her şey isteğe bağlıdır. Görsel oluşturucu ve MCP, tam olarak aynı akışları üretir.
Nedir
MCP (Model Context Protocol), yapay zeka asistanlarına ve betiklere araçlar sağlamaya yönelik açık bir standarttır. Flowera, MCP sunucusunu Flowera uygulamasının içinde — çalıştırılacak ayrı bir servis olmadan — tek bir uç noktada sunar:
POST /api/v1/mcp
Bunun üzerinden, bir istemci (örneğin bir yapay zeka kodlama asistanı ya da kendi betiğiniz) node paletini okuyabilir, bütün bir akışı veya tek bir node'u okuyabilir ve akışları oluşturabilir, güncelleyebilir, doğrulayabilir, çalıştırabilir ve dışa aktarabilir — AgentFlow arayüzünün yaptığı aynı işlemler, ama koddan çağrılabilir olarak. Sunucu, zahmetli kısımlarla ilgilenir: node'larınızın ve bağlantılarınızın basit bir tanımını eksiksiz, geçerli bir akışa dönüştürür ve kaydetmeden önce sonucu kontrol eder.
Ne zaman kullanırsınız
Çoğu iş için doğru yer canvas'tir. Şunları istediğinizde MCP'ye başvurun:
- Bir tanımdan akış oluşturmak — elle kurmak yerine.
- Bir şablondan birçok benzer akış oluşturmak (müşteri başına, bölge başına, kampanya başına).
- Akışları kod olarak sürümlemek veya incelemek, projenizin geri kalanıyla birlikte dışa ve içe aktarmak.
- Bir yapay zeka asistanının bir akışı sizin için oluşturmasına ve üzerinde çalışmasına izin vermek — sonucu tarif edin ve node'ları bağlamasını, bir model seçmesini ve bir test çalıştırmasını sağlayın.
- Tekrarlayan düzenlemeleri otomatikleştirmek — arayüzde tıklamalarla gezinmeden akışlar boyunca.
Kimlik doğrulama — bir Flowera API anahtarı
MCP, bir Flowera API anahtarı ile kimlik doğrular — API Anahtarları sekmesinde yönettiğiniz aynı anahtarlar. Her istekte bunu bir Bearer token olarak geçirin:
Authorization: Bearer <your-flowera-api-key>
Çalışma alanı anahtardan türetilir. Her işlem o tek çalışma alanına kapsanır ve sunucu, başka bir çalışma alanının akışlarına, verilerine veya kimlik bilgilerine her türlü erişimi engeller.
MCP yeteneğine sahip bir API anahtarı, o çalışma alanında akışları elle oluşturan biriyle aynı güce sahiptir — akışları oluşturabilir ve çalıştırabilir. Onu bir gizli bilgi olarak saklayın, asla kaynak kontrolüne göndermeyin ve sızdırılırsa döndürün.
MCP, anahtarınızın ait olduğu Flowera ortamının hangisiyse (yerel örneğiniz veya barındırılan bir tanesi) ona karşı çalışır — anahtar ve URL aynı yere işaret etmelidir.
Anahtar yapıştırmak yerine bir uygulama bağlamak
API anahtarı, MCP'yi kendiniz bir betikten veya kontrol ettiğiniz bir kodlama asistanından sürdüğünüzde doğru araçtır. Üçüncü taraf bir uygulamayı — örneğin Claude'u — bağlamak istediğinizde ise anahtarınızı ona yapıştırmak, o anahtarın yapabildiği her şeyi, kalıcı olarak ve anahtarın ait olduğu çalışma alanının tamamı üzerinde devretmek demektir.
Bu durum için Flowera uygulamayı bağlamayı da destekler — tıpkı Google veya Meta'yı bağladığınız gibi. Flowera'da oturum açarsınız, uygulamanın tam olarak ne istediğini görürsünüz ve onaylarsınız:
- Uygulama sizi Flowera'ya yönlendirir ve her zamanki gibi oturum açarsınız.
- Uygulamanın hangi çalışma alanında çalışabileceğini seçersiniz. Yalnızca onu alır, başkasını değil.
- Neler yapabileceğini görürsünüz — akışlarınızı okumak, oluşturmak, çalıştırmak, müşteri konuşmalarını okumak, bağlı hesapları görmek — her biri ayrı bir satır olarak, ve bilerek onaylarsınız.
- Flowera bağlantının nereye gönderildiğini gösterir; böylece gerçek bir uygulamayı onu taklit eden bir şeyden ayırt edebilirsiniz.
Bu şekilde bağlanan bir uygulama ihtiyacı olan en azı ister. Akışlarınızı okumak, müşterilerinizin konuşmalarını okumayı içermez; bir akış oluşturmak, onu gerçek müşteriler üzerinde çalıştırmayı içermez — bunlar uygulamanın ayrıca istemesi gereken ayrı izinlerdir.
Bağlı olanları yönetme
Bağladığınız her uygulama Flowera'da Bağlı uygulamalar altında görünür. Oradan:
- Her uygulamanın ne yapabildiğini ve hangi çalışma alanında çalıştığını görebilirsiniz.
- Yanlış seçtiyseniz uygulamayı başka bir çalışma alanına taşıyabilirsiniz.
- Bağlantısını kesebilirsiniz; anında etkili olur.
Bir uygulamayı ilk kez onayladıktan sonra yeniden bağlanması tekrar sormaz — bu yüzden fikrinizi değiştireceğiniz yer Bağlı uygulamalar'dır. Yanlış çalışma alanını seçtiyseniz, bağlantıyı kesip yeniden bağlamak yerine oradan değiştirin.
Bunların hiçbiri API anahtarlarının yerini almaz. Mevcut anahtarlarınız, betikleriniz ve asistanlarınız bugün olduğu gibi çalışmaya devam eder; bir uygulama bağlamak ek bir seçenektir, bir geçiş değil.
Bununla neler yapabilirsiniz
Sunucu, işlemlerini bir avuç alana gruplar. Genel hatlarıyla:
Yapı taşlarını keşfedin
- Node türlerini listeleyin ve yapılandırmadan önce bir node'un tam girdilerini okuyun — böylece bir parametre adını asla tahmin etmezsiniz.
- Dinamik seçenekleri çözümleyin (mevcut sohbet modelleri, bağlı WhatsApp/Instagram hesapları, alt akışlar, araçlar) çalışma alanınızdaki gerçek seçeneklere.
Mevcut akışları okuyun
- Çalışma alanındaki akışları listeleyin ve bütün bir akışı, tek bir node'u veya bağlantılarını okuyun.
- Bir akışın ne ürettiğini görmek için çalıştırmaları, mesajları ve lead'leri inceleyin.
Akışları oluşturun ve düzenleyin
- Minimal bir tanımdan bütün bir akış oluşturun — node'ları ve aralarındaki bağlantıları listelersiniz, sunucu da sizin için eksiksiz, canvas'la uyumlu akışı kurar.
- Cerrahi düzenlemeler yapın — tek bir node'u ekleyin, güncelleyin, yeniden adlandırın veya silin; iki node'u bağlayın veya bağlantısını kesin — geri kalanı yeniden kurmadan.
- Bir kaydetmeye güvenmeden önce doğrulayın, böylece bozuk bir bağlantıyı veya eksik bir modeli akış hiç çalışmadan önce yakalayın.
- Akışları çalışma alanları arasında taşımak veya dosya olarak saklamak için dışa ve içe aktarın.
Yapay zeka modelini seçin
- Mevcut modelleri listeleyin — her sağlayıcı ve model, hangilerinin kullanıma hazır bir platform anahtarı olduğu ve çalışma alanı kimlik bilgilerinizden hangilerinin geçerli olduğu.
- Agent, LLM, Koşullu Agent ve İnsan Girişi node'ları için bir node'un modelini tek adımda ayarlayın — sunucu, sağlayıcıyı, modeli ve kimlik bilgisini birlikte doğru şekilde yazar (elle yapıldığında yaygın bir "model gerekli" hatası kaynağı). Modeller'e bakın.
Çalıştırın ve hata ayıklayın
- Bir test mesajıyla bir akışı çalıştırın ve yanıtı geri alın, ayrıca hangi node'ların çalıştığını ve dallanma noktaları için hangi dalın tetiklendiğini gösteren kompakt bir izleme elde edin.
- Bir webhook'u tetikleyin ve çalıştırmalara, mesajlara ve lead'lere göz atın.
Kimlik bilgileri oluşturamaz veya yeni bir WhatsApp/Instagram hesabı bağlayamaz — bunlar arayüzde tek seferlik manuel adımlardır. MCP yalnızca çalışma alanınızda halihazırda var olan hesaplardan ve kimlik bilgilerinden seçim yapabilir.
Aynı kurallar hâlâ geçerlidir
MCP üzerinden oluşturulan akışlar, canvas üzerinde oluşturulan akışlarla aynı davranışa uyar — tuzaklar dahil. Özellikle:
- Koşullu Agent' ın hâlâ otomatik bir Else'i yoktur — açık bir hepsini yakalayan senaryo ekleyin.
{{ }}içindeki çalışma zamanı değerleri hâlâ$önekiyle yazılır ({{$question}},{{$flow.state.name}}).name/email/phonedurum anahtarları hâlâ Lead sütunlarına senkronize olur.
Kaydedilen bir akış mutlaka çalıştırılabilir değildir — sunucu, çalışıp çalışamayacağını bildirir ve onu engelleyen her şeyi (örneğin modelsiz bir node) listeler. Çalıştırmadan önce engelleyicileri giderin.