Integrationen

MCP-Server

Die FireAPI-Dokumentation steht zusätzlich als Model-Context-Protocol-Server bereit. MCP-fähige Clients — etwa Claude Desktop, Claude Code oder Cursor — können Endpunkte durchsuchen, Parameter einsehen und Beispielantworten abrufen, ohne dass du zwischen IDE und Browser wechseln musst.

Verfügbare Tools

Name Eingabe Beschreibung
search_endpoints query: string · limit?: int Tippfehler-tolerante Volltextsuche über Namen, Pfade, Beschreibungen, Parameter und Enum-Werte.
get_endpoint path: string oder id: int Vollständige Doku eines Endpunkts inklusive Parameter, Antwortbeispielen und Enum-Referenzen.
list_categories include_endpoints?: bool Hierarchische Übersicht aller Kategorien, Funktionsgruppen und Endpunkte.
get_enum key: string Liefert die zulässigen Werte eines Enums (z.B. vm.os, dns.record).

Einrichtung

  1. In Claude Desktop in der linken Seitenleiste auf Customize klicken.
  2. Im Bereich Connectors ganz unten auf Add custom connector klicken.
  3. Als URL https://docs.fireapi.de/mcp eintragen und mit Add bestätigen.

Der Server benötigt keine Authentifizierung und ist sofort einsatzbereit. Im Eingabefeld erscheint ein Werkzeug-Symbol mit den vier verfügbaren Tools.

Alternative: Konfigurationsdatei mit mcp-remote-Bridge

Für Pläne ohne Connectors-Funktion lässt sich der Server auch über eine STDIO-Bridge anbinden. Dafür benötigt das System eine installierte Node.js-Umgebung (npx).

Unter Einstellungen → Entwickler → Edit Config die claude_desktop_config.json öffnen und ergänzen: 

{
  "mcpServers": {
    "fireapi-docs": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://docs.fireapi.de/mcp"
      ]
    }
  }
}
macOS
~/Library/Application Support/Claude/claude_desktop_config.json
Windows
%APPDATA%\Claude\claude_desktop_config.json

Anschließend Claude Desktop vollständig schließen und neu starten.

In einer aktiven Claude-Code-Session:

claude mcp add --transport http fireapi-docs https://docs.fireapi.de/mcp

Verbindungsstatus mit dem Befehl /mcp prüfen.

In Cursor unter Settings → Tools & Integrations → MCP auf Add new MCP server klicken – die globale mcp.json öffnet sich. Dort folgenden Eintrag ergänzen: 

{
  "mcpServers": {
    "fireapi-docs": {
      "url": "https://docs.fireapi.de/mcp"
    }
  }
}

Dateipfad (alternativ direkt editieren)

macOS/Linux
~/.cursor/mcp.json
Windows
%USERPROFILE%\.cursor\mcp.json

Soll der Server nur in einem einzelnen Projekt aktiv sein, stattdessen .cursor/mcp.json im Projekt-Root anlegen.

Sobald die Datei gespeichert ist, erscheint der Server in der MCP-Liste mit grünem Status.

Direkte Anbindung mit dem offiziellen @modelcontextprotocol/sdk in TypeScript: 

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport }
  from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const client = new Client({ name: "fireapi-app", version: "1.0.0" });
await client.connect(new StreamableHTTPClientTransport(
  new URL("https://docs.fireapi.de/mcp")
));

const { tools } = await client.listTools();

const result = await client.callTool({
  name: "search_endpoints",
  arguments: { query: "vm starten" }
});

SDKs sind außerdem für Python, Java, Kotlin, Go und C# verfügbar.

Beispielanfragen

„Welche Endpunkte gibt es zum Thema Backup?"
„Zeig mir die Parameter von /vm/:vmid/start und welche Werte für vm.os erlaubt sind."
„Generiere einen TypeScript-Wrapper für /domain/:domain/dns inklusive aller Enum-Werte."
„Vergleiche die Layer4- und Layer7-DDoS-Endpunkte."