Skip to Content

MCP-Endpunkt

IronFlock ist ein MCP-Server. Claude und jeder andere Client, der das Model Context Protocol spricht, kann Ihre Projekte auflisten, ihre Geräte, Apps und Daten lesen und mit den Tools, die IronFlock anbietet, auf sie einwirken, im Rahmen dessen, was Ihr API-Key erlaubt. Der Endpunkt ist Teil desselben API-Service wie die REST-API und verwendet dieselben API-Keys.

Adresse und Authentifizierung

URL in der IronFlock-Cloudhttps://api.ironflock.com/mcp
URL auf einer Appliancehttps://api. gefolgt von der Domain der Appliance, dann /mcp, sobald die Appliance den IronFlock-API-Service ausführt
TransportStreamable HTTP
AuthentifizierungAuthorization: Bearer <your API key>

Erstellen Sie den API-Key in Studio, wie unter API-Key erstellen beschrieben. Jede Anfrage trägt den Key. Eine Anfrage ohne Key oder mit einem ungültigen Key (gelöscht, abgelaufen oder von einem anderen IronFlock) wird mit HTTP 401 beantwortet. Der Server bietet keine Anmeldung über einen Browser (OAuth) an: Der Key ist der einzige Zugang.

Der Server hält keine Sitzungen. Jede Anfrage wird für sich beantwortet, sodass ein Client sich frei verbinden, trennen und neu verbinden kann. Er beantwortet jede Anfrage mit einem JSON-Körper und hat keinen Event-Stream, dem man zuhören könnte.

Claude verbinden

Sie geben den Key selbst ein, in den eigenen Einstellungen von Claude. Fügen Sie ihn nie in einen Chat ein.

Claude Code

Claude Code verbindet sich über das Plugin ironflock, das den MCP-Server von IronFlock deklariert. Es funktioniert im Terminal, in den IDE-Erweiterungen und im Code-Tab der Claude-Desktop-App.

  1. Fügen Sie in einer Claude-Code-Sitzung den Marketplace hinzu und installieren Sie das Plugin:

    /plugin marketplace add IronFlock/agent-skills /plugin install ironflock@ironflock
  2. Die Installation öffnet einen Dialog mit zwei Einstellungen. IronFlock API address ist https://api.ironflock.com für die Cloud und https://api. gefolgt von der Domain der Appliance für eine Appliance, in beiden Fällen ohne /mcp und ohne Schrägstrich am Ende. IronFlock API key ist der Key aus Studio. Claude Code bewahrt ihn im sicheren Anmeldedatenspeicher des Systems auf, nicht in einer Einstellungsdatei.

  3. Starten Sie Claude Code neu. /mcp listet dann den Server plugin:ironflock:ironflock als verbunden auf.

Ändern Sie die Einstellungen später mit /plugin configure ironflock@ironflock und starten Sie Claude Code neu. Solange der Key nicht gesetzt ist, startet der Server nicht. Eine Installation aus einer Shell (claude plugin install) öffnet den Dialog nicht; schließen Sie sie daher mit /plugin configure ironflock@ironflock in einer Sitzung ab. Mit Claude Code entwickeln beschreibt die Plugins und ihre Skills.

Claude im Web, auf dem Desktop und auf dem Smartphone sowie Cowork

Die eigene Verbindung des Plugins funktioniert nur in Claude Code. Im Chat der Claude-App und in Cowork fügen Sie IronFlock einmal als benutzerdefinierten Connector hinzu, mit dem Key als Request-Header. Request-Header bei benutzerdefinierten Connectors sind eine Beta, die einem begrenzten Kreis von Organisationen zur Verfügung steht. Hat der Dialog unten keinen Bereich Request headers, hat Ihre Organisation sie noch nicht, und IronFlock kann dort vorerst nicht verbunden werden: Claude Code funktioniert.

  1. Öffnen Sie Customize > Connectors, wählen Sie Add, dann Add custom connector.
  2. Geben Sie den Namen IronFlock und die Server-URL https://api.ironflock.com/mcp ein.
  3. Setzen Sie Authentication auf No sign-in.
  4. Fügen Sie unter Request headers den Header Authorization mit dem Wert Bearer gefolgt von Ihrem Key hinzu: das Wort Bearer, ein Leerzeichen, dann der Key. Ohne Bearer lehnt IronFlock die Anfrage ab.
  5. Wählen Sie Add.

In Team- und Enterprise-Plänen fügt ein Owner den Connector unter Organization settings > Connectors, Add, dann Custom hinzu; die Request-Header können unter Advanced liegen. Alle, die diesen Connector verwenden, handeln mit dem einen Key, den der Owner eingegeben hat; geben Sie ihm daher nur die Berechtigungen und Projekte, die alle von ihnen verwenden dürfen.

Die Request-Header eines Connectors lassen sich nicht bearbeiten: Um den Key zu ändern, entfernen Sie den Connector und fügen ihn erneut hinzu. Der Connector verbindet sich von den Servern von Anthropic aus, daher muss die Adresse aus dem Internet erreichbar sein. Für die Cloud ist das der Fall. Eine Appliance, die nur Ihr Firmennetz erreicht, kann dort meist nicht verbunden werden, Claude Code auf einem Computer in diesem Netz dagegen schon.

Andere MCP-Clients

Jeder Client, der Streamable HTTP und einen Request-Header unterstützt, verbindet sich mit der URL und dem Header Authorization: Bearer <your API key>. Halten Sie den Key aus Dateien heraus, die Sie teilen oder committen.

Die Verbindung prüfen

Bitten Sie Claude, Ihre IronFlock-Projekte aufzulisten, dann die Geräte eines davon. Claude ruft list_projects und list_devices auf, die nur lesen.

Tools

Der Server bietet 33 Tools in diesen Bereichen. Die meisten arbeiten in einem Projekt und nehmen dessen swarm_key, den list_projects liefert. Ein Tool, das etwas ändert oder löscht, ist als solches gekennzeichnet, damit Clients wie Claude Sie fragen können, bevor sie es aufrufen.

Projekte

ToolBerechtigungWas es tut
list_projectsdevices:readListet die Projekte auf, in denen der Key arbeiten kann

Geräte

ToolBerechtigungWas es tut
list_devicesdevices:readListet die Geräte eines Projekts auf, die auf jedem installierten Apps, ob sie laufen und ob das Gerät online ist
create_devicedevices:writeErstellt ein Gerät im Projekt und antwortet mit seinem Key und Namen
delete_devicedevices:writeLöscht ein Gerät endgültig aus dem Projekt

Apps in einem Projekt

ToolBerechtigungWas es tut
list_project_appsapps:readListet die im Projekt installierten Apps auf und auf wie vielen Geräten jede läuft
check_app_statusapps:readZeigt, ob eine App auf ihren Geräten läuft und ob ihre Daten ankommen
install_appapps:writeInstalliert eine Store-App in das Projekt und optional auf Geräte
set_app_stateapps:writeStartet oder stoppt eine installierte App auf Geräten
update_appapps:writeAktualisiert eine installierte App auf ihr neuestes Release
uninstall_appapps:writeEntfernt eine App von Geräten oder aus dem ganzen Projekt

App Store und Kosten

ToolBerechtigungWas es tut
search_appsapps:readDurchsucht den App Store nach Fähigkeiten und gibt passende Apps mit ihren Preisen zurück
get_app_detailsapps:readLiest die Beschreibung, die README und den Preis von einer bis drei Store-Apps
get_install_quoteapps:readErmittelt, was die Installation einer App kosten würde und was sie verhindern würde
estimate_project_costapps:readSchätzt die jährlichen Kosten eines Projekt-Setups; es wird nichts gekauft
sync_app_to_storeapps:writeNur auf einer Appliance: kopiert eine App aus dem Store der IronFlock-Cloud in den eigenen Store der Appliance

Daten

ToolBerechtigungWas es tut
get_schemadata:readBeschreibt die Datenbank des Projekts: ihre Tabellen, Views und Spalten
execute_sqldata:readFührt eine schreibgeschützte SELECT-Abfrage auf der Datenbank des Projekts aus
list_dashboardsdata:readListet die Dashboards des Projekts auf
list_app_filesdata:readListet und durchsucht die Dateien, die eine App im Projekt speichert
read_app_filedata:readLiest eine Datei, die eine App speichert: Text, ein Bild oder eine andere Datei
save_transformdata:writeErstellt oder ersetzt eine eigene Transformation, die eine abgeleitete Kennzahl für Boards aktuell hält
delete_transformdata:writeLöscht eine eigene Transformation endgültig

Alarme

ToolBerechtigungWas es tut
list_alarmsalarms:readListet die Alarme des Projekts mit ihrem Zustand, ihren Auslösern und Empfängern auf
create_alarmalarms:writeErstellt einen Alarm, der eine Datentabelle einer App überwacht
update_alarmalarms:writeÄndert den Auslöser oder die Empfänger eines Alarms oder pausiert ihn und setzt ihn fort
delete_alarmalarms:writeLöscht einen Alarm und seinen Verlauf endgültig

Logs und Audit-Log

ToolBerechtigungWas es tut
get_app_logslogs:readLiest die eigene Log-Ausgabe einer App von den Geräten, auf denen sie läuft
get_device_logslogs:readLiest, was ein Gerät selbst getan hat: Apps, Downloads, Festplatte, Netzwerk, Agent-Updates
query_audit_loglogs:readFührt eine schreibgeschützte Abfrage auf dem Audit-Log aus: wer das Projekt, seine Geräte, Gruppen und Apps geändert hat, und wann
get_appliance_healthdevices:readNur auf einer Appliance: prüft den Zustand der eigenen Plattformdienste der Appliance, der Festplatte, des Speichers, der Lizenz und der Updates
get_appliance_logslogs:readNur auf einer Appliance: liest das Log eines Teils der Plattform der Appliance

App-Tools

Apps bringen mit ihren KI-Agenten eigene Tools mit: Funktionen der App, die auf einem Gerät laufen, etwa den Zustand einer Maschine lesen oder eine Einstellung ändern. Zwei Tools erreichen sie.

ToolBerechtigungWas es tut
list_app_toolsapptools:callListet die Tools einer installierten App mit ihren Argumenten und den Anweisungen der Agenten der App auf
call_app_toolapptools:callFührt eines davon auf einem Gerät des Projekts aus

call_app_tool läuft auf einem Gerät, und ein Tool einer App kann dort etwas ändern. Das Gerät muss eines der Geräte des Projekts sein, die der Eigentümer des Keys sehen kann, und der Eigentümer braucht das Recht, die Daten der App zu verwenden, wie bei der Bedienung der App über ihr Board. Die App erhält genau die angegebenen Argumente und sonst nichts. Nur die Tools des installierten Releases werden aufgelistet, nicht die der Entwicklungsversion einer App. Die Texte eines Tools schreibt der Entwickler der App, und sie werden auf eine feste Länge gekürzt.

Berechtigungen

Jedes Tool braucht die eine Berechtigung, die in den Tabellen oben steht. Der Server bietet einem Client nur die Tools an, die der Key verwenden darf, und lehnt jedes andere Tool ab, als gäbe es es nicht. Was der Key auch erlaubt: Ein Tool tut nie mehr, als der Eigentümer des Keys in IronFlock tun darf. releases:publish hat kein Tool: Es ist für die REST-Operationen, die Releases bauen. Siehe Berechtigungen für alle, und API-Key erstellen dafür, wie Sie sie in Studio auswählen.

Ein auf Projekte beschränkter Key sieht nur diese Projekte. Einem auf eine App beschränkten Key werden nur die Tools angeboten, die für eine App handeln, also nicht list_projects. Keinem von beiden werden die Tools angeboten, die über ein Projekt hinausreichen: query_audit_log, dessen Abfrage Objekte jedes Projekts nennen kann, das der Eigentümer lesen darf, die beiden Appliance-Tools, die zu keinem Projekt gehören, und sync_app_to_store, das den Store der Appliance für alle ändert.

Für einige Tools gelten zusätzliche Regeln:

  • install_app nimmt die Antwort von get_install_quote, die Ihnen gezeigt wurde, und installiert nichts, wenn sich der Preis oder sonst etwas an diesem Angebot seither geändert hat. Die Installation einer kostenpflichtigen App kostet Geld.
  • set_app_state und update_app ändern höchstens 10 Geräte pro Aufruf.
  • create_device antwortet mit dem Key und dem Namen des neuen Geräts und nie mit seiner Konfigurationsdatei, die die Zugangsdaten des Geräts enthält. Laden Sie die Datei in Studio herunter, in den Einstellungen des Geräts unter Gerätewartung > Gerätekonfigurationsdatei > Gerätedatei herunterladen, oder richten Sie das Gerät auf der Maschine mit ironflock agent install --project <project> --name <name> ein, das das Gerät erstellt und die Datei auf der Maschine behält (Anmelden & Geräte verwalten).
  • Ein Projekt speichert jeweils eine eigene Transformation. Ein zweites save_transform, während das erste läuft, wird abgelehnt.
  • Ein Konto darf query_audit_log jeweils einmal gleichzeitig und sechsmal pro Minute ausführen, weil die Datenbank dahinter geteilt ist.
  • Eine Änderung, die nicht innerhalb der Zeit ihres Aufrufs fertig wird, kann trotzdem vorgenommen werden. Das Ergebnis sagt das, und das Tool wiederholt sie nicht.

Ergebnisse

Ein Ergebnis ist JSON, als strukturierter Inhalt und als dasselbe JSON in einem Textblock. Eine lange Liste wird auf 50.000 Zeichen gekürzt, und ihr Element cut sagt, wie viele Einträge ausgelassen wurden und wie man weiterliest. Bilder (PNG, JPEG, GIF und WebP) kommen als Bilder, andere Dateien, etwa ein PDF, als eingebettete Ressourcen mit ihrem Medientyp.

Wenn ein Tool nicht tun kann, worum es gebeten wurde, ist sein Ergebnis als Fehler gekennzeichnet und sagt in einem Satz, warum, zum Beispiel dass ein Projekt nicht existiert oder dass die Plattform nicht rechtzeitig geantwortet hat.

Limits

Das sind die Standardwerte, pro API-Key:

Limit
Anfragen120 pro Minute, in Schüben von bis zu 30
Gleichzeitig offene Anfragen8
Anfragekörper1.114.112 Bytes: 1 MiB an Argumenten und die Nachricht darum
Ein Tool-Aufruf90 Sekunden
Eine Datenbankabfrage30 Sekunden; execute_sql antwortet mit 100 Zeilen, außer Sie fordern mehr an, höchstens 1.000
Ein Ergebnis50.000 Zeichen; das Ergebnis von call_app_tool wird bei 45.000 gekürzt

Fehler

AntwortBedeutungWas zu tun ist
401Der Key fehlt, ist vertippt oder abgeschnitten, gelöscht, abgelaufen oder von einem anderen IronFlock. In einem Connector fehlt möglicherweise Bearer Erstellen Sie einen neuen Key im Studio des IronFlock, mit dem Sie sich verbinden, und geben Sie ihn erneut ein
404 an /mcp/mcp steht zweimal in der Adresse, oder die Instanz bietet den Endpunkt noch nicht an, etwa eine Appliance, die den IronFlock-API-Service nicht ausführtKorrigieren Sie die Adresse; sonst verwenden Sie die Cloud
405GET und DELETE auf /mcp: Der Server hat keinen Event-Stream und keine Sitzung, die man beenden könnteVerwenden Sie POST
413Der Anfragekörper ist zu großSenden Sie weniger in einem Aufruf
429Der Key hat zu viele Anfragen gestellt oder hat zu viele gleichzeitig offen. Der Header Retry-After sagt, wie viele Sekunden zu warten sindWarten Sie so lange und machen Sie dann mit weniger gleichzeitigen Aufrufen weiter
503Die Plattform ist im Moment nicht verfügbar, oder der Service fährt herunterVersuchen Sie es in einer Minute erneut
504Die Plattform hat nicht rechtzeitig geantwortetVersuchen Sie es in einer Minute erneut

Ein Tool, das nicht tun kann, worum es gebeten wurde, antwortet nicht mit einem HTTP-Fehler: Sein Ergebnis ist als Fehler gekennzeichnet und erklärt in einem Satz, was schiefgegangen ist.

Ihren Key schützen

  • Fügen Sie einen Key nie in einen Chat ein. Haben Sie es getan, ist er Teil dieses Gesprächs: Löschen Sie den Key in Studio, erstellen Sie einen neuen und geben Sie ihn in den Einstellungen ein.
  • Studio zeigt einen neuen Key nur einmal an, wenn Sie ihn erstellen. Speichern Sie ihn sofort in den Einstellungen des Clients.
  • Verwenden Sie einen Key für jeden Ort, der ihn verwendet, damit Sie einen löschen können, ohne die anderen zu unterbrechen, und löschen Sie Keys, die Sie nicht mehr verwenden. Ein Key gilt ein Jahr lang.
  • Geben Sie einem Key nur die Berechtigungen und Projekte, die Claude braucht: Ein Key, der Alles in Alle meine Projekte darf, lässt Claude alles tun, was Sie in IronFlock tun dürfen. Tools, die etwas ändern oder löschen, sind als solche gekennzeichnet, damit Clients wie Claude Sie zuerst fragen können. Lesen Sie, was Claude ändern will, bevor Sie zustimmen.
  • Ein von einer Organisation geteilter Connector handelt mit einem Key für alle ihre Benutzer. Verwenden Sie einen Key eines Kontos, das nur sehen darf, was alle von ihnen sehen dürfen.
Last updated on