Skip to Content

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 URLhttps://api.ironflock.com/mcp
Bir Appliance’ta URLhttps://api. ardından Appliance’ın alan adı, sonra /mcp; Appliance IronFlock API hizmetini çalıştırdığı andan itibaren
TaşımaStreamable HTTP
Kimlik doğrulamaAuthorization: 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.

  1. Bir Claude Code oturumunda pazar yerini ekleyin ve eklentiyi kurun:

    /plugin marketplace add IronFlock/agent-skills /plugin install ironflock@ironflock
  2. 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 ise https://api. ardından Appliance’ın alan adıdır; her iki durumda da /mcp olmadan 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.

  3. Claude Code’u yeniden başlatın. Ardından /mcp, plugin:ironflock:ironflock sunucusunu 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.

  1. Customize > Connectors’ı açın, Add’i, ardından Add custom connector’ı seçin.
  2. IronFlock adını ve https://api.ironflock.com/mcp sunucu URL’sini girin.
  3. Authentication değerini No sign-in olarak ayarlayın.
  4. Request headers altında, değeri Bearer ve ardından anahtarınız olan Authorization başlığını ekleyin: Bearer kelimesi, bir boşluk, ardından anahtar. Bearer olmadan IronFlock isteği reddeder.
  5. 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çKapsamNe yapar
list_projectsdevices:readAnahtarın çalışabildiği projeleri listeler

Cihazlar

AraçKapsamNe yapar
list_devicesdevices:readBir projenin cihazlarını, her birinde kurulu uygulamaları, bunların çalışıp çalışmadığını ve cihazın çevrimiçi olup olmadığını listeler
create_devicedevices:writeProjede bir cihaz oluşturur ve cihazın anahtarını ve adını yanıt olarak verir
delete_devicedevices:writeBir cihazı projeden kalıcı olarak siler

Bir Projedeki Uygulamalar

AraçKapsamNe yapar
list_project_appsapps:readProjede kurulu uygulamaları ve her birinin kaç cihazda çalıştığını listeler
check_app_statusapps:readBir uygulamanın cihazlarında çalışıp çalışmadığını ve verilerinin gelip gelmediğini gösterir
install_appapps:writeBir mağaza uygulamasını projeye ve isteğe bağlı olarak cihazlara kurar
set_app_stateapps:writeKurulu bir uygulamayı cihazlarda başlatır veya durdurur
update_appapps:writeKurulu bir uygulamayı en yeni sürümüne günceller
uninstall_appapps:writeBir uygulamayı cihazlardan veya projenin tamamından kaldırır

Uygulama Mağazası ve Maliyetler

AraçKapsamNe yapar
search_appsapps:readUygulama mağazasında yeteneğe göre arama yapar ve eşleşen uygulamaları fiyatlarıyla döndürür
get_app_detailsapps:readBir ila üç mağaza uygulamasının açıklamasını, README dosyasını ve fiyatını okur
get_install_quoteapps:readBir uygulamayı kurmanın ne kadara mal olacağını ve kurulumu neyin engelleyeceğini bulur
estimate_project_costapps:readBir proje kurulumunun yıllık maliyetini tahmin eder; hiçbir şey satın alınmaz
sync_app_to_storeapps:writeYalnızca bir Appliance’ta: IronFlock bulut mağazasındaki bir uygulamayı Appliance’ın kendi mağazasına kopyalar

Veriler

AraçKapsamNe yapar
get_schemadata:readProjenin veritabanını açıklar: tablolarını, görünümlerini ve sütunlarını
execute_sqldata:readProjenin veritabanında salt okunur tek bir SELECT sorgusu çalıştırır
list_dashboardsdata:readProjenin panolarını listeler
list_app_filesdata:readBir uygulamanın projede sakladığı dosyaları listeler ve bunlarda arama yapar
read_app_filedata:readBir uygulamanın sakladığı tek bir dosyayı okur: metin, görüntü veya başka bir dosya
save_transformdata:writePanolar için türetilmiş bir değeri canlı tutan özel bir dönüşüm oluşturur veya değiştirir
delete_transformdata:writeÖzel bir dönüşümü kalıcı olarak siler

Alarmlar

AraçKapsamNe yapar
list_alarmsalarms:readProjenin alarmlarını durumları, tetikleyicileri ve alıcılarıyla listeler
create_alarmalarms:writeBir uygulamanın veri tablosunu izleyen bir alarm oluşturur
update_alarmalarms:writeBir alarmın tetikleyicisini veya alıcılarını değiştirir ya da alarmı duraklatır ve sürdürür
delete_alarmalarms:writeBir alarmı geçmişiyle birlikte kalıcı olarak siler

Günlükler ve Denetim Günlüğü

AraçKapsamNe yapar
get_app_logslogs:readBir uygulamanın kendi günlük çıktısını çalıştığı cihazlardan okur
get_device_logslogs:readBir cihazın kendisinin ne yaptığını okur: uygulamalar, indirmeler, disk, ağ, ajan güncellemeleri
query_audit_loglogs:readDenetim 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_healthdevices:readYalnızca bir Appliance’ta: Appliance’ın kendi platform hizmetlerinin, diskinin, belleğinin, lisansının ve güncellemelerinin durumunu kontrol eder
get_appliance_logslogs:readYalnı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çKapsamNe yapar
list_app_toolsapptools:callKurulu bir uygulamanın araçlarını, bağımsız değişkenleri ve uygulamanın ajanlarının talimatlarıyla birlikte listeler
call_app_toolapptools:callBunlardan 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österilen get_install_quote yanı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_state ve update_app tek bir çağrıda en fazla 10 cihazı değiştirir.
  • create_device yeni 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 tutan ironflock 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_transform reddedilir.
  • Bir hesap query_audit_log aracı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
İsteklerDakikada 120, en fazla 30’luk ani artışlarla
Aynı anda açık istekler8
İstek gövdesi1.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ı sorgusu30 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ıtAnlamıNe yapmalı
401Anahtar 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 olabilirBağlandığınız IronFlock’un Studio’sunda yeni bir anahtar oluşturun ve yeniden girin
/mcp adresinde 404Adreste /mcp iki kez geçiyor ya da IronFlock örneği uç noktayı henüz sunmuyor, örneğin IronFlock API hizmetini çalıştırmayan bir ApplianceAdresi düzeltin; aksi halde bulutu kullanın
405/mcp üzerinde GET ve DELETE: sunucunun olay akışı ve sonlandırılacak oturumu yokturPOST kullanın
413İstek gövdesi çok büyükTek bir çağrıda daha az gönderin
429Anahtar çok fazla istek yaptı veya aynı anda çok fazla açık isteği var. Retry-After başlığı kaç saniye bekleneceğini söylerO kadar bekleyin, ardından aynı anda daha az çağrıyla devam edin
503Platform şu anda kullanılamıyor ya da hizmet kapanıyorBir dakika içinde yeniden deneyin
504Platform zamanında yanıt vermediBir 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.
Last updated on