Skip to Content

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 IronFlockhttps://api.ironflock.com/mcp
URL sur une appliancehttps://api. suivi du domaine de l’appliance, puis /mcp, dès que l’appliance exécute le service API IronFlock
TransportStreamable HTTP
AuthentificationAuthorization: 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.

  1. Ajoutez la marketplace et installez le plugin dans une session Claude Code :

    /plugin marketplace add IronFlock/agent-skills /plugin install ironflock@ironflock
  2. L’installation ouvre une boîte de dialogue avec deux paramètres. IronFlock API address vaut https://api.ironflock.com pour le cloud, et https://api. suivi du domaine de l’appliance pour une appliance, dans les deux cas sans /mcp et 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.

  3. Redémarrez Claude Code. /mcp liste alors le serveur plugin:ironflock:ironflock comme 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.

  1. Ouvrez Customize > Connectors, choisissez Add, puis Add custom connector.
  2. Saisissez le nom IronFlock et l’URL du serveur https://api.ironflock.com/mcp.
  3. Réglez Authentication sur No sign-in.
  4. Sous Request headers, ajoutez l’en-tête Authorization avec la valeur Bearer suivie de votre clé : le mot Bearer, une espace, puis la clé. Sans Bearer , IronFlock refuse la requête.
  5. 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

OutilAutorisationCe qu’il fait
list_projectsdevices:readListe les projets dans lesquels la clé peut travailler

Appareils

OutilAutorisationCe qu’il fait
list_devicesdevices:readListe les appareils d’un projet, les applications installées sur chacun, si elles s’exécutent et si l’appareil est en ligne
create_devicedevices:writeCrée un appareil dans le projet et répond avec sa clé et son nom
delete_devicedevices:writeSupprime définitivement un appareil du projet

Applications d’un projet

OutilAutorisationCe qu’il fait
list_project_appsapps:readListe les applications installées dans le projet et sur combien d’appareils chacune s’exécute
check_app_statusapps:readIndique si une application s’exécute sur ses appareils et si ses données arrivent
install_appapps:writeInstalle une application du store dans le projet, et éventuellement sur des appareils
set_app_stateapps:writeDémarre ou arrête une application installée sur des appareils
update_appapps:writeMet à jour une application installée vers sa version la plus récente
uninstall_appapps:writeRetire une application d’appareils, ou du projet entier

App Store et coûts

OutilAutorisationCe qu’il fait
search_appsapps:readRecherche dans l’App Store par fonctionnalité et renvoie les applications correspondantes avec leurs prix
get_app_detailsapps:readLit la description, le README et le prix d’une à trois applications du store
get_install_quoteapps:readDétermine ce que coûterait l’installation d’une application et ce qui l’empêcherait
estimate_project_costapps:readEstime le coût annuel d’une configuration de projet ; rien n’est acheté
sync_app_to_storeapps:writeSur une appliance uniquement : copie une application du store du cloud IronFlock dans le store propre à l’appliance

Données

OutilAutorisationCe qu’il fait
get_schemadata:readDécrit la base de données du projet : ses tables, ses vues et ses colonnes
execute_sqldata:readExécute une requête SELECT en lecture seule sur la base de données du projet
list_dashboardsdata:readListe les dashboards du projet
list_app_filesdata:readListe et recherche les fichiers qu’une application stocke dans le projet
read_app_filedata:readLit un fichier stocké par une application : du texte, une image ou un autre fichier
save_transformdata:writeCrée ou remplace une transformation personnalisée qui maintient à jour un indicateur dérivé pour les boards
delete_transformdata:writeSupprime définitivement une transformation personnalisée

Alarmes

OutilAutorisationCe qu’il fait
list_alarmsalarms:readListe les alarmes du projet avec leur état, leurs déclencheurs et leurs destinataires
create_alarmalarms:writeCrée une alarme qui surveille une table de données d’une application
update_alarmalarms:writeModifie le déclencheur ou les destinataires d’une alarme, ou la met en pause et la reprend
delete_alarmalarms:writeSupprime définitivement une alarme et son historique

Journaux et journal d’audit

OutilAutorisationCe qu’il fait
get_app_logslogs:readLit la sortie de journal propre à une application sur les appareils où elle s’exécute
get_device_logslogs:readLit ce qu’un appareil a fait lui-même : applications, téléchargements, disque, réseau, mises à jour de l’agent
query_audit_loglogs:readExé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_healthdevices:readSur 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_logslogs:readSur 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.

OutilAutorisationCe qu’il fait
list_app_toolsapptools:callListe les outils d’une application installée, avec leurs arguments et les instructions des agents de l’application
call_app_toolapptools:callExé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_app prend la réponse de get_install_quote qui 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_state et update_app modifient au plus 10 appareils par appel.
  • create_device ré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 avec ironflock 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_transform pendant que le premier s’exécute est refusé.
  • Un compte peut exécuter query_audit_log une 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êtes120 par minute, par rafales de 30 au plus
Requêtes ouvertes en même temps8
Corps de la requête1 114 112 octets : 1 Mio d’arguments et le message qui les entoure
Un appel d’outil90 secondes
Une requête en base de données30 secondes ; execute_sql renvoie 100 lignes sauf si vous en demandez plus, 1 000 au maximum
Un résultat50 000 caractères ; le résultat de call_app_tool est coupé à 45 000

Erreurs

RéponseSignificationQue faire
401La clé est absente, mal saisie ou tronquée, supprimée, expirée, ou d’un autre IronFlock. Dans un connecteur, Bearer manque peut-êtreCré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 IronFlockCorrigez l’adresse ; sinon, utilisez le cloud
405GET et DELETE sur /mcp : le serveur n’a ni flux d’événements ni session à terminerUtilisez POST
413Le corps de la requête est trop volumineuxEnvoyez moins de données en un appel
429La 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 attendreAttendez ce temps, puis continuez avec moins d’appels simultanés
503La plateforme n’est pas disponible pour le moment, ou le service est en cours d’arrêtRéessayez dans une minute
504La plateforme n’a pas répondu à tempsRé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.
Last updated on