Referenz des MCP-Servers

Überblick

Der Ironfang MCP-Server ist ein Remote-Server für das Model Context Protocol. Ein Endpunkt bedient Ironfang Render, Ironfang Audit, Ironfang Finance und Ironfang Rig:

https://mcp.ironfang.uk/mcp

MCP ist kein eigenes Produkt und hat keinen eigenen Preis. Es ist ein weiterer sicherer Weg, die Produkte zu nutzen, die Sie bereits haben: Rendering und Audits verbrauchen die normalen Credits der Organisation, Lesezugriffe sind kostenlos, und jede Verbindung hat ein eigenes Ausgabenbudget (siehe Credits und Budgets).

Client-Kompatibilität

Der Server spricht Standard-OAuth. Claude Code und claude.ai haben wir selbst getestet; andere MCP-Clients verbinden sich über dieselben Standards.

Claude Code

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

Führen Sie anschließend in Claude Code /mcp aus, wählen Sie ironfang und dann Authenticate. Ein Browser-Tab öffnet sich bei id.ironfang.uk: Melden Sie sich an, wählen Sie die Organisation, für die diese Verbindung handelt, prüfen Sie die Berechtigungen und erlauben Sie sie. Der Tab schließt sich, und die Tools erscheinen.

Claude Desktop und claude.ai

Settings → Connectors → Add custom connector (so heißen die Menüpunkte in der englischen Oberfläche), nennen Sie den Connector Ironfang und geben Sie https://mcp.ironfang.uk/mcp ein. Es folgt dieselbe Anmeldung.

Fügen Sie niemals einen API-Schlüssel in einen Chat ein. Der MCP-Server akzeptiert keine Ironfang-API-Schlüssel als Zugangsdaten; Schlüssel bleiben bei der REST-API, wo sie hingehören.

Authentifizierung

Der Server ist eine durch OAuth 2.1 geschützte Ressource. Eine nicht authentifizierte Anfrage beantwortet er mit 401 und einer WWW-Authenticate-Challenge, die auf das Dokument mit den Ressourcen-Metadaten verweist; von dort ermittelt ein Client den Autorisierungsserver und durchläuft den Code-Flow mit PKCE (S256). Der Ablauf aus Sicht des Clients:

1. https://mcp.ironfang.uk/.well-known/oauth-protected-resource/mcp lesen.
2. https://id.ironfang.uk/.well-known/oauth-authorization-server lesen.
3. Sich ausweisen: über ein Client ID Metadata Document (eine HTTPS-URL als Client-ID, bevorzugt) oder durch Registrierung als öffentlicher Client unter /oauth/register.
4. Die Person zu /oauth/authorize schicken, mit resource=https://mcp.ironfang.uk/mcp, den gewünschten Berechtigungen und einer PKCE-Challenge.
5. Die Person meldet sich an, wählt eine Organisation und stimmt zu. Eine Verbindung ist eine Person, eine Organisation, ein Client.
6. Den Code unter /oauth/token eintauschen. Das Access-Token ist kurzlebig und nur an die MCP-Ressource adressiert; ein rotierendes Refresh-Token hält die Verbindung aufrecht, ohne erneut zu fragen.

Berechtigungen (Scopes)

Die Berechtigungen sind die des jeweiligen Produkts. Eine Berechtigung wird nur erteilt, wenn die Person die passende Befugnis in der gewählten Organisation hat, und sie wird bei jedem Aufruf erneut live geprüft: Wer eine Befugnis verliert, verliert den Zugriff in derselben Minute.

Ein Tool, dessen Berechtigung nicht erteilt wurde, wird trotzdem aufgeführt, damit ein Client sie anfordern kann: Der Aufruf antwortet mit 403 und der vollständigen Berechtigungsmenge in der Challenge, und der Client durchläuft den Ablauf für die zusätzliche Berechtigung erneut.

Was der Server mit dem Token macht

Nichts verlässt den MCP-Server mit Ihrem MCP-Token. Um ein Produkt aufzurufen, fordert er bei id.ironfang.uk ein separates Token mit zwei Minuten Laufzeit an, das an dieses Produkt adressiert ist, auf die erteilten Berechtigungen und die gewählte Organisation beschränkt ist und als in Ihrem Auftrag handelnd gekennzeichnet ist. Die Produkte lehnen ein MCP-Token grundsätzlich ab, und der MCP-Server lehnt Portal- oder Produkt-Tokens ab.

Widerrufen

Trennen Sie einen Client auf der Seite AI clients im Portal oder in Ihren Kontoeinstellungen bei id.ironfang.uk. Der Widerruf beendet die Familie der Refresh-Tokens und die Verbindung; ein noch gültiges Access-Token funktioniert innerhalb von dreißig Sekunden nicht mehr, nicht erst bei seinem Ablauf.

Tools von Ironfang Render

Tool-Eingaben sind strikte JSON-Schema-Objekte: Unbekannte Felder werden abgelehnt statt ignoriert, und jede Zeichenkette, Größe und Dauer ist begrenzt. Rendering-Tools nehmen eine öffentliche URL oder begrenztes rohes HTML an. Sie akzeptieren keine Cookies, Authorization-Header, eigenen Request-Header, Proxy-Einstellungen, auszuführenden Skripte und keine Ziele in privaten Netzen.

Beschreibungen und Kostenangaben stehen hier auf Englisch, so wie der Server sie in tools/list liefert.

Zwischengespeicherte Wiederholungen sind kostenlos, genau wie bei der REST-API, und das Branding der Ausgabe im kostenlosen Tarif ist dasselbe, egal auf welchem Weg Sie rendern. Jedes Tool trägt Hinweise (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) und Metadaten mit Namensraum, die seine Berechtigung, sein Produkt, sein Credit-Verhalten und sein Risiko nennen, damit ein Client einer Person zeigen kann, was ein Aufruf tun wird, bevor er es tut.

Jobs, Tasks und Ergebnisse

Jedes Tool, das etwas erstellt, legt einen dauerhaften Job bei Ironfang Render an und antwortet sofort mit demselben Envelope, sodass ein erneuter Versuch oder eine abgebrochene Verbindung nie Arbeit verliert oder verdoppelt:

{
              "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..."
            }

Fragen Sie render.job.get ab (oder lesen Sie die Job-Ressource). Sobald status den Wert succeeded hat, enthält result den Medientyp, die Größe in Bytes, den SHA-256, den Zeitpunkt, zu dem das gehostete Ergebnis abläuft, und einen Download-Link:

• Gehostete Ergebnisse werden nach dem Erfolg 24 Stunden aufbewahrt.
• Download-Links sind signiert und 15 Minuten gültig; jedes Lesen des Jobs oder seiner Ergebnis-Ressource stellt einen neuen aus.
• Links sind auch bei Screenshots der Standard. PDFs, Clips und ganzseitige Bilder werden nie inline zurückgegeben; ein Screenshot unter 2 MiB kann es werden, aber nur, wenn ein Client es ausdrücklich anfordert.
• Für eine längere Aufbewahrung laden Sie das Ergebnis herunter oder nennen im delivery-Block des Erstellungs-Tools ein Webhook- oder Speicherziel (render.destination.list zeigt, was das Konto hat).

Ein Client, der die Erweiterung io.modelcontextprotocol/tasks unterstützt, fordert einen Task an, indem er ein task-Objekt in die Parameter von tools/call legt. Er erhält dann für Screenshot-, PDF- und Vorlagenarbeit ein Task-Handle und muss für Clips eines verwenden; tasks/get spiegelt den Zustand des Jobs, tasks/result gibt den Envelope zurück, und tasks/cancel ist ein kooperativer Abbruch. Andere Clients erhalten den Envelope oben und fragen ab. Beide Wege enden beim identischen Endergebnis. Audits folgen demselben Muster ohne Tasks: audit.audit.create antwortet sofort, und audit.audit.get meldet den Fortschritt. Der einzige blockierende Aufruf von Ironfang Rig, rig.event.wait, ist auf sechzig Sekunden begrenzt, und eine Zeitüberschreitung ist eine Antwort.

Ressourcen

Schreibgeschützte Metadaten stehen auch als Ressourcenvorlagen bereit, für Clients, die lieber Kontext anhängen als Tools aufzurufen. Ihre Objekte werden nicht aufgezählt; IDs stammen aus Tool-Ergebnissen.

Beschreibungen und Kostenangaben stehen hier auf Englisch, so wie der Server sie in tools/list liefert.

Credits und Budgets

Es gibt keine MCP-Gebühr. Verbinden, Tools auflisten, Nutzung lesen und Metadaten lesen sind kostenlos. Rendering verbraucht normale Credits von Ironfang Render zum normalen Satz, und für fehlgeschlagene oder abgebrochene Arbeit gelten dieselben Erstattungsregeln wie bei der REST-API. Das Starten eines Audits verbraucht Credits von Ironfang Audit auf dieselbe Weise, gegen ein separates Verbindungsbudget. Die Tools von Ironfang Finance und Ironfang Rig kosten nichts.

Zusätzlich zur Obergrenze des Tarifs hat jede Verbindung ein eigenes Budget, damit ein Agent in einer Schleife nicht an einem Nachmittag das Kontingent eines Monats ausgeben kann:

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

Vor kostenpflichtiger Arbeit reserviert der Server die maximalen Kosten des Tools gegen das Budget, rechnet dann ab, was das Produkt tatsächlich berechnet hat, und gibt den Rest frei; ironfang.connection.get zeigt das Kontingent, was reserviert ist, was abgerechnet wurde, was übrig ist und wann es zurückgesetzt wird. Ein ausgeschöpftes Budget antwortet mit mcp_budget_exhausted und dem Zeitpunkt der Rücksetzung; die Obergrenze des Tarifs antwortet mit dem üblichen quota_exceeded des Produkts.

Tools von Ironfang Audit

Websites, Audits, Befunde, Regeln und Nutzung lesen und ein begrenztes Audit einer Website starten. Änderungen an einer Regel, einer Website, einer Überwachung oder einem Befund bleiben im Portal und in der REST-API. Das Starten eines Audits reserviert gegen das Ironfang-Audit-Budget der Verbindung einen Credit pro Seite, die die Crawl-Richtlinie der Website zulässt, höchstens 200, und rechnet ab, was das Audit verbraucht hat. Seitentext in einem Befund ist auf einer Website beobachteter Inhalt und als nicht vertrauenswürdig gekennzeichnet. Ein Nachweispaket wird nie über die Verbindung ausgeliefert: Seine Ressource sagt, wo das Paket liegt und wie es sich prüfen lässt. Nichts davon gibt einem Modell Zugriff auf Integrationsgeheimnisse, das Bearbeiten von Regeln, Zeitpläne oder Aufbewahrungseinstellungen.

Beschreibungen und Kostenangaben stehen hier auf Englisch, so wie der Server sie in tools/list liefert.

Tools von Ironfang Finance

Nur Referenz: was eine Validierungsregel bedeutet und wie man sie behebt, und welche Regelwerke der Validator ausführt. Validierung und Erzeugung von Dokumenten, Ergebnisse und Jobs gibt es nur über REST; die Ironfang Finance API nimmt einen Plattform-API-Schlüssel an und hat noch keine OAuth-Delegation. Die Regel-Tools antworten aus denselben geprüften Erläuterungen wie die Referenz der Validierungsregeln, sodass ein Assistent, dem ein Befund wie BR-CO-10 vorliegt, sagen kann, was er bedeutet und wie sich die Rechnung korrigieren lässt. Sie brauchen nur ironfang:mcp, kosten nichts und erfordern kein Konto bei Ironfang Finance. Um ein Dokument zu validieren oder zu erzeugen, rufen Sie die REST-API mit einem Plattform-API-Schlüssel auf oder nutzen Sie den kostenlosen Validator.

Beschreibungen und Kostenangaben stehen hier auf Englisch, so wie der Server sie in tools/list liefert.

Tools von Ironfang Rig

Das Produkt Ironfang Rig als Tools, damit ein Assistent der Anwendung, an der er arbeitet, eine wegwerfbare Außenwelt geben kann: ein frisches Postfach, eine öffentliche Callback-URL, einen Mock-Endpunkt oder eine Route zu einem lokalen Port, dann auf die Zeitleiste warten, gezielt eingreifen und die Nachweise exportieren. Jedes Tool ist an die Organisation der Verbindung gebunden und kostet keine Credits. Nutzdaten-Bytes werden nie über die Verbindung zurückgegeben: Die Tools liefern, was die Zeitleiste aufgezeichnet hat, als Inhalt Dritter gekennzeichnet, und verweisen für den Rest auf die API. Das Starten eines Laufs hat eine öffentliche Wirkung, die das Tool nennt: Seine Adressen nehmen während der Laufzeit E-Mails und Anfragen von jedem an.

Beschreibungen und Kostenangaben stehen hier auf Englisch, so wie der Server sie in tools/list liefert.

Auffindbarkeit

Alles, was eine Registry, ein Scanner oder ein Coding-Agent braucht, um den Server zu verstehen, lässt sich ohne Token lesen. Ein Tool aufzurufen erfordert immer eines.

Nach dem Verbinden liefert initialize kurze Anweisungen, die jedes Tool-Präfix nennen und sagen, wo man anfängt, tools/list liefert jedes Tool mit Schema, Hinweisen und Metadaten, und ironfang.connection.get liefert Organisation, Berechtigungen, Produkte und Budgets dieser Verbindung.

Namen und Kompatibilität

Renderwolf, Auditwolf und Financewolf sind die Namen, unter denen Ironfang Render, Ironfang Audit und Ironfang Finance gestartet sind. Es sind keine eigenen Produkte. Ein Alias ist der Name, unter dem ein Produkt gestartet ist. Er bleibt aufrufbar, damit gespeicherte Konfigurationen weiter funktionieren, wird von tools/list nie aufgeführt und ist kein eigenes Produkt. Ressourcen-URIs unter den Alias-Namen werden genauso aufgelöst. Verwenden Sie die aktuellen Namen.

Für Berechtigungen gilt dieselbe Regel: Ein Token oder Schlüssel, der mit einer Berechtigung aus der Startzeit wie renderwolf:render erstellt wurde, wird als render:render gelesen. Neuen Verbindungen werden immer nur die aktuellen Namen angeboten.

Sicherheit

• Das MCP-Access-Token ist an https://mcp.ironfang.uk/mcp adressiert und an nichts anderes; die Produkte lehnen es ab, und der MCP-Server lehnt Tokens ab, die für das Portal oder ein Produkt bestimmt sind.
• Produktaufrufe nutzen ein separates, pro Aufruf erzeugtes Token mit zwei Minuten Laufzeit, beschränkt auf Ihre erteilten Berechtigungen und Ihre gewählte Organisation, und nie einen gespeicherten Schlüssel.
• Berechtigungen werden bei jedem Aufruf erneut gegen Ihre aktuellen Befugnisse in der Organisation geprüft, der Freigabestatus der Verbindung mit einem Cache von höchstens dreißig Sekunden, der im Zweifel sperrt.
• Die Identität eines Clients ist ein Client ID Metadata Document, das über HTTPS mit Schutz vor privaten Netzen, Weiterleitungen und übergroßen Antworten abgerufen wird, oder eine ratenbegrenzte Registrierung als öffentlicher Client, die nach dreißig Tagen ohne Nutzung stillgelegt wird. Registrierungen können ihre Berechtigungen nicht selbst wählen.
• Rendering-Tools lehnen Cookies, Authorization- und eigene Header, Proxys, Skriptausführung und Ziele in privaten Netzen ab. Rohes HTML ist begrenzt und wird nie protokolliert.
• Signierte Download-Links laufen nach fünfzehn Minuten ab und sind an die Organisation des Jobs gebunden.
• Es gibt kein Tool, das Schlüssel erzeugt, Mitglieder oder Clients verwaltet, Tarife ändert, Nachweise löscht oder eine beliebige API aufruft.
• Begrenzungen der Parallelität pro Verbindung und pro Organisation, Kostenobergrenzen pro Aufruf und ein Notschalter pro Tool begrenzen den Schaden, den ein fehlerhafter Client anrichten kann.

Fehlerbehebung

Jede Antwort enthält X-Ironfang-Request-ID; eine Anfrage-ID oder die Verbindungs-ID aus ironfang.connection.get ist alles, was der Support braucht, um einen Aufruf zu finden. Nennen Sie diese, nie ein Token.

Datenschutz

Für jeden MCP-Aufruf speichert Ironfang die Verbindungs-ID, die Organisation, den Tool-Namen, die Methode, das Ergebnis, die Latenz, die Anfragegröße und die Anfrage-ID. Tool-Argumente, Prompts, Tool-Ergebnisse und Modellausgaben werden nicht gespeichert. Gerenderte Ausgaben werden als Jobs von Ironfang Render unter der normalen Aufbewahrung der Organisation gespeichert (24 Stunden für gehostete Ergebnisse) und sind für diese Organisation im Portal sichtbar. Zustimmungsseiten und Registrierungen werden als Sicherheitsereignisse im Konto erfasst. Das Trennen eines Clients widerruft seine Tokens; die Jobs, für die die Organisation bereits bezahlt hat, werden dadurch nicht gelöscht.