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.com/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: Was ein Assistent tut, ist normale Nutzung dieser Produkte, Lesezugriffe sind kostenlos, und die Nutzungslimits des Kontos gelten wie bei der API (siehe Nutzung und Limits).

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.com/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.com: 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.com/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.com/.well-known/oauth-protected-resource/mcp lesen.
2. https://id.ironfang.com/.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.com/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.com 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.com. 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 stehen hier auf Englisch, so wie der Server sie in tools/list liefert.

Zwischengespeicherte Wiederholungen werden nicht gezählt, genau wie bei der REST-API, und die Ausgabe ist dieselbe, egal auf welchem Weg Sie rendern. Jedes Tool trägt Hinweise (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) und Metadaten mit Namensraum, die seine Berechtigung, sein Produkt, ob es als Nutzung zählt, 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,
  "usage": { "meter": "render.screenshot", "reserved": 1, "committed": 0 },
  "result": null,
  "created_at": "2026-08-27T23:09:45Z",
  "connection_id": "01a0..."
}

Sein usage nennt den Zähler, auf den der Job zählt, was das Produkt dafür reserviert hat und was es verbucht hat; das bleibt null, bis der Job erfolgreich ist.

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 stehen hier auf Englisch, so wie der Server sie in tools/list liefert.

Nutzung und Limits

Es gibt keine MCP-Gebühr. Verbinden, Tools auflisten, Nutzung lesen und Metadaten lesen werden nicht gezählt. Rendering über eine Verbindung ist normale Nutzung von Ironfang Render und wird mit denselben Zählern erfasst wie bei der REST-API; fehlgeschlagene oder abgebrochene Arbeit und zwischengespeicherte Wiederholungen werden dort wie hier nicht gezählt. Das Starten eines Audits ist auf dieselbe Weise normale Nutzung von Ironfang Audit. Die Regel-Tools von Ironfang Finance sind kostenlos. Die Tools von Ironfang Rig selbst werden nicht gezählt; die E-Mails, Callbacks und Mock-Austausche, die ein Lauf annimmt, sind Interaktionen von Ironfang Rig, wie über die API.

Ein eigenes Budget pro Verbindung gibt es nicht. Arbeit über eine Verbindung teilt sich die kostenlosen Kontingente des Kontos und, mit eingeschaltetem Pay as you go, sein monatliches Nutzungslimit und etwaige Produktlimits, die eine Person mit Abrechnungsrechten im Portal festlegt. Kostenpflichtige Arbeit, die ein Limit überschreiten würde, wird vor dem Start abgelehnt, sodass ein Agent in einer Schleife dort stoppt, wo Ihre Limits ihn stoppen. Die Preise stehen auf der Preisseite.

Vor gezählter Arbeit reserviert das Produkt das Höchstmaß, das der Aufruf verbrauchen kann, rechnet dann ab, was tatsächlich entstanden ist, und gibt den Rest frei. Ein aus Abrechnungsgründen abgelehnter Aufruf antwortet mit demselben Code wie die REST-API, etwa free_allowance_exhausted oder account_budget_exhausted; die Meldung sagt, was in Billing zu ändern ist.

Ein aus Abrechnungsgründen abgelehnter Aufruf ist ein Tool-Fehler mit einem dieser Codes, wie der Server sie auflistet: account_budget_exhausted, account_closed, account_restricted, billing_temporarily_unavailable, exemption_limit_reached, free_allowance_exhausted, operation_too_large, paid_usage_paused, payment_action_required, payment_required, product_budget_exhausted, product_not_eligible, tier_allowance_exhausted

ironfang.connection.get meldet, was die eigenen Aufrufe der Verbindung in diesem Monat verbraucht haben, je Zähler. Die Nutzung der Organisation liefern render.usage.get und audit.usage.get; das Abrechnungskonto selbst verwaltet eine Person im Portal, und über eine Verbindung lässt es sich nicht lesen.

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 die Seiten, die die Crawl-Richtlinie der Website zulässt, gegen die Nutzungslimits des Kontos und rechnet die tatsächlich erfassten Seiten ab, wie über die API. 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 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 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. Der Aufruf eines Tools wird nicht gezählt; die E-Mails, Callbacks und Mock-Austausche, die ein Lauf annimmt, zählen als Interaktionen von Ironfang Rig, wie über die API. 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 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 und Produkte 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. Die Tool-Präfixe und Ressourcen-URIs unter den Namen, unter denen die Produkte gestartet sind (renderwolf.*, auditwolf.*), wurden am 28. September 2026 eingestellt. Aufrufbar sind nur die aktuellen Namen.

Sicherheit

• Das MCP-Access-Token ist an https://mcp.ironfang.com/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, Abrechnungseinstellungen ä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, die die Organisation bereits ausgeführt hat, werden dadurch nicht gelöscht.