Şablon uygulama
templates.apply, tools/list içinde kullanılabilir olduğunda, şablonun tüm kaynaklarını oluşturmak için yayımlanmış bir templateId ve mevcut bir spaceId sağlayın. Uygulamalar, Automation’lar ve sıradan dosya kopyaları o Space’e aittir; Skill’ler organizasyona aittir. Dosyalar, Space kökünde yapılandırılmış dosya adlarını kullanır ve mevcut dosyaların üzerine asla yazmaz. Aynı adlı bir çakışma o bileşenin başarısız olmasına neden olurken bağımsız bileşenler devam edebilir. Dosyanın tamamlanması, baytların ve meta verilerin kalıcı olarak kaydedildiği anlamına gelir; dizine eklemeyi beklemez.
İsteğe bağlı olarak connections değerini, sağlayıcı başına en fazla bir bağlantı olacak şekilde { connector, connectionId } nesnelerinden oluşan bir dizi olarak sağlayın. Sağlanan bağlantılar erişilebilir ve uyumlu olmalı, gerektiğinde de Space’e zaten atanmış olmalıdır. Atlanan bağlantılar, kaynakları yapılandırma bekler durumda bırakır. Yanıt, uygun bağlantıları ya da hiçbiri yoksa bir bağlantı oluşturulmasını önerir.
Oluşturma, bağımlılık sırasına göre tek bir Trigger.dev görevinde çalışır ve bileşen sonuçları görevin meta verilerine ve çıktısına kaydedilir. Tüm görevin otomatik olarak yeniden denenmesi devre dışıdır; başarısız olan veya kesintiye uğrayan bir görev kısmi kaynaklar bırakabilir. Yanıt, oluşturmanın kuyruğa alındığını onaylar ve planlanan bileşenleri ve bağlantı önerilerini içerir; kaynakların oluşturulmasının tamamlandığını onaylamaz. Kaynakları bulmak ve incelemek için kaynakların list/get araçlarını kullanın. Başka bir bileşen başarısız olsa bile başarılı kaynaklar korunur.
Bir şablonu uygulamak, çalıştırılabilirlik doğrulamasını erteler ve kaynaklarını etkinleştirmez veya çalıştırmaz. Yeniden denemeler dahil her uygulama çağrısı yeni kopyalar oluşturur. Nelerin oluşturulduğunu incelemek için kaynak araçlarını kullanın.
Bağlanmadan önce
İhtiyacınız olanlar:- Kullanmak istediğiniz organizasyona erişimi olan bir Flowglad hesabı.
- Organizasyonunuzun production MCP URL’si.
- Streamable HTTP ve OAuth üzerinden uzak bir MCP sunucusunu destekleyen bir agent veya istemci.
- Amaçladığınız iş için gereken organizasyon ve Space izinleri.
- İlgili Space’te zaten kullanılabilir olan kaynak Connection’lar veya dosyalar.
Organizasyon URL’nizi bulun
Production connector’ı organizasyona özgü bir URL kullanır:{orgId} yerine gerçek Flowglad organizasyon ID’nizi yazın. org_ öneki dahil ID’nin tamamını koruyun. Süslü parantezleri veya uydurma bir organizasyon ID’sini girmeyin.
Flowglad’de Settings → MCP → Add MCP Connection → Claude → Website yolunu açın. Orada gösterilen organizasyon MCP URL’sini kopyalayın. Uzak bir URL için Website talimatlarını kullanın; ayrı Desktop app sekmesi komut satırı kurulum talimatlarını içerir.
Bu ayarlara erişemiyorsanız Flowglad yöneticinize veya destek ekibine başvurun.
Bu connector için organizasyon URL’sini kullanın. Connection’a özgü bir URL daha dar bir araç kümesi sunabilir ve burada açıklanan organizasyon URL’siyle birbirinin yerine kullanılamaz.
Claude Desktop’tan bağlanın
Claude Desktop kurulum videosunu izleyin veya aşağıdaki adımları izleyin.
Flowglad’i eklemek ve hesabınıza erişimi yetkilendirmek için Claude Desktop’ın özel connector akışını kullanın.
1. Özel connector formunu açın.
Claude Desktop’ta Customize → Connectors → + Add → Add Custom Connector yoluna gidin.
2. Flowglad connector’ını ekleyin.
Connector adı olarak Flowglad girin veya başka bir ad seçin.
Tam organizasyon MCP URL’nizi URL alanına yapıştırın. URL’yi Settings > MCP sayfasından kopyalayabilirsiniz. Şuna benzemelidir:
https://dashboard.flowglad.com/api/mcp/orgs/org_...
Diğer connector ayarlarını değiştirmeyin. Devam etmek için Add seçeneğini seçin. Claude Desktop bazı sürümlerde bu düğmeyi Continue olarak adlandırabilir.
3. Claude’a Flowglad erişimi verin.
Claude’un Flowglad hesabınıza erişmesini yetkilendirmek için bağlantı akışına devam edin. İstendiğinde oturum açın, hedeflenen Flowglad organizasyonunu onaylayın ve yetkilendirmeden önce istenen erişimi gözden geçirin.
Akış tamamlandığında Claude Desktop’a dönün ve Flowglad bağlantısının kullanılabilir olduğunu doğrulayın. Claude’dan Flowglad bağlantısını kontrol etmesini ve erişebildiğiniz Space’leri listelemesini isteyin.
Hedeflenen bağlantı yöntemi OAuth Dynamic Client Registration’dır. Sunucu URL’sine parola, erişim token’ı, API anahtarı veya client secret eklemeyin.
Bu talimatlar Flowglad’in doğrudan özel bir connector olarak bağlanmasını açıklar; dizinde bulunabilirlik ayrı bir konudur.
Başka bir MCP istemcisi bağlayın
Aynı organizasyon URL’sini uzak bir Streamable HTTP MCP sunucusu olarak ekleyin. İstemcinin OAuth akışını Flowglad hesabınızla tamamlayın, ardından organizasyonu ve kullanılabilir araçları doğrulayın. İstemci desteği farklılık gösterir. Başarılı bir sunucu bağlantısı, istemcinin Flowglad Skill’lerini otomatik olarak içe aktardığı anlamına gelmez. Skill keşif uzantısı veskills.list aracı farklı arayüzlerdir. Desteklenen keşif ve paket yönetimi davranışı için bkz. Skills.
Veri işleme
Flowglad MCP’nin kullanımı Flowglad Gizlilik Politikası ile düzenlenir. Organizasyon yöneticileri, organizasyonlarına yapılan tüm MCP araç çağrılarını Settings > Audit sayfasında görebilir.Sorun giderme
Genel güvenlik bilgileri için Security sayfasına ve Trust Center sayfamıza bakın. Bağlanırken herhangi bir sorun yaşıyorsanız bizimle iletişime geçin.
Destek ekibiyle iletişime geçerken zamanı, istemciyi, etkilenen aracı, güvenli hata kodunu ve varsa istek ID’sini ekleyin. Parolaları, bearer token’ları, cookie’leri, imzalı yükleme/indirme URL’lerini veya müşteri verilerini asla eklemeyin.