Endpoint MCP
IronFlock est un serveur MCP. Claude, et tout autre client qui parle le Model Context Protocol, peut lister vos projets, lire leurs appareils, leurs applications et leurs données, et agir sur eux avec les outils qu’offre IronFlock, dans les limites de ce que permet votre clé API. L’endpoint fait partie du même service API que l’API REST et utilise les mêmes clés API.
Adresse et authentification
| URL dans le cloud IronFlock | https://api.ironflock.com/mcp |
| URL sur une appliance | https://api. suivi du domaine de l’appliance, puis /mcp, dès que l’appliance exécute le service API IronFlock |
| Transport | Streamable HTTP |
| Authentification | Authorization: Bearer <your API key> |
Créez la clé API dans Studio comme décrit dans Créer une clé API. Chaque requête porte la clé. Une requête sans clé, ou avec une clé qui n’est pas valide (supprimée, expirée, ou d’un autre IronFlock), reçoit la réponse HTTP 401. Le serveur ne propose pas de connexion via un navigateur (OAuth) : la clé est le seul moyen d’accès.
Le serveur ne conserve aucune session. Chaque requête reçoit sa propre réponse, si bien qu’un client peut se connecter, se déconnecter et se reconnecter librement. Il répond à chaque requête par un seul corps JSON et n’a pas de flux d’événements à écouter.
Connecter Claude
Vous saisissez la clé vous-même, dans les paramètres de Claude. Ne la collez jamais dans une conversation.
Claude Code
Claude Code se connecte via le plugin ironflock, qui déclare le serveur MCP d’IronFlock. Cela fonctionne dans le terminal, dans les extensions pour IDE et dans l’onglet Code de l’application de bureau Claude.
-
Ajoutez la marketplace et installez le plugin dans une session Claude Code :
/plugin marketplace add IronFlock/agent-skills /plugin install ironflock@ironflock -
L’installation ouvre une boîte de dialogue avec deux paramètres. IronFlock API address vaut
https://api.ironflock.compour le cloud, ethttps://api.suivi du domaine de l’appliance pour une appliance, dans les deux cas sans/mcpet sans barre oblique finale. IronFlock API key est la clé de Studio. Claude Code la conserve dans le magasin sécurisé d’identifiants du système, et non dans un fichier de paramètres. -
Redémarrez Claude Code.
/mcpliste alors le serveurplugin:ironflock:ironflockcomme connecté.
Modifiez les paramètres plus tard avec /plugin configure ironflock@ironflock, puis redémarrez Claude Code. Tant que la clé n’est pas définie, le serveur ne démarre pas. Une installation depuis un shell (claude plugin install) n’ouvre pas la boîte de dialogue : terminez-la donc avec /plugin configure ironflock@ironflock dans une session. Développer avec Claude Code décrit les plugins et leurs skills.
Claude sur le web, sur ordinateur et sur téléphone, et Cowork
La connexion propre au plugin ne fonctionne que dans Claude Code. Dans la conversation de l’application Claude et dans Cowork, vous ajoutez IronFlock une fois comme connecteur personnalisé, avec la clé comme en-tête de requête. Les en-têtes de requête des connecteurs personnalisés sont une bêta disponible pour un nombre limité d’organisations. Si la boîte de dialogue ci-dessous n’a pas de section Request headers, votre organisation n’y a pas encore accès, et IronFlock ne peut pas y être connecté pour l’instant : Claude Code fonctionne.
- Ouvrez Customize > Connectors, choisissez Add, puis Add custom connector.
- Saisissez le nom
IronFlocket l’URL du serveurhttps://api.ironflock.com/mcp. - Réglez Authentication sur No sign-in.
- Sous Request headers, ajoutez l’en-tête
Authorizationavec la valeurBearersuivie de votre clé : le mot Bearer, une espace, puis la clé. SansBearer, IronFlock refuse la requête. - Choisissez Add.
Dans les offres Team et Enterprise, un owner ajoute le connecteur sous Organization settings > Connectors, Add, puis Custom ; les en-têtes de requête peuvent se trouver sous Advanced. Toutes les personnes qui utilisent ce connecteur agissent avec l’unique clé que l’owner a saisie : ne lui donnez donc que les autorisations et les projets que toutes peuvent utiliser.
Les en-têtes de requête d’un connecteur ne peuvent pas être modifiés : pour changer la clé, supprimez le connecteur et ajoutez-le à nouveau. Le connecteur se connecte depuis les serveurs d’Anthropic, l’adresse doit donc être joignable depuis Internet. C’est le cas pour le cloud. Une appliance que seul le réseau de votre entreprise atteint ne peut généralement pas y être connectée, alors que Claude Code sur un ordinateur de ce réseau le peut.
Autres clients MCP
Tout client qui prend en charge Streamable HTTP et un en-tête de requête se connecte avec l’URL et l’en-tête Authorization: Bearer <your API key>. Gardez la clé hors des fichiers que vous partagez ou commitez.
Vérifier la connexion
Demandez à Claude de lister vos projets IronFlock, puis les appareils de l’un d’eux. Claude appelle list_projects et list_devices, qui ne font que lire.
Outils
Le serveur propose 33 outils dans ces domaines. La plupart travaillent dans un projet et prennent son swarm_key, que fournit list_projects. Un outil qui modifie ou supprime quelque chose est marqué comme tel, afin que des clients comme Claude puissent vous demander avant de l’appeler.
Projets
| Outil | Autorisation | Ce qu’il fait |
|---|---|---|
list_projects | devices:read | Liste les projets dans lesquels la clé peut travailler |
Appareils
| Outil | Autorisation | Ce qu’il fait |
|---|---|---|
list_devices | devices:read | Liste les appareils d’un projet, les applications installées sur chacun, si elles s’exécutent et si l’appareil est en ligne |
create_device | devices:write | Crée un appareil dans le projet et répond avec sa clé et son nom |
delete_device | devices:write | Supprime définitivement un appareil du projet |
Applications d’un projet
| Outil | Autorisation | Ce qu’il fait |
|---|---|---|
list_project_apps | apps:read | Liste les applications installées dans le projet et sur combien d’appareils chacune s’exécute |
check_app_status | apps:read | Indique si une application s’exécute sur ses appareils et si ses données arrivent |
install_app | apps:write | Installe une application du store dans le projet, et éventuellement sur des appareils |
set_app_state | apps:write | Démarre ou arrête une application installée sur des appareils |
update_app | apps:write | Met à jour une application installée vers sa version la plus récente |
uninstall_app | apps:write | Retire une application d’appareils, ou du projet entier |
App Store et coûts
| Outil | Autorisation | Ce qu’il fait |
|---|---|---|
search_apps | apps:read | Recherche dans l’App Store par fonctionnalité et renvoie les applications correspondantes avec leurs prix |
get_app_details | apps:read | Lit la description, le README et le prix d’une à trois applications du store |
get_install_quote | apps:read | Détermine ce que coûterait l’installation d’une application et ce qui l’empêcherait |
estimate_project_cost | apps:read | Estime le coût annuel d’une configuration de projet ; rien n’est acheté |
sync_app_to_store | apps:write | Sur une appliance uniquement : copie une application du store du cloud IronFlock dans le store propre à l’appliance |
Données
| Outil | Autorisation | Ce qu’il fait |
|---|---|---|
get_schema | data:read | Décrit la base de données du projet : ses tables, ses vues et ses colonnes |
execute_sql | data:read | Exécute une requête SELECT en lecture seule sur la base de données du projet |
list_dashboards | data:read | Liste les dashboards du projet |
list_app_files | data:read | Liste et recherche les fichiers qu’une application stocke dans le projet |
read_app_file | data:read | Lit un fichier stocké par une application : du texte, une image ou un autre fichier |
save_transform | data:write | Crée ou remplace une transformation personnalisée qui maintient à jour un indicateur dérivé pour les boards |
delete_transform | data:write | Supprime définitivement une transformation personnalisée |
Alarmes
| Outil | Autorisation | Ce qu’il fait |
|---|---|---|
list_alarms | alarms:read | Liste les alarmes du projet avec leur état, leurs déclencheurs et leurs destinataires |
create_alarm | alarms:write | Crée une alarme qui surveille une table de données d’une application |
update_alarm | alarms:write | Modifie le déclencheur ou les destinataires d’une alarme, ou la met en pause et la reprend |
delete_alarm | alarms:write | Supprime définitivement une alarme et son historique |
Journaux et journal d’audit
| Outil | Autorisation | Ce qu’il fait |
|---|---|---|
get_app_logs | logs:read | Lit la sortie de journal propre à une application sur les appareils où elle s’exécute |
get_device_logs | logs:read | Lit ce qu’un appareil a fait lui-même : applications, téléchargements, disque, réseau, mises à jour de l’agent |
query_audit_log | logs:read | Exécute une requête en lecture seule sur le journal d’audit : qui a modifié le projet, ses appareils, ses groupes et ses applications, et quand |
get_appliance_health | devices:read | Sur une appliance uniquement : vérifie l’état des services de plateforme propres à l’appliance, du disque, de la mémoire, de la licence et des mises à jour |
get_appliance_logs | logs:read | Sur une appliance uniquement : lit le journal d’une partie de la plateforme de l’appliance |
Outils des applications
Les applications apportent leurs propres outils avec leurs agents IA : des fonctions de l’application qui s’exécutent sur un appareil, comme lire l’état d’une machine ou modifier un réglage. Deux outils permettent de les atteindre.
| Outil | Autorisation | Ce qu’il fait |
|---|---|---|
list_app_tools | apptools:call | Liste les outils d’une application installée, avec leurs arguments et les instructions des agents de l’application |
call_app_tool | apptools:call | Exécute l’un d’eux sur un appareil du projet |
call_app_tool s’exécute sur un appareil, et un outil d’application peut y modifier des choses. L’appareil doit être l’un des appareils du projet que le propriétaire de la clé peut voir, et le propriétaire a besoin du droit d’utiliser les données de l’application, comme pour piloter l’application depuis son board. L’application reçoit exactement les arguments donnés et rien d’autre. Seuls les outils de la version installée sont listés, pas ceux de la version de développement d’une application. Les textes d’un outil sont rédigés par le développeur de l’application et sont coupés à une longueur fixe.
Autorisations
Chaque outil a besoin de l’unique autorisation indiquée dans les tableaux ci-dessus. Le serveur ne propose à un client que les outils que la clé peut utiliser, et refuse tout autre outil comme s’il n’existait pas. Quoi que la clé autorise, un outil ne fait jamais plus que ce que le propriétaire de la clé peut faire dans IronFlock. releases:publish n’a pas d’outil : elle sert aux opérations REST qui construisent des versions. Voir Autorisations pour toutes les autorisations, et Créer une clé API pour savoir comment les choisir dans Studio.
Une clé restreinte à des projets ne voit que ces projets. Une clé restreinte à une application ne se voit proposer que les outils qui agissent pour une application, donc pas list_projects. Ni l’une ni l’autre ne se voit proposer les outils qui vont au-delà d’un projet : query_audit_log, dont la requête peut nommer des ressources de tout projet que le propriétaire peut lire, les deux outils d’appliance, qui n’appartiennent à aucun projet, et sync_app_to_store, qui modifie le store de l’appliance pour tout le monde.
Certains outils ont des règles supplémentaires :
install_appprend la réponse deget_install_quotequi vous a été montrée, et n’installe rien si le prix ou tout autre élément de ce devis a changé depuis. Installer une application payante coûte de l’argent.set_app_stateetupdate_appmodifient au plus 10 appareils par appel.create_devicerépond avec la clé et le nom du nouvel appareil, et jamais avec son fichier de configuration, qui contient les identifiants de l’appareil. Téléchargez le fichier dans Studio, dans les paramètres de l’appareil sous Maintenance de l’appareil > Fichier de configuration de l’appareil > Télécharger le fichier de configuration, ou configurez l’appareil sur la machine avecironflock agent install --project <project> --name <name>, qui crée l’appareil et conserve le fichier sur la machine (Connexion et gestion des appareils).- Un projet enregistre une transformation personnalisée à la fois. Un second
save_transformpendant que le premier s’exécute est refusé. - Un compte peut exécuter
query_audit_logune fois à la fois et six fois par minute, car la base de données sous-jacente est partagée. - Une modification qui ne se termine pas dans le temps imparti à son appel peut tout de même être effectuée. Le résultat le dit, et l’outil ne la répète pas.
Résultats
Un résultat est du JSON, sous forme de contenu structuré et du même JSON dans un bloc de texte. Une longue liste est coupée pour tenir en 50 000 caractères, et son membre cut indique combien d’entrées ont été omises et comment poursuivre la lecture. Les images (PNG, JPEG, GIF et WebP) arrivent sous forme d’images, et les autres fichiers, comme un PDF, sous forme de ressources intégrées avec leur type de média.
Lorsqu’un outil ne peut pas faire ce qui a été demandé, son résultat est marqué comme erreur et dit pourquoi en une phrase, par exemple qu’un projet n’existe pas ou que la plateforme n’a pas répondu à temps.
Limites
Voici les valeurs par défaut, par clé API :
| Limite | |
|---|---|
| Requêtes | 120 par minute, par rafales de 30 au plus |
| Requêtes ouvertes en même temps | 8 |
| Corps de la requête | 1 114 112 octets : 1 Mio d’arguments et le message qui les entoure |
| Un appel d’outil | 90 secondes |
| Une requête en base de données | 30 secondes ; execute_sql renvoie 100 lignes sauf si vous en demandez plus, 1 000 au maximum |
| Un résultat | 50 000 caractères ; le résultat de call_app_tool est coupé à 45 000 |
Erreurs
| Réponse | Signification | Que faire |
|---|---|---|
401 | La clé est absente, mal saisie ou tronquée, supprimée, expirée, ou d’un autre IronFlock. Dans un connecteur, Bearer manque peut-être | Créez une nouvelle clé dans le Studio de l’IronFlock auquel vous vous connectez et saisissez-la à nouveau |
404 sur /mcp | /mcp apparaît deux fois dans l’adresse, ou l’instance ne propose pas encore l’endpoint, comme une appliance qui n’exécute pas le service API IronFlock | Corrigez l’adresse ; sinon, utilisez le cloud |
405 | GET et DELETE sur /mcp : le serveur n’a ni flux d’événements ni session à terminer | Utilisez POST |
413 | Le corps de la requête est trop volumineux | Envoyez moins de données en un appel |
429 | La clé a fait trop de requêtes, ou en a trop d’ouvertes à la fois. L’en-tête Retry-After indique combien de secondes attendre | Attendez ce temps, puis continuez avec moins d’appels simultanés |
503 | La plateforme n’est pas disponible pour le moment, ou le service est en cours d’arrêt | Réessayez dans une minute |
504 | La plateforme n’a pas répondu à temps | Réessayez dans une minute |
Un outil qui ne peut pas faire ce qui a été demandé ne répond pas par une erreur HTTP : son résultat est marqué comme erreur et explique en une phrase ce qui n’a pas fonctionné.
Protéger votre clé
- Ne collez jamais une clé dans une conversation. Si vous l’avez fait, elle fait partie de cette conversation : supprimez la clé dans Studio, créez-en une nouvelle et saisissez-la dans les paramètres.
- Studio n’affiche une nouvelle clé qu’une seule fois, lorsque vous la créez. Enregistrez-la tout de suite dans les paramètres du client.
- Utilisez une clé pour chaque endroit qui l’utilise, afin de pouvoir en supprimer une sans casser les autres, et supprimez les clés que vous n’utilisez plus. Une clé est valable un an.
- Ne donnez à une clé que les autorisations et les projets dont Claude a besoin : une clé qui peut tout faire (Tout) dans Tous mes projets permet à Claude de faire tout ce que vous pouvez faire dans IronFlock. Les outils qui modifient ou suppriment quelque chose sont marqués comme tels, afin que des clients comme Claude puissent d’abord vous demander. Lisez ce que Claude s’apprête à modifier avant de donner votre accord.
- Un connecteur partagé par une organisation agit avec une seule clé pour tous ses utilisateurs. Utilisez la clé d’un compte qui ne peut voir que ce que tous peuvent voir.