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-Cloud | https://api.ironflock.com/mcp |
| URL auf einer Appliance | https://api. gefolgt von der Domain der Appliance, dann /mcp, sobald die Appliance den IronFlock-API-Service ausführt |
| Transport | Streamable HTTP |
| Authentifizierung | Authorization: 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.
-
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 -
Die Installation öffnet einen Dialog mit zwei Einstellungen. IronFlock API address ist
https://api.ironflock.comfür die Cloud undhttps://api.gefolgt von der Domain der Appliance für eine Appliance, in beiden Fällen ohne/mcpund 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. -
Starten Sie Claude Code neu.
/mcplistet dann den Serverplugin:ironflock:ironflockals 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.
- Öffnen Sie Customize > Connectors, wählen Sie Add, dann Add custom connector.
- Geben Sie den Namen
IronFlockund die Server-URLhttps://api.ironflock.com/mcpein. - Setzen Sie Authentication auf No sign-in.
- Fügen Sie unter Request headers den Header
Authorizationmit dem WertBearergefolgt von Ihrem Key hinzu: das Wort Bearer, ein Leerzeichen, dann der Key. OhneBearerlehnt IronFlock die Anfrage ab. - 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
| Tool | Berechtigung | Was es tut |
|---|---|---|
list_projects | devices:read | Listet die Projekte auf, in denen der Key arbeiten kann |
Geräte
| Tool | Berechtigung | Was es tut |
|---|---|---|
list_devices | devices:read | Listet die Geräte eines Projekts auf, die auf jedem installierten Apps, ob sie laufen und ob das Gerät online ist |
create_device | devices:write | Erstellt ein Gerät im Projekt und antwortet mit seinem Key und Namen |
delete_device | devices:write | Löscht ein Gerät endgültig aus dem Projekt |
Apps in einem Projekt
| Tool | Berechtigung | Was es tut |
|---|---|---|
list_project_apps | apps:read | Listet die im Projekt installierten Apps auf und auf wie vielen Geräten jede läuft |
check_app_status | apps:read | Zeigt, ob eine App auf ihren Geräten läuft und ob ihre Daten ankommen |
install_app | apps:write | Installiert eine Store-App in das Projekt und optional auf Geräte |
set_app_state | apps:write | Startet oder stoppt eine installierte App auf Geräten |
update_app | apps:write | Aktualisiert eine installierte App auf ihr neuestes Release |
uninstall_app | apps:write | Entfernt eine App von Geräten oder aus dem ganzen Projekt |
App Store und Kosten
| Tool | Berechtigung | Was es tut |
|---|---|---|
search_apps | apps:read | Durchsucht den App Store nach Fähigkeiten und gibt passende Apps mit ihren Preisen zurück |
get_app_details | apps:read | Liest die Beschreibung, die README und den Preis von einer bis drei Store-Apps |
get_install_quote | apps:read | Ermittelt, was die Installation einer App kosten würde und was sie verhindern würde |
estimate_project_cost | apps:read | Schätzt die jährlichen Kosten eines Projekt-Setups; es wird nichts gekauft |
sync_app_to_store | apps:write | Nur auf einer Appliance: kopiert eine App aus dem Store der IronFlock-Cloud in den eigenen Store der Appliance |
Daten
| Tool | Berechtigung | Was es tut |
|---|---|---|
get_schema | data:read | Beschreibt die Datenbank des Projekts: ihre Tabellen, Views und Spalten |
execute_sql | data:read | Führt eine schreibgeschützte SELECT-Abfrage auf der Datenbank des Projekts aus |
list_dashboards | data:read | Listet die Dashboards des Projekts auf |
list_app_files | data:read | Listet und durchsucht die Dateien, die eine App im Projekt speichert |
read_app_file | data:read | Liest eine Datei, die eine App speichert: Text, ein Bild oder eine andere Datei |
save_transform | data:write | Erstellt oder ersetzt eine eigene Transformation, die eine abgeleitete Kennzahl für Boards aktuell hält |
delete_transform | data:write | Löscht eine eigene Transformation endgültig |
Alarme
| Tool | Berechtigung | Was es tut |
|---|---|---|
list_alarms | alarms:read | Listet die Alarme des Projekts mit ihrem Zustand, ihren Auslösern und Empfängern auf |
create_alarm | alarms:write | Erstellt einen Alarm, der eine Datentabelle einer App überwacht |
update_alarm | alarms:write | Ändert den Auslöser oder die Empfänger eines Alarms oder pausiert ihn und setzt ihn fort |
delete_alarm | alarms:write | Löscht einen Alarm und seinen Verlauf endgültig |
Logs und Audit-Log
| Tool | Berechtigung | Was es tut |
|---|---|---|
get_app_logs | logs:read | Liest die eigene Log-Ausgabe einer App von den Geräten, auf denen sie läuft |
get_device_logs | logs:read | Liest, was ein Gerät selbst getan hat: Apps, Downloads, Festplatte, Netzwerk, Agent-Updates |
query_audit_log | logs:read | Fü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_health | devices:read | Nur auf einer Appliance: prüft den Zustand der eigenen Plattformdienste der Appliance, der Festplatte, des Speichers, der Lizenz und der Updates |
get_appliance_logs | logs:read | Nur 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.
| Tool | Berechtigung | Was es tut |
|---|---|---|
list_app_tools | apptools:call | Listet die Tools einer installierten App mit ihren Argumenten und den Anweisungen der Agenten der App auf |
call_app_tool | apptools:call | Fü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_appnimmt die Antwort vonget_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_stateundupdate_appändern höchstens 10 Geräte pro Aufruf.create_deviceantwortet 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 mitironflock 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_logjeweils 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 | |
|---|---|
| Anfragen | 120 pro Minute, in Schüben von bis zu 30 |
| Gleichzeitig offene Anfragen | 8 |
| Anfragekörper | 1.114.112 Bytes: 1 MiB an Argumenten und die Nachricht darum |
| Ein Tool-Aufruf | 90 Sekunden |
| Eine Datenbankabfrage | 30 Sekunden; execute_sql antwortet mit 100 Zeilen, außer Sie fordern mehr an, höchstens 1.000 |
| Ein Ergebnis | 50.000 Zeichen; das Ergebnis von call_app_tool wird bei 45.000 gekürzt |
Fehler
| Antwort | Bedeutung | Was zu tun ist |
|---|---|---|
401 | Der 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ührt | Korrigieren Sie die Adresse; sonst verwenden Sie die Cloud |
405 | GET und DELETE auf /mcp: Der Server hat keinen Event-Stream und keine Sitzung, die man beenden könnte | Verwenden Sie POST |
413 | Der Anfragekörper ist zu groß | Senden Sie weniger in einem Aufruf |
429 | Der Key hat zu viele Anfragen gestellt oder hat zu viele gleichzeitig offen. Der Header Retry-After sagt, wie viele Sekunden zu warten sind | Warten Sie so lange und machen Sie dann mit weniger gleichzeitigen Aufrufen weiter |
503 | Die Plattform ist im Moment nicht verfügbar, oder der Service fährt herunter | Versuchen Sie es in einer Minute erneut |
504 | Die Plattform hat nicht rechtzeitig geantwortet | Versuchen 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.