MCP: technische Dokumentation

Verbindung und Anmeldung

Adresse: https://lebenslaufheld.de/mcp. Transport: Streamable HTTP. Der Server arbeitet ohne Anmeldung und ohne API-Schlüssel. Er verwendet keine dauerhafte MCP-Session. Ein normaler Browserabruf derselben Adresse zeigt die Einstiegsseite.

Verwende einen MCP-Client, der Initialisierung und Versionsaushandlung übernimmt. Bei direkten HTTP-Anfragen sind Content-Type: application/json und Accept: application/json, text/event-stream erforderlich. Sende nach der Initialisierung die ausgehandelte Version im Header MCP-Protocol-Version.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-03-26",
    "capabilities": {},
    "clientInfo": {
      "name": "mein-mcp-client",
      "version": "1.0.0"
    }
  }
}

Danach sendet der Client notifications/initialized und kann mit tools/list die aktuellen Werkzeuge abfragen. Maßgeblich sind die vom Server gelieferten Eingabeschemas. Ein Schema-Abzug vom 5. September 2026 steht auch als JSON bereit.

Lebenslauf erstellen

lebenslauf_erstellen erwartet daten und optional template. Die Standardvorlage heißt klassisch. Die Antwort enthält einen Link zum kostenlosen PDF mit Wasserzeichen, einen Link zur Bearbeitung im Editor und, wenn die Vorschau erzeugt werden kann, ein Vorschaubild.

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "lebenslauf_erstellen",
    "arguments": {
      "daten": {
        "personal_data": {
          "vorname": "Erika",
          "nachname": "Muster",
          "email": "erika@example.com"
        },
        "berufserfahrung": [
          {
            "von": "2022-04",
            "bis_heute": true,
            "position": "Bürokauffrau",
            "firma": "Beispiel GmbH",
            "beschreibung": "Termine koordinieren und Kundenanfragen bearbeiten."
          }
        ]
      },
      "template": "klassisch"
    }
  }
}

Die Beispieldaten sind erfunden. Datumsangaben für Stationen verwenden JJJJ-MM. Bei laufenden Stationen ist bis_heute: true vorgesehen. Optional sind außerdem Ausbildung, Kenntnisse und Extras möglich; die vollständigen Felder und Längenbegrenzungen stehen im Schema.

ATS-Check

ats_check erwartet ein PDF als Base64-String in pdf_base64, ohne Data-URL-Präfix. Geprüft wird die technische Lesbarkeit, etwa Textschicht und Schriften. Das ist keine Prognose zur Einladungschance und keine externe KI-Bewertung. Das dekodierte PDF darf höchstens 10 MiB groß sein.

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "ats_check",
    "arguments": {
      "pdf_base64": "BASE64_DES_VOLLSTAENDIGEN_PDFS"
    }
  }
}

Der Platzhalter muss vor dem Aufruf durch die Base64-Kodierung eines echten PDFs ersetzt werden. Die Antwort liefert ein textuelles Ergebnis mit einzelnen Prüfhinweisen.

Vollständigkeit prüfen

vollstaendigkeits_check verwendet dieselbe Struktur in daten wie die Erstellung. Es unterscheidet regelbasiert fehlende, empfohlene und optionale Angaben. Es wird kein Entwurf gespeichert.

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "vollstaendigkeits_check",
    "arguments": {
      "daten": {
        "personal_data": {
          "vorname": "Erika",
          "nachname": "Muster"
        }
      }
    }
  }
}

Vorlagen und Berufsbeispiele

vorlagen_liste benötigt keine Argumente und liefert Vorlagennamen mit Bildadressen. Verwende einen dieser Namen als template.

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "vorlagen_liste",
    "arguments": {}
  }
}

beruf_beispiel erwartet einen Berufsnamen in beruf und liefert passende Musterinhalte.

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "beruf_beispiel",
    "arguments": {
      "beruf": "Softwareentwickler"
    }
  }
}

Limits und Fehler behandeln

• Der HTTP-Anfragekörper ist auf 15 MiB begrenzt. Base64 vergrößert die zu übertragende Datei.
• Bei HTTP 429 gilt eine Zugriffsbegrenzung. Beachte Retry-After und wiederhole verzögert.
• HTTP 413 bedeutet, dass der Anfragekörper zu groß ist. Verkleinere ihn vor einem erneuten Versuch.
• Ungültige Argumente können als MCP-Fehler bzw. als Werkzeugantwort mit isError erscheinen.
• Fachliche Hinweise, etwa eine unbekannte Vorlage oder ungültiges Base64, können auch im Textinhalt stehen. HTTP 200 allein belegt deshalb keinen erfolgreichen Werkzeugaufruf.
• Ein nicht mehr vorhandener Entwurf liefert beim Abruf über die PDF- oder Entwurfsadresse HTTP 404.

Die Limits werden pro IP-Adresse angewendet und unterscheiden sich nach Art der Anfrage. Vermeide parallele Wiederholungsschleifen. lebenslauf_erstellen erzeugt bei jedem Aufruf einen neuen Entwurf; nach einem unklaren Timeout daher nicht unbegrenzt automatisch erneut aufrufen.

Daten, Kosten und Grenzen

Entwürfe werden unter einer zufälligen Kennung gespeichert und zur Löschung nach sieben Tagen vorgesehen. Die Bereinigung erfolgt automatisch; sie ist kein sekundengenauer Ablaufmechanismus. Wer den Entwurfslink kennt, kann den Entwurf abrufen. Behandle diese Links daher vertraulich.

Die MCP-Werkzeuge rufen selbst kein Sprachmodell auf. Für die Verarbeitung im vorgeschalteten KI-Chat gelten die Bedingungen des vom Nutzer gewählten Anbieters. PDF-Inhalte beim ATS-Check werden für die Prüfung im Arbeitsspeicher verarbeitet.

Das PDF mit Wasserzeichen ist kostenlos. Der Download ohne Wasserzeichen erfolgt im Editor mit Nutzerkonto und kostet einen Credit pro Download. Credits werden einmalig gekauft, ohne Abo. Die MCP-Schnittstelle nimmt keine Zahlungen entgegen und greift nicht auf bestehende Nutzerkonten zu.

Weitere Angaben: Datenschutzerklärung. Fragen zur Integration: info@lebenslaufheld.de.