DoxAI
InhaltMCP-Connector

Referenz

MCP-Connector

Verbinde DoxAI mit Claude, ChatGPT oder einem anderen Remote-MCP-Client und lass ihn die Tools unten aufrufen.

DoxAI mit Claude verbinden

Der DoxAI-Connector ist ein Remote-MCP-Server. Seine URL steht unten; dieselbe URL funktioniert mit ChatGPT und jedem anderen Remote-MCP-Client.

  1. Füge einen benutzerdefinierten Connector hinzu und nenne ihn DoxAI.
  2. Füge die unten angegebene Connector-URL ein.
  3. Melde dich mit deinem DoxAI-Konto an, wenn Claude danach fragt. Die Anmeldung läuft über OAuth: Es muss kein Token kopiert werden.
https://app.doxai.ch/v1/mcp

Die Stellensuche (search_jobs, get_job, recommend_jobs mit cv_text) und die beiden Referenz-Tools app_get_info und resume_list_templates funktionieren schon vor der Anmeldung. Die übrigen Tools verlangen bei der ersten Verwendung die Anmeldung.

ChatGPT und andere Remote-MCP-Clients verwenden dieselbe URL. Ein Client ohne OAuth-Unterstützung kann ein persönliches API-Token mit dem Scope mcp:connect nutzen.

Der Connector funktioniert im kostenlosen Tarif mit denselben Limits wie die DoxAI-Web-App. Plus und Pro erhöhen das Kontingent.

Ohne OAuth

Erstelle auf deiner Kontoseite ein persönliches API-Token mit dem Scope mcp:connect und sende es als Bearer-Token:

{
  "url": "https://app.doxai.ch/v1/mcp",
  "headers": { "Authorization": "Bearer <token with mcp:connect>" }
}

So arbeiten die Tools

Typischer Ablauf
get_profile, um das Profil zu lesen, dann quick_apply mit der URL oder dem Text einer Stellenanzeige: Es erfasst, bewertet und entwirft die Bewerbung in einem Aufruf. Wer zuerst die Passung prüfen möchte, geht schrittweise vor: create_opportunity → analyze_opportunity → create_application → generate_application. Danach get_application_cv_pdf für den Link zum Lebenslauf, generate_letter, um das Anschreiben zu entwerfen oder neu zu entwerfen, get_application_letter für dessen Link und update_application_status, sobald der Benutzer die Bewerbung abgeschickt hat.
Aufrufe, die das Kontingent belasten
analyze_opportunity, generate_application, generate_letter und quick_apply werden dem Kontingent des Tarifs belastet und brauchen eine stabile request_id. Ein erneuter Versuch mit derselben request_id liefert das gespeicherte Ergebnis und wird nie ein zweites Mal angerechnet. Lesezugriffe, Profiländerungen, die Stellensuche und die PDF-Kompilierung sind kostenlos.
Tarif und Kontingent
account_get_billing_status liefert den Tarif (free, plus oder pro), das Kontingent als verbrauchten Prozentsatz (Tages- und Wochenfenster bei Plus und Pro, verbleibende Aktionen bei Kostenlos) und ai_settings: das angeheftete Modell, den Standardaufwand und die Modelle, die der Tarif nutzen darf.
Modell wählen
quick_apply und generate_application akzeptieren ein optionales model (eine ID aus ai_settings.models) nur für diesen Aufruf, mit Plus und Pro. Der kostenlose Tarif erhält model_not_available. Ihre Ergebnisse enthalten ein Feld model mit dem Modell, das den Lebenslauf entworfen hat.
Lange Aufrufe
quick_apply und generate_application laufen mehrere Minuten. Sie melden den Fortschritt Schritt für Schritt, wenn der Client einen progressToken sendet, und bleiben unter dem Zeitlimit eines Tool-Aufrufs des Clients: Optionale Schritte (Firmenrecherche, Prüfung, Überarbeitung, Layout-Korrekturen) können verkürzt werden und stehen dann in cutForTime (quick_apply) beziehungsweise cut_for_time (generate_application). Nach einem Timeout genügt ein erneuter Versuch mit derselben request_id, um das gespeicherte Ergebnis zu erhalten.
Nur Entwürfe
DoxAI entwirft Bewerbungsunterlagen und sendet oder reicht sie nie ein: Der Benutzer prüft sie und bewirbt sich selbst. Erzeugte Inhalte verwenden nur Fakten aus dem Profil des Benutzers.

Tools

33 Tools, nach Verwendungszweck gruppiert. Die vollständigen Ein- und Ausgabeschemas liefert tools/list.

Stellenanzeigen

3 Tools

Stellenanzeigen aus der ganzen Schweiz suchen und ordnen.

  • search_jobsSearch Job Ads

    Sucht Stellenanzeigen aus der ganzen Schweiz nach Stichwörtern, Kanton, Pensum und Alter.

    LesendOhne Anmeldung
  • get_jobGet Job Ad

    Liest eine Stellenanzeige vollständig, mit der ID aus search_jobs oder recommend_jobs.

    LesendOhne Anmeldung
  • recommend_jobsRecommend Job Ads for a CV or the Profile

    Ordnet Stellenanzeigen nach dem Profil oder nach einem eingefügten Lebenslauftext (nicht gespeichert).

    LesendOhne Anmeldung mit cv_text

Profil

3 Tools

Das Karriereprofil lesen und bearbeiten, aus dem jedes Dokument entsteht.

  • get_profileGet DoxAI Career Profile

    Liest das Karriereprofil, seine Revision und den Kontingentstatus.

    Lesend
  • update_profileUpdate DoxAI Career Profile

    Ändert Profilfelder; übergib die gerade gelesene Revision als base_revision.

    Schreibend
  • patch_profile_entriesEdit DoxAI Profile Entries by ID

    Fügt Profileinträge per ID hinzu, ändert oder entfernt sie, in einem einzigen Stapel.

    Schreibend

Anzeigen und Analyse

4 Tools

Stellenanzeigen speichern und anhand des Profils bewerten.

  • list_opportunitiesList Job Opportunities

    Listet die gespeicherten Stellenanzeigen, die neuesten zuerst.

    Lesend
  • get_opportunityGet Job Opportunity

    Liest eine gespeicherte Anzeige mit ihrer Analyse.

    Lesend
  • create_opportunityCapture Job Opportunity

    Speichert eine Anzeige aus ihrer URL, ihrem Text oder einer Anzeigen-ID.

    Schreibend
  • analyze_opportunityAnalyze Job Opportunity

    Bewertet eine Anzeige anhand des Profils und speichert die Analyse.

    SchreibendKontingent

Angepasster Lebenslauf und Anschreiben

8 Tools

Eine Bewerbung pro Anzeige entwerfen, prüfen und verfolgen.

  • quick_applyTailor a CV for a Job Posting

    Von der Anzeige zum geprüften Lebenslauf mit Anschreiben, in einem Aufruf.

    SchreibendKontingent
  • create_applicationOpen Application

    Eröffnet eine Bewerbung für eine gespeicherte Anzeige.

    Schreibend
  • generate_applicationGenerate Tailored Application

    Entwirft den angepassten Lebenslauf und das Anschreiben einer Bewerbung und prüft sie.

    SchreibendKontingent
  • generate_letterDraft Cover Letter

    Entwirft das Anschreiben einer Bewerbung oder entwirft es neu.

    SchreibendKontingent
  • list_applicationsList Applications

    Listet die Bewerbungen mit ihrem Status, zuletzt geänderte zuerst.

    Lesend
  • get_applicationGet Application

    Liest eine Bewerbung: Status, Anschreiben, Notizen und Prüfpunkte.

    Lesend
  • resolve_review_pointsAnswer Review Points

    Speichert die Antwort des Benutzers zu jedem Prüfpunkt: behalten, abschwächen oder streichen.

    Schreibend
  • update_application_statusUpdate Application Status

    Hält fest, wo eine Bewerbung steht, nachdem der Benutzer gehandelt hat.

    Schreibend

Dokumente und PDF

13 Tools

Lebensläufe und Anschreiben als PDF kompilieren, gespeicherte Lebensläufe verwalten.

  • get_application_cv_pdfGet Application CV PDF

    Kompiliert den Lebenslauf der Bewerbung als PDF und liefert einen Download-Link.

    Schreibend
  • get_application_letterGet Application Cover Letter

    Exportiert das Anschreiben als PDF oder .docx und liefert einen Download-Link.

    Schreibend
  • resume_list_templatesList Resume Templates

    Listet Lebenslaufvorlagen, Farben, Schriften und Größen.

    LesendOhne Anmeldung
  • resume_get_create_job_exampleGet Resume Job Example

    Liefert ein kanonisches cv_data-Beispiel als Ausgangspunkt.

    Lesend
  • resume_validate_cv_dataValidate Resume Data

    Prüft cv_data und listet, was zu korrigieren ist, ohne zu kompilieren.

    Lesend
  • resume_create_jobCreate Resume PDF Job

    Startet einen PDF-Kompilierauftrag aus cv_data.

    Schreibend
  • resume_get_jobGet Resume PDF Job

    Liest den Status eines Auftrags und, sobald er erfolgreich war, den PDF-Link.

    Lesend
  • resume_get_pdfGet Resume PDF Download

    Liefert einen kurzlebigen Link zum PDF eines fertigen Auftrags.

    Lesend
  • resume_list_jobsList Resume PDF Jobs

    Listet die Kompilieraufträge, die neuesten zuerst.

    Lesend
  • cv_list_resumesList Resumes

    Listet die gespeicherten Lebensläufe, die neuesten zuerst.

    Lesend
  • cv_get_resumeGet Resume

    Liest einen gespeicherten Lebenslauf.

    Lesend
  • cv_create_resumeCreate Resume

    Speichert einen neuen Lebenslauf aus einem kanonischen Snapshot.

    Schreibend
  • cv_update_resumeUpdate Resume

    Ersetzt den Inhalt eines gespeicherten Lebenslaufs oder ändert Vorlage oder Status.

    Schreibend

Tarif und Kontingent

2 Tools

Tarif, verbleibendes Kontingent und Serverangaben lesen.

  • account_get_billing_statusGet Plan and Quota

    Liest den Tarif, das Kontingent in Prozent und ai_settings.

    Lesend
  • app_get_infoGet DoxAI Information

    Liest öffentliche Server-Metadaten: Version, Endpunkte und Vorlagen.

    LesendOhne Anmeldung

Ressourcen

Ressourcenzugriffe sind auf den angemeldeten Benutzer beschränkt. resources/list liefert die URIs der gespeicherten Lebensläufe.

  • cv://templatesDer Katalog der Lebenslaufvorlagen. Ohne Konto lesbar.
  • cv://resumesIndex der gespeicherten Lebensläufe des Benutzers.
  • cv://resumes/{id}Ein gespeicherter Lebenslauf als JSON.
  • cv://profileDas Karriereprofil des Benutzers und sein Kontingentstatus.

Protokollversionen

2025-11-252025-06-182025-03-262024-11-05

Der Server handelt bei initialize die neueste Version aus, die beide Seiten unterstützen. Strukturierte Tool-Ausgaben brauchen 2025-11-25 oder 2025-06-18.

Fehler

Tool-Fehler tragen einen code. Diese sollte ein Agent behandeln:

CodeHTTPWas tun
auth_required401Anmeldung nötig (JSON-RPC-Fehler -32001, data.reason). Ohne Konto funktionieren nur die öffentlichen Tools. Der Header WWW-Authenticate startet OAuth; danach in derselben Sitzung wiederholen.
unauthorized401Das Bearer-Token fehlt oder ist ungültig auf einer Route, die eines verlangt, etwa der REST-API. Ein gültiges Token senden.
quota_exceeded402Das Kontingent des Tarifs ist aufgebraucht. Den Benutzer informieren.
model_not_available403Der Tarif erlaubt dieses model nicht. ai_settings.models lesen.
request_in_progress409Der erste Aufruf läuft noch. retry_after_seconds warten, mit derselben request_id wiederholen.
request_id_conflict409Diese request_id wurde für eine andere Aktion verwendet. Eine neue nehmen.
profile_revision_conflict409Das Profil hat sich geändert. get_profile erneut lesen, dann wiederholen.
resume_pdf_not_ready409Das PDF wird noch kompiliert. retry_after_seconds warten, dann erneut aufrufen.
rate_limited429Zu viele Anfragen in einer Minute: pro Token, pro Nutzer, pro Gastsitzung oder zu viele Dokument-Kompilierungen. retry_after_seconds abwarten, falls angegeben, dann wiederholen. Ohne Konto ist das Limit niedriger; die Anmeldung hebt es an.