MCP Uç Noktası
IronFlock bir MCP sunucusudur. Claude ve Model Context Protocol’ü konuşan diğer her istemci, API anahtarınızın izin verdiği ölçüde, projelerinizi listeleyebilir, cihazlarını, uygulamalarını ve verilerini okuyabilir ve IronFlock’un sunduğu araçlarla bunlar üzerinde işlem yapabilir. Uç nokta, REST API ile aynı API hizmetinin bir parçasıdır ve aynı API anahtarlarını kullanır.
Adres ve Kimlik Doğrulama
| IronFlock bulutunda URL | https://api.ironflock.com/mcp |
| Bir Appliance’ta URL | https://api. ardından Appliance’ın alan adı, sonra /mcp; Appliance IronFlock API hizmetini çalıştırdığı andan itibaren |
| Taşıma | Streamable HTTP |
| Kimlik doğrulama | Authorization: Bearer <your API key> |
API anahtarını Studio’da API Anahtarı Oluşturma bölümünde açıklandığı gibi oluşturun. Her istek anahtarı taşır. Anahtarı olmayan ya da geçerli olmayan (silinmiş, süresi dolmuş veya başka bir IronFlock’a ait) bir anahtarla yapılan bir istek HTTP 401 ile yanıtlanır. Sunucu tarayıcı üzerinden oturum açma (OAuth) sunmaz: anahtar tek giriş yoludur.
Sunucu oturum tutmaz. Her istek kendi başına yanıtlanır; böylece bir istemci serbestçe bağlanabilir, bağlantıyı kesebilir ve yeniden bağlanabilir. Sunucu her isteğe tek bir JSON gövdesiyle yanıt verir ve dinlenecek bir olay akışı yoktur.
Claude’u Bağlama
Anahtarı Claude’un kendi ayarlarına kendiniz girersiniz. Onu asla bir sohbete yapıştırmayın.
Claude Code
Claude Code, IronFlock’un MCP sunucusunu bildiren ironflock eklentisi üzerinden bağlanır. Terminalde, IDE eklentilerinde ve Claude masaüstü uygulamasının Code sekmesinde çalışır.
-
Bir Claude Code oturumunda pazar yerini ekleyin ve eklentiyi kurun:
/plugin marketplace add IronFlock/agent-skills /plugin install ironflock@ironflock -
Kurulum iki ayar içeren bir iletişim kutusu açar. IronFlock API address, bulut için
https://api.ironflock.com, bir Appliance için isehttps://api.ardından Appliance’ın alan adıdır; her iki durumda da/mcpolmadan ve sonda eğik çizgi olmadan. IronFlock API key, Studio’dan alınan anahtardır. Claude Code onu bir ayar dosyasında değil, sistemin güvenli kimlik bilgisi deposunda tutar. -
Claude Code’u yeniden başlatın. Ardından
/mcp,plugin:ironflock:ironflocksunucusunu bağlı olarak listeler.
Ayarları daha sonra /plugin configure ironflock@ironflock ile değiştirin ve Claude Code’u yeniden başlatın. Anahtar ayarlanana kadar sunucu başlamaz. Bir kabuktan yapılan kurulum (claude plugin install) iletişim kutusunu açmaz; bu nedenle onu bir oturumda /plugin configure ironflock@ironflock ile tamamlayın. Claude Code ile Geliştirme sayfası eklentileri ve becerilerini açıklar.
Web’de, Masaüstünde ve Telefonda Claude ile Cowork
Eklentinin kendi bağlantısı yalnızca Claude Code’da çalışır. Claude uygulamasının sohbetinde ve Cowork’te IronFlock’u bir kez, anahtarı bir istek başlığı olarak içeren özel bir bağlayıcı olarak eklersiniz. Özel bağlayıcılardaki istek başlıkları, sınırlı sayıda kuruluşun kullanabildiği bir betadır. Aşağıdaki iletişim kutusunda Request headers bölümü yoksa kuruluşunuzda bu özellik henüz yoktur ve IronFlock şimdilik orada bağlanamaz: Claude Code çalışır.
- Customize > Connectors’ı açın, Add’i, ardından Add custom connector’ı seçin.
IronFlockadını vehttps://api.ironflock.com/mcpsunucu URL’sini girin.- Authentication değerini No sign-in olarak ayarlayın.
- Request headers altında, değeri
Bearerve ardından anahtarınız olanAuthorizationbaşlığını ekleyin: Bearer kelimesi, bir boşluk, ardından anahtar.Bearerolmadan IronFlock isteği reddeder. - Add’i seçin.
Team ve Enterprise planlarında bağlayıcıyı bir sahip Organization settings > Connectors altında, Add, ardından Custom ile ekler; istek başlıkları Advanced altında olabilir. O bağlayıcıyı kullanan herkes, sahibin girdiği tek anahtarla işlem yapar; bu nedenle ona yalnızca hepsinin kullanabileceği kapsamları ve projeleri verin.
Bir bağlayıcının istek başlıkları düzenlenemez: anahtarı değiştirmek için bağlayıcıyı kaldırın ve yeniden ekleyin. Bağlayıcı Anthropic’in sunucularından bağlanır; bu nedenle adresin internetten erişilebilir olması gerekir. Bulut için bu durum geçerlidir. Yalnızca şirket ağınızın ulaşabildiği bir Appliance genellikle orada bağlanamaz; o ağdaki bir bilgisayarda çalışan Claude Code ise bağlanabilir.
Diğer MCP İstemcileri
Streamable HTTP’yi ve bir istek başlığını destekleyen her istemci, URL ve Authorization: Bearer <your API key> başlığıyla bağlanır. Anahtarı paylaştığınız veya commit ettiğiniz dosyaların dışında tutun.
Bağlantıyı Kontrol Etme
Claude’dan IronFlock projelerinizi, ardından bunlardan birinin cihazlarını listelemesini isteyin. Claude, yalnızca okuyan list_projects ve list_devices araçlarını çağırır.
Araçlar
Sunucu bu alanlarda 33 araç sunar. Bunların çoğu tek bir projede çalışır ve list_projects aracının verdiği swarm_key değerini alır. Bir şeyi değiştiren veya silen bir araç bu şekilde işaretlenir; böylece Claude gibi istemciler onu çağırmadan önce size sorabilir.
Projeler
| Araç | Kapsam | Ne yapar |
|---|---|---|
list_projects | devices:read | Anahtarın çalışabildiği projeleri listeler |
Cihazlar
| Araç | Kapsam | Ne yapar |
|---|---|---|
list_devices | devices:read | Bir projenin cihazlarını, her birinde kurulu uygulamaları, bunların çalışıp çalışmadığını ve cihazın çevrimiçi olup olmadığını listeler |
create_device | devices:write | Projede bir cihaz oluşturur ve cihazın anahtarını ve adını yanıt olarak verir |
delete_device | devices:write | Bir cihazı projeden kalıcı olarak siler |
Bir Projedeki Uygulamalar
| Araç | Kapsam | Ne yapar |
|---|---|---|
list_project_apps | apps:read | Projede kurulu uygulamaları ve her birinin kaç cihazda çalıştığını listeler |
check_app_status | apps:read | Bir uygulamanın cihazlarında çalışıp çalışmadığını ve verilerinin gelip gelmediğini gösterir |
install_app | apps:write | Bir mağaza uygulamasını projeye ve isteğe bağlı olarak cihazlara kurar |
set_app_state | apps:write | Kurulu bir uygulamayı cihazlarda başlatır veya durdurur |
update_app | apps:write | Kurulu bir uygulamayı en yeni sürümüne günceller |
uninstall_app | apps:write | Bir uygulamayı cihazlardan veya projenin tamamından kaldırır |
Uygulama Mağazası ve Maliyetler
| Araç | Kapsam | Ne yapar |
|---|---|---|
search_apps | apps:read | Uygulama mağazasında yeteneğe göre arama yapar ve eşleşen uygulamaları fiyatlarıyla döndürür |
get_app_details | apps:read | Bir ila üç mağaza uygulamasının açıklamasını, README dosyasını ve fiyatını okur |
get_install_quote | apps:read | Bir uygulamayı kurmanın ne kadara mal olacağını ve kurulumu neyin engelleyeceğini bulur |
estimate_project_cost | apps:read | Bir proje kurulumunun yıllık maliyetini tahmin eder; hiçbir şey satın alınmaz |
sync_app_to_store | apps:write | Yalnızca bir Appliance’ta: IronFlock bulut mağazasındaki bir uygulamayı Appliance’ın kendi mağazasına kopyalar |
Veriler
| Araç | Kapsam | Ne yapar |
|---|---|---|
get_schema | data:read | Projenin veritabanını açıklar: tablolarını, görünümlerini ve sütunlarını |
execute_sql | data:read | Projenin veritabanında salt okunur tek bir SELECT sorgusu çalıştırır |
list_dashboards | data:read | Projenin panolarını listeler |
list_app_files | data:read | Bir uygulamanın projede sakladığı dosyaları listeler ve bunlarda arama yapar |
read_app_file | data:read | Bir uygulamanın sakladığı tek bir dosyayı okur: metin, görüntü veya başka bir dosya |
save_transform | data:write | Panolar için türetilmiş bir değeri canlı tutan özel bir dönüşüm oluşturur veya değiştirir |
delete_transform | data:write | Özel bir dönüşümü kalıcı olarak siler |
Alarmlar
| Araç | Kapsam | Ne yapar |
|---|---|---|
list_alarms | alarms:read | Projenin alarmlarını durumları, tetikleyicileri ve alıcılarıyla listeler |
create_alarm | alarms:write | Bir uygulamanın veri tablosunu izleyen bir alarm oluşturur |
update_alarm | alarms:write | Bir alarmın tetikleyicisini veya alıcılarını değiştirir ya da alarmı duraklatır ve sürdürür |
delete_alarm | alarms:write | Bir alarmı geçmişiyle birlikte kalıcı olarak siler |
Günlükler ve Denetim Günlüğü
| Araç | Kapsam | Ne yapar |
|---|---|---|
get_app_logs | logs:read | Bir uygulamanın kendi günlük çıktısını çalıştığı cihazlardan okur |
get_device_logs | logs:read | Bir cihazın kendisinin ne yaptığını okur: uygulamalar, indirmeler, disk, ağ, ajan güncellemeleri |
query_audit_log | logs:read | Denetim günlüğünde salt okunur tek bir sorgu çalıştırır: projeyi, cihazlarını, gruplarını ve uygulamalarını kimin ve ne zaman değiştirdiği |
get_appliance_health | devices:read | Yalnızca bir Appliance’ta: Appliance’ın kendi platform hizmetlerinin, diskinin, belleğinin, lisansının ve güncellemelerinin durumunu kontrol eder |
get_appliance_logs | logs:read | Yalnızca bir Appliance’ta: Appliance platformunun bir bölümünün günlüğünü okur |
Uygulama Araçları
Uygulamalar, AI ajanlarıyla birlikte kendi araçlarını getirir: bir cihazda çalışan, bir makinenin durumunu okumak veya bir ayarı değiştirmek gibi uygulama işlevleri. Bunlara iki araç ulaşır.
| Araç | Kapsam | Ne yapar |
|---|---|---|
list_app_tools | apptools:call | Kurulu bir uygulamanın araçlarını, bağımsız değişkenleri ve uygulamanın ajanlarının talimatlarıyla birlikte listeler |
call_app_tool | apptools:call | Bunlardan birini projenin tek bir cihazında çalıştırır |
call_app_tool bir cihazda çalışır ve bir uygulamanın aracı orada bir şeyleri değiştirebilir. Cihaz, projenin anahtar sahibinin görebildiği cihazlarından biri olmalıdır ve sahibin, uygulamayı panosundan işletirken olduğu gibi, uygulamanın verilerini kullanma hakkı olmalıdır. Uygulama tam olarak verilen bağımsız değişkenleri alır, başka hiçbir şey almaz. Bir uygulamanın geliştirme sürümünün araçları değil, yalnızca kurulu sürümün araçları listelenir. Bir aracın metinleri uygulamanın geliştiricisi tarafından yazılır ve sabit bir uzunlukta kesilir.
Kapsamlar
Her araç, yukarıdaki tablolarda gösterilen tek kapsamı gerektirir. Sunucu bir istemciye yalnızca anahtarın kullanabileceği araçları sunar ve diğer her aracı yokmuş gibi reddeder. Anahtar neye izin verirse versin, bir araç asla anahtar sahibinin IronFlock’ta yapabileceğinden fazlasını yapmaz. releases:publish için bir araç yoktur: bu kapsam, sürüm derleyen REST işlemleri içindir. Hepsi için bkz. Kapsamlar; bunları Studio’da nasıl seçeceğiniz için bkz. API Anahtarı Oluşturma.
Projelerle kısıtlanmış bir anahtar yalnızca bu projeleri görür. Tek bir uygulamayla kısıtlanmış bir anahtara yalnızca bir uygulama için işlem yapan araçlar sunulur; dolayısıyla list_projects sunulmaz. Hiçbirine tek bir projenin ötesine uzanan araçlar sunulmaz: sorgusu sahibin okuyabildiği herhangi bir projenin varlıklarını adlandırabilen query_audit_log, hiçbir projeye ait olmayan iki Appliance aracı ve Appliance’ın mağazasını herkes için değiştiren sync_app_to_store.
Bazı araçlar ek kurallar taşır:
install_app, size gösterilenget_install_quoteyanıtını alır ve o tekliften bu yana fiyat veya teklifin başka herhangi bir yönü değiştiyse hiçbir şey kurmaz. Ücretli bir uygulama kurmak para tutar.set_app_stateveupdate_apptek bir çağrıda en fazla 10 cihazı değiştirir.create_deviceyeni cihazın anahtarını ve adını yanıt olarak verir; cihazın kimlik bilgilerini içeren yapılandırma dosyasını asla vermez. Dosyayı Studio’da, cihazın ayarlarında Bakım > Cihaz Yapılandırma Dosyası > Yapılandırma dosyasını indir altından indirin ya da cihazı makinede, cihazı oluşturan ve dosyayı makinede tutanironflock agent install --project <project> --name <name>ile kurun (Oturum Açma ve Cihaz Yönetimi).- Bir proje aynı anda tek bir özel dönüşüm kaydeder. İlki çalışırken ikinci bir
save_transformreddedilir. - Bir hesap
query_audit_logaracını aynı anda bir kez ve dakikada altı kez çalıştırabilir, çünkü arkasındaki veritabanı paylaşılır. - Çağrısının süresi içinde bitmeyen bir değişiklik yine de yapılmış olabilir. Sonuç bunu söyler ve araç değişikliği tekrarlamaz.
Sonuçlar
Bir sonuç JSON’dur: yapılandırılmış içerik olarak ve bir metin bloğunda aynı JSON olarak gelir. Uzun bir liste 50.000 karaktere sığacak şekilde kesilir ve cut üyesi kaç girdinin dışarıda bırakıldığını ve nasıl devam edileceğini söyler. Görüntüler (PNG, JPEG, GIF ve WebP) görüntü olarak, PDF gibi diğer dosyalar ise medya türleriyle birlikte gömülü kaynaklar olarak gelir.
Bir araç isteneni yapamadığında sonucu hata olarak işaretlenir ve nedenini bir cümleyle söyler; örneğin bir projenin var olmadığını veya platformun zamanında yanıt vermediğini.
Sınırlar
API anahtarı başına varsayılanlar şunlardır:
| Sınır | |
|---|---|
| İstekler | Dakikada 120, en fazla 30’luk ani artışlarla |
| Aynı anda açık istekler | 8 |
| İstek gövdesi | 1.114.112 bayt: 1 MiB bağımsız değişken ve onu çevreleyen mesaj |
| Tek bir araç çağrısı | 90 saniye |
| Bir veritabanı sorgusu | 30 saniye; execute_sql, siz daha fazlasını istemedikçe 100 satır, en fazla 1.000 satır döndürür |
| Tek bir sonuç | 50.000 karakter; call_app_tool sonucu 45.000 karakterde kesilir |
Hatalar
| Yanıt | Anlamı | Ne yapmalı |
|---|---|---|
401 | Anahtar eksik, yanlış yazılmış veya kesilmiş, silinmiş, süresi dolmuş ya da başka bir IronFlock’a ait. Bir bağlayıcıda Bearer eksik olabilir | Bağlandığınız IronFlock’un Studio’sunda yeni bir anahtar oluşturun ve yeniden girin |
/mcp adresinde 404 | Adreste /mcp iki kez geçiyor ya da IronFlock örneği uç noktayı henüz sunmuyor, örneğin IronFlock API hizmetini çalıştırmayan bir Appliance | Adresi düzeltin; aksi halde bulutu kullanın |
405 | /mcp üzerinde GET ve DELETE: sunucunun olay akışı ve sonlandırılacak oturumu yoktur | POST kullanın |
413 | İstek gövdesi çok büyük | Tek bir çağrıda daha az gönderin |
429 | Anahtar çok fazla istek yaptı veya aynı anda çok fazla açık isteği var. Retry-After başlığı kaç saniye bekleneceğini söyler | O kadar bekleyin, ardından aynı anda daha az çağrıyla devam edin |
503 | Platform şu anda kullanılamıyor ya da hizmet kapanıyor | Bir dakika içinde yeniden deneyin |
504 | Platform zamanında yanıt vermedi | Bir dakika içinde yeniden deneyin |
İsteneni yapamayan bir araç HTTP hatasıyla yanıt vermez: sonucu hata olarak işaretlenir ve neyin yanlış gittiğini bir cümleyle açıklar.
Anahtarınızı Güvende Tutma
- Bir anahtarı asla bir sohbete yapıştırmayın. Yapıştırdıysanız anahtar o konuşmanın bir parçasıdır: anahtarı Studio’da silin, yenisini oluşturun ve ayarlara girin.
- Studio yeni bir anahtarı yalnızca bir kez, oluşturduğunuzda gösterir. Onu hemen istemcinin ayarlarına kaydedin.
- Onu kullanan her yer için bir anahtar kullanın; böylece birini diğerlerini bozmadan silebilirsiniz. Artık kullanmadığınız anahtarları silin. Bir anahtar bir yıl geçerlidir.
- Bir anahtara yalnızca Claude’un ihtiyaç duyduğu kapsamları ve projeleri verin: Tüm projelerim içinde Her şey yapabilen bir anahtar, Claude’un sizin IronFlock’ta yapabileceğiniz her şeyi yapmasına izin verir. Bir şeyi değiştiren veya silen araçlar bu şekilde işaretlenir; böylece Claude gibi istemciler önce size sorabilir. Onay vermeden önce Claude’un neyi değiştirmek üzere olduğunu okuyun.
- Bir kuruluşun paylaştığı bir bağlayıcı, tüm kullanıcıları için tek bir anahtarla işlem yapar. Yalnızca hepsinin görebileceği şeyleri görebilen bir hesabın anahtarını kullanın.