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.
- Füge einen benutzerdefinierten Connector hinzu und nenne ihn DoxAI.
- Füge die unten angegebene Connector-URL ein.
- 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/mcpDie 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, dannquick_applymit 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. Danachget_application_cv_pdffür den Link zum Lebenslauf,generate_letter, um das Anschreiben zu entwerfen oder neu zu entwerfen,get_application_letterfür dessen Link undupdate_application_status, sobald der Benutzer die Bewerbung abgeschickt hat.- Aufrufe, die das Kontingent belasten
analyze_opportunity,generate_application,generate_letterundquick_applywerden dem Kontingent des Tarifs belastet und brauchen eine stabilerequest_id. Ein erneuter Versuch mit derselbenrequest_idliefert 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_statusliefert den Tarif (free, plus oder pro), das Kontingent als verbrauchten Prozentsatz (Tages- und Wochenfenster bei Plus und Pro, verbleibende Aktionen bei Kostenlos) undai_settings: das angeheftete Modell, den Standardaufwand und die Modelle, die der Tarif nutzen darf.- Modell wählen
quick_applyundgenerate_applicationakzeptieren ein optionalesmodel(eine ID ausai_settings.models) nur für diesen Aufruf, mit Plus und Pro. Der kostenlose Tarif erhältmodel_not_available. Ihre Ergebnisse enthalten ein Feldmodelmit dem Modell, das den Lebenslauf entworfen hat.- Lange Aufrufe
quick_applyundgenerate_applicationlaufen mehrere Minuten. Sie melden den Fortschritt Schritt für Schritt, wenn der Client einenprogressTokensendet, 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 incutForTime(quick_apply) beziehungsweisecut_for_time(generate_application). Nach einem Timeout genügt ein erneuter Versuch mit derselbenrequest_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 ToolsStellenanzeigen aus der ganzen Schweiz suchen und ordnen.
search_jobsSearch Job AdsSucht Stellenanzeigen aus der ganzen Schweiz nach Stichwörtern, Kanton, Pensum und Alter.
LesendOhne Anmeldungget_jobGet Job AdLiest eine Stellenanzeige vollständig, mit der ID aus search_jobs oder recommend_jobs.
LesendOhne Anmeldungrecommend_jobsRecommend Job Ads for a CV or the ProfileOrdnet Stellenanzeigen nach dem Profil oder nach einem eingefügten Lebenslauftext (nicht gespeichert).
LesendOhne Anmeldung mit cv_text
Profil
3 ToolsDas Karriereprofil lesen und bearbeiten, aus dem jedes Dokument entsteht.
get_profileGet DoxAI Career ProfileLiest das Karriereprofil, seine Revision und den Kontingentstatus.
Lesendupdate_profileUpdate DoxAI Career ProfileÄndert Profilfelder; übergib die gerade gelesene Revision als base_revision.
Schreibendpatch_profile_entriesEdit DoxAI Profile Entries by IDFügt Profileinträge per ID hinzu, ändert oder entfernt sie, in einem einzigen Stapel.
Schreibend
Anzeigen und Analyse
4 ToolsStellenanzeigen speichern und anhand des Profils bewerten.
list_opportunitiesList Job OpportunitiesListet die gespeicherten Stellenanzeigen, die neuesten zuerst.
Lesendget_opportunityGet Job OpportunityLiest eine gespeicherte Anzeige mit ihrer Analyse.
Lesendcreate_opportunityCapture Job OpportunitySpeichert eine Anzeige aus ihrer URL, ihrem Text oder einer Anzeigen-ID.
Schreibendanalyze_opportunityAnalyze Job OpportunityBewertet eine Anzeige anhand des Profils und speichert die Analyse.
SchreibendKontingent
Angepasster Lebenslauf und Anschreiben
8 ToolsEine Bewerbung pro Anzeige entwerfen, prüfen und verfolgen.
quick_applyTailor a CV for a Job PostingVon der Anzeige zum geprüften Lebenslauf mit Anschreiben, in einem Aufruf.
SchreibendKontingentcreate_applicationOpen ApplicationEröffnet eine Bewerbung für eine gespeicherte Anzeige.
Schreibendgenerate_applicationGenerate Tailored ApplicationEntwirft den angepassten Lebenslauf und das Anschreiben einer Bewerbung und prüft sie.
SchreibendKontingentgenerate_letterDraft Cover LetterEntwirft das Anschreiben einer Bewerbung oder entwirft es neu.
SchreibendKontingentlist_applicationsList ApplicationsListet die Bewerbungen mit ihrem Status, zuletzt geänderte zuerst.
Lesendget_applicationGet ApplicationLiest eine Bewerbung: Status, Anschreiben, Notizen und Prüfpunkte.
Lesendresolve_review_pointsAnswer Review PointsSpeichert die Antwort des Benutzers zu jedem Prüfpunkt: behalten, abschwächen oder streichen.
Schreibendupdate_application_statusUpdate Application StatusHält fest, wo eine Bewerbung steht, nachdem der Benutzer gehandelt hat.
Schreibend
Dokumente und PDF
13 ToolsLebensläufe und Anschreiben als PDF kompilieren, gespeicherte Lebensläufe verwalten.
get_application_cv_pdfGet Application CV PDFKompiliert den Lebenslauf der Bewerbung als PDF und liefert einen Download-Link.
Schreibendget_application_letterGet Application Cover LetterExportiert das Anschreiben als PDF oder .docx und liefert einen Download-Link.
Schreibendresume_list_templatesList Resume TemplatesListet Lebenslaufvorlagen, Farben, Schriften und Größen.
LesendOhne Anmeldungresume_get_create_job_exampleGet Resume Job ExampleLiefert ein kanonisches cv_data-Beispiel als Ausgangspunkt.
Lesendresume_validate_cv_dataValidate Resume DataPrüft cv_data und listet, was zu korrigieren ist, ohne zu kompilieren.
Lesendresume_create_jobCreate Resume PDF JobStartet einen PDF-Kompilierauftrag aus cv_data.
Schreibendresume_get_jobGet Resume PDF JobLiest den Status eines Auftrags und, sobald er erfolgreich war, den PDF-Link.
Lesendresume_get_pdfGet Resume PDF DownloadLiefert einen kurzlebigen Link zum PDF eines fertigen Auftrags.
Lesendresume_list_jobsList Resume PDF JobsListet die Kompilieraufträge, die neuesten zuerst.
Lesendcv_list_resumesList ResumesListet die gespeicherten Lebensläufe, die neuesten zuerst.
Lesendcv_get_resumeGet ResumeLiest einen gespeicherten Lebenslauf.
Lesendcv_create_resumeCreate ResumeSpeichert einen neuen Lebenslauf aus einem kanonischen Snapshot.
Schreibendcv_update_resumeUpdate ResumeErsetzt den Inhalt eines gespeicherten Lebenslaufs oder ändert Vorlage oder Status.
Schreibend
Tarif und Kontingent
2 ToolsTarif, verbleibendes Kontingent und Serverangaben lesen.
account_get_billing_statusGet Plan and QuotaLiest den Tarif, das Kontingent in Prozent und ai_settings.
Lesendapp_get_infoGet DoxAI InformationLiest ö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-05Der 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:
| Code | HTTP | Was tun |
|---|---|---|
auth_required | 401 | Anmeldung 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. |
unauthorized | 401 | Das Bearer-Token fehlt oder ist ungültig auf einer Route, die eines verlangt, etwa der REST-API. Ein gültiges Token senden. |
quota_exceeded | 402 | Das Kontingent des Tarifs ist aufgebraucht. Den Benutzer informieren. |
model_not_available | 403 | Der Tarif erlaubt dieses model nicht. ai_settings.models lesen. |
request_in_progress | 409 | Der erste Aufruf läuft noch. retry_after_seconds warten, mit derselben request_id wiederholen. |
request_id_conflict | 409 | Diese request_id wurde für eine andere Aktion verwendet. Eine neue nehmen. |
profile_revision_conflict | 409 | Das Profil hat sich geändert. get_profile erneut lesen, dann wiederholen. |
resume_pdf_not_ready | 409 | Das PDF wird noch kompiliert. retry_after_seconds warten, dann erneut aufrufen. |
rate_limited | 429 | Zu 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. |