Référence du serveur MCP

Vue d'ensemble

Le serveur MCP Ironfang est un serveur Model Context Protocol distant. Un seul endpoint sert Ironfang Render, Ironfang Audit, Ironfang Finance et Ironfang Rig :

https://mcp.ironfang.uk/mcp

MCP n'est pas un produit distinct et n'a pas de prix distinct. C'est une autre façon sûre d'utiliser les produits que vous avez déjà : le rendu et les audits consomment les crédits habituels de l'organisation, les lectures sont gratuites et chaque connexion a son propre budget de dépenses (voir crédits et budgets).

Compatibilité des clients

Le serveur parle OAuth standard. Claude Code et claude.ai sont testés par nos soins ; les autres clients MCP se connectent grâce aux mêmes standards.

Claude Code

claude mcp add --transport http ironfang https://mcp.ironfang.uk/mcp

Ensuite, dans Claude Code, lancez /mcp, choisissez ironfang puis Authenticate. Un onglet de navigateur s'ouvre sur id.ironfang.uk : connectez-vous, choisissez l'organisation pour laquelle cette connexion agit, vérifiez les portées et autorisez. L'onglet se ferme et les outils apparaissent.

Claude Desktop et claude.ai

Settings → Connectors → Add custom connector (les libellés de l'interface en anglais), nommez le connecteur Ironfang et saisissez https://mcp.ironfang.uk/mcp. La même connexion suit.

Ne collez jamais une clé API dans une conversation. Le serveur MCP n'accepte pas les clés API Ironfang comme identifiants ; les clés restent avec l'API REST, là où elles ont leur place.

Authentification

Le serveur est une ressource protégée par OAuth 2.1. Une requête non authentifiée reçoit 401 avec un challenge WWW-Authenticate qui pointe vers le document de métadonnées de la ressource ; à partir de là, un client découvre le serveur d'autorisation et termine le flux par code avec PKCE (S256). Le déroulement, du point de vue du client :

1. Lire https://mcp.ironfang.uk/.well-known/oauth-protected-resource/mcp.
2. Lire https://id.ironfang.uk/.well-known/oauth-authorization-server.
3. S'identifier : par un Client ID Metadata Document (une URL HTTPS comme identifiant client, de préférence), ou en s'enregistrant comme client public sur /oauth/register.
4. Envoyer la personne vers /oauth/authorize avec resource=https://mcp.ironfang.uk/mcp, les portées voulues et un challenge PKCE.
5. La personne se connecte, choisit une organisation et donne son accord. Une connexion, c'est une personne, une organisation, un client.
6. Échanger le code sur /oauth/token. Le jeton d'accès est de courte durée et destiné uniquement à la ressource MCP ; un jeton d'actualisation tournant maintient la connexion sans redemander.

Portées

Les portées sont celles du produit. Une portée n'est accordée que si la personne détient l'autorisation correspondante dans l'organisation choisie, et elle est revérifiée en direct à chaque appel : perdre une autorisation met fin à l'accès dans la minute.

Un outil dont la portée n'a pas été accordée reste listé, pour qu'un client puisse la demander : l'appel répond 403 avec l'ensemble complet des portées dans le challenge, et le client relance le flux pour la portée supplémentaire.

Ce que le serveur fait du jeton

Rien ne quitte le serveur MCP avec votre jeton MCP. Pour appeler un produit, il demande à id.ironfang.uk un jeton distinct de deux minutes, destiné à ce produit, limité aux portées accordées et à l'organisation choisie, et marqué comme agissant en votre nom. Les produits refusent d'emblée un jeton MCP, et le serveur MCP refuse les jetons du portail ou des produits.

Révocation

Déconnectez un client depuis la page AI clients du portail ou depuis les paramètres de votre compte sur id.ironfang.uk. La révocation met fin à la famille de jetons d'actualisation et à la connexion ; un jeton d'accès encore valide cesse de fonctionner en moins de trente secondes, sans attendre son expiration.

Outils Ironfang Render

Les entrées des outils sont des objets JSON Schema stricts : les champs inconnus sont rejetés plutôt qu'ignorés, et chaque chaîne, taille et durée est bornée. Les outils de rendu acceptent une URL publique ou du HTML brut de taille bornée. Ils n'acceptent ni cookies, ni en-têtes d'autorisation, ni en-têtes de requête personnalisés, ni paramètres de proxy, ni scripts à exécuter, ni cibles sur un réseau privé.

Les descriptions et les coûts sont affichés ici en anglais, tels que le serveur les renvoie dans tools/list.

Les répétitions servies depuis le cache sont gratuites, exactement comme avec l'API REST, et le marquage des résultats de l'offre gratuite est le même quelle que soit la façon de générer. Chaque outil porte des indications (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) et des métadonnées avec espace de noms indiquant sa portée, son produit, son comportement en crédits et son risque, pour qu'un client puisse montrer à une personne ce qu'un appel va faire avant qu'il ne le fasse.

Tâches, tasks MCP et résultats

Chaque outil de création met en file une tâche durable Ironfang Render et répond immédiatement avec la même enveloppe, si bien qu'une nouvelle tentative ou une connexion perdue ne perd ni ne duplique jamais de travail :

{
              "request_id": "01a0...",
              "job_id": "01a0...",
              "status": "queued",
              "product": "render",
              "kind": "screenshot",
              "cached": false,
              "credits": { "reserved": 1, "charged": 0 },
              "result": null,
              "created_at": "2026-08-27T23:09:45Z",
              "connection_id": "01a0..."
            }

Interrogez render.job.get (ou lisez la ressource de la tâche). Une fois que status vaut succeeded, result contient le type de média, la taille en octets, le SHA-256, le moment où le résultat hébergé expire et un lien de téléchargement :

• Les résultats hébergés sont conservés 24 heures après leur réussite.
• Les liens de téléchargement sont signés et valables 15 minutes ; chaque lecture de la tâche ou de sa ressource de résultat en émet un nouveau.
• Les liens sont la règle, même pour les captures d'écran. Les PDF, les clips et les images pleine page ne sont jamais renvoyés en ligne ; une capture de moins de 2 MiB peut l'être, uniquement si un client le demande explicitement.
• Pour une conservation plus longue, téléchargez le résultat, ou désignez un webhook ou une destination de stockage dans le bloc delivery de l'outil de création (render.destination.list montre ce dont dispose le compte).

Un client qui prend en charge l'extension io.modelcontextprotocol/tasks demande une task en plaçant un objet task dans les paramètres de tools/call. Il reçoit alors un identifiant de task pour les captures, les PDF et les modèles, et doit en utiliser un pour les clips ; tasks/get reflète l'état de la tâche, tasks/result renvoie l'enveloppe et tasks/cancel est une annulation coopérative. Les autres clients reçoivent l'enveloppe ci-dessus et interrogent. Les deux chemins mènent au même résultat final. Les audits suivent le même modèle sans tasks : audit.audit.create répond immédiatement et audit.audit.get indique la progression. Le seul appel bloquant d'Ironfang Rig, rig.event.wait, est limité à soixante secondes, et un délai dépassé est une réponse.

Ressources

Les métadonnées en lecture seule sont aussi exposées sous forme de modèles de ressources, pour les clients qui préfèrent joindre du contexte plutôt qu'appeler des outils. Vos objets ne sont pas énumérés ; les identifiants viennent des résultats des outils.

Les descriptions et les coûts sont affichés ici en anglais, tels que le serveur les renvoie dans tools/list.

Crédits et budgets

Il n'y a pas de frais MCP. Se connecter, lister les outils, lire l'utilisation et lire les métadonnées sont gratuits. Le rendu consomme des crédits Ironfang Render ordinaires au tarif ordinaire, et le travail échoué ou annulé suit les mêmes règles de remboursement que l'API REST. Lancer un audit consomme des crédits Ironfang Audit de la même façon, sur un budget de connexion distinct. Les outils Ironfang Finance et Ironfang Rig ne coûtent rien.

En plus du plafond de l'offre, chaque connexion a son propre budget, pour qu'un agent pris dans une boucle ne puisse pas dépenser le quota d'un mois en un après-midi :

connection budget = max(25, 10% of the plan's monthly credits)
                                capped by the organisation's remaining allowance
                                per billing period

Avant un travail payant, le serveur réserve le coût maximal de l'outil sur le budget, puis règle ce que le produit a réellement facturé et libère le reste ; ironfang.connection.get indique le quota, ce qui est réservé, ce qui a été réglé, ce qui reste et quand il se réinitialise. Un budget épuisé répond mcp_budget_exhausted avec l'heure de réinitialisation ; le plafond de l'offre répond le quota_exceeded habituel du produit.

Outils Ironfang Audit

Lire les sites, les audits, les constats, les règles et l'utilisation, et lancer un audit limité d'un site. La modification d'une règle, d'un site, d'une surveillance ou d'un constat reste dans le portail et l'API REST. Lancer un audit réserve, sur le budget Ironfang Audit de la connexion, un crédit par page autorisée par la politique d'exploration du site, jusqu'à 200, et règle ce que l'audit a consommé. Le texte de page d'un constat est un contenu observé sur un site web et il est marqué comme non fiable. Un paquet de preuves n'est jamais servi par la connexion : sa ressource indique où se trouve le paquet et comment le vérifier. Rien ici n'expose à un modèle les secrets d'intégration, la modification des règles, les planifications ou les réglages de conservation.

Les descriptions et les coûts sont affichés ici en anglais, tels que le serveur les renvoie dans tools/list.

Outils Ironfang Finance

Référence uniquement : ce que signifie une règle de validation et comment la corriger, et quels jeux de règles le validateur exécute. La validation et la génération de documents, les résultats et les tâches passent uniquement par REST ; l'API Ironfang Finance accepte une clé API de la plateforme et n'a pas encore de délégation OAuth. Les outils de règles répondent à partir des mêmes explications vérifiées que la référence des règles de validation, si bien qu'un assistant face à un constat comme BR-CO-10 peut dire ce qu'il signifie et comment corriger la facture. Ils n'ont besoin que de ironfang:mcp, ne coûtent rien et ne nécessitent pas de compte Ironfang Finance. Pour valider ou générer un document, appelez l'API REST avec une clé API de plateforme, ou utilisez le validateur gratuit.

Les descriptions et les coûts sont affichés ici en anglais, tels que le serveur les renvoie dans tools/list.

Outils Ironfang Rig

Le produit Ironfang Rig sous forme d'outils, pour qu'un assistant puisse donner à l'application sur laquelle il travaille un monde extérieur jetable : une boîte de réception neuve, une URL de callback publique, un endpoint simulé ou une route vers un port local, puis attendre sur la chronologie, perturber volontairement et exporter les preuves. Chaque outil est lié à l'organisation de la connexion et ne coûte aucun crédit. Les octets des contenus ne sont jamais renvoyés par la connexion : les outils renvoient ce que la chronologie a enregistré, marqué comme contenu tiers, et renvoient vers l'API pour le reste. Lancer une exécution a un effet public, que l'outil signale : ses adresses acceptent des e-mails et des requêtes de n'importe qui pendant toute la durée de l'exécution.

Les descriptions et les coûts sont affichés ici en anglais, tels que le serveur les renvoie dans tools/list.

Découverte

Tout ce dont un registre, un scanner ou un agent de code a besoin pour comprendre le serveur peut être lu sans jeton. Appeler un outil en demande toujours un.

Une fois connecté, initialize renvoie de courtes instructions qui nomment chaque préfixe d'outil et indiquent par où commencer, tools/list renvoie chaque outil avec son schéma, ses indications et ses métadonnées, et ironfang.connection.get renvoie l'organisation, les portées, les produits et les budgets de cette connexion.

Noms et compatibilité

Renderwolf, Auditwolf et Financewolf sont les noms sous lesquels Ironfang Render, Ironfang Audit et Ironfang Finance ont été lancés. Ce ne sont pas des produits distincts. Un alias est le nom sous lequel un produit a été lancé. Il reste appelable pour que les configurations enregistrées continuent de fonctionner, il n'est jamais listé par tools/list et ce n'est pas un produit distinct. Les URI de ressources sous les noms d'alias sont résolues de la même façon. Utilisez les noms actuels.

Les portées suivent la même règle : un jeton ou une clé émis avec une portée de l'époque du lancement comme renderwolf:render est lu comme render:render. Les nouvelles connexions ne se voient proposer que les noms actuels.

Sécurité

• Le jeton d'accès MCP est destiné à https://mcp.ironfang.uk/mcp et à rien d'autre ; les produits le rejettent, et le serveur MCP rejette les jetons destinés au portail ou à un produit.
• Les appels aux produits utilisent un jeton distinct de deux minutes, émis à chaque appel, limité à vos portées accordées et à votre organisation choisie, et jamais une clé stockée.
• Les portées sont revérifiées à chaque appel par rapport à vos autorisations actuelles dans l'organisation, et le statut d'autorisation de la connexion avec un cache d'au plus trente secondes qui refuse en cas de doute.
• L'identité d'un client est un Client ID Metadata Document récupéré en HTTPS avec des protections contre les réseaux privés, les redirections et les tailles excessives, ou un enregistrement de client public à débit limité, retiré après trente jours sans utilisation. Les enregistrements ne peuvent pas choisir leurs propres portées.
• Les outils de rendu refusent les cookies, les en-têtes d'autorisation et personnalisés, les proxys, l'exécution de scripts et les cibles sur un réseau privé. Le HTML brut est borné et jamais journalisé.
• Les liens de téléchargement signés expirent au bout de quinze minutes et sont liés à l'organisation de la tâche.
• Aucun outil n'émet de clés, ne gère les membres ou les clients, ne change d'offre, ne supprime de preuves ni n'appelle une API arbitraire.
• Des limites de concurrence par connexion et par organisation, des plafonds de coût par appel et un coupe-circuit par outil bornent les dégâts qu'un client défaillant peut causer.

Dépannage

Chaque réponse porte X-Ironfang-Request-ID ; un identifiant de requête ou l'identifiant de connexion renvoyé par ironfang.connection.get suffit au support pour retrouver un appel. Communiquez-les, jamais un jeton.

Confidentialité

Pour chaque appel MCP, Ironfang enregistre l'identifiant de connexion, l'organisation, le nom de l'outil, la méthode, le résultat, la latence, la taille de la requête et l'identifiant de requête. Il n'enregistre pas les arguments des outils, les prompts, les résultats des outils ni les réponses du modèle. Les rendus produits sont stockés comme tâches Ironfang Render selon la conservation ordinaire de l'organisation (24 heures pour les résultats hébergés) et sont visibles par cette organisation dans le portail. Les écrans de consentement et les enregistrements sont consignés comme événements de sécurité sur le compte. Déconnecter un client révoque ses jetons ; cela ne supprime pas les tâches que l'organisation a déjà payées.