Référence
Connecteur MCP
Connectez DoxAI à Claude, ChatGPT ou tout client MCP distant, puis laissez-le appeler les outils ci-dessous.
Connecter DoxAI à Claude
Le connecteur DoxAI est un serveur MCP distant. Son URL est indiquée ci-dessous ; la même URL fonctionne avec ChatGPT et tout autre client MCP distant.
- Ajoutez un connecteur personnalisé et nommez-le DoxAI.
- Collez l’URL du connecteur indiquée ci-dessous.
- Connectez-vous avec votre compte DoxAI quand Claude le demande. La connexion passe par OAuth : aucun token à copier.
https://app.doxai.ch/v1/mcpLa recherche d’offres (search_jobs, get_job, recommend_jobs avec cv_text) et les deux outils de référence app_get_info et resume_list_templates fonctionnent avant la connexion. Les autres outils demandent de se connecter lors de leur première utilisation.
ChatGPT et les autres clients MCP distants utilisent la même URL. Un client sans prise en charge d’OAuth peut utiliser un token API personnel avec le scope mcp:connect.
Le connecteur fonctionne avec l’offre Gratuit, avec les mêmes limites que l’app web DoxAI. Plus et Pro relèvent le quota.
Sans OAuth
Créez un token API personnel avec le scope mcp:connect sur la page de votre compte et envoyez-le comme Bearer token :
{
"url": "https://app.doxai.ch/v1/mcp",
"headers": { "Authorization": "Bearer <token with mcp:connect>" }
}Comment fonctionnent les outils
- Enchaînement type
get_profilepour lire le profil, puisquick_applyavec l’URL ou le texte d’une annonce : il capture, évalue et rédige la candidature en un seul appel. Pour examiner d’abord l’adéquation, procédez par étapes :create_opportunity→analyze_opportunity→create_application→generate_application. Ensuiteget_application_cv_pdfpour le lien du CV,generate_letterpour rédiger ou refaire la lettre,get_application_letterpour son lien, etupdate_application_statusune fois la candidature envoyée par l’utilisateur.- Appels décomptés du quota
analyze_opportunity,generate_application,generate_letteretquick_applysont décomptés du quota de l’offre et demandent unrequest_idstable. Un nouvel essai avec le mêmerequest_idrenvoie le résultat enregistré et n’est jamais décompté une seconde fois. Les lectures, les modifications du profil, la recherche d’offres et la compilation PDF sont gratuites.- Offre et quota
account_get_billing_statusrenvoie l’offre (free, plus ou pro), le quota en pourcentage utilisé (fenêtres du jour et de la semaine pour Plus et Pro, nombre d’actions restantes pour Gratuit) etai_settings: le modèle épinglé, l’effort par défaut et les modèles que l’offre permet d’utiliser.- Choisir un modèle
quick_applyetgenerate_applicationacceptent unmodelfacultatif (un id deai_settings.models) pour cet appel seulement, avec Plus et Pro. L’offre Gratuit reçoitmodel_not_available. Leurs résultats contiennent un champmodelqui nomme le modèle ayant rédigé le CV.- Appels longs
quick_applyetgenerate_applicationdurent plusieurs minutes. Ils signalent leur avancement étape par étape quand le client envoie unprogressToken, et ils restent sous la limite de durée d’un appel d’outil du client : les étapes facultatives (recherche sur l’entreprise, relecture, révision, corrections de mise en page) peuvent être écourtées et sont alors listées danscutForTime(quick_apply) oucut_for_time(generate_application). Après un délai dépassé, relancez avec le mêmerequest_idpour obtenir le résultat enregistré.- Des brouillons seulement
- DoxAI rédige les documents de candidature et ne les envoie ni ne les soumet jamais : l’utilisateur les relit et postule lui-même. Le contenu généré n’utilise que des faits du profil de l’utilisateur.
Outils
33 outils, regroupés par usage. Appelez tools/list pour les schémas complets d’entrée et de sortie.
Offres d’emploi
3 outilsChercher et classer des offres de toute la Suisse.
search_jobsSearch Job AdsCherche des offres de toute la Suisse par mots-clés, canton, taux d’activité et date.
LectureSans connexionget_jobGet Job AdLit une offre en entier, à partir de l’id renvoyé par search_jobs ou recommend_jobs.
LectureSans connexionrecommend_jobsRecommend Job Ads for a CV or the ProfileClasse les offres selon le profil, ou selon le texte d’un CV collé (non enregistré).
LectureSans connexion avec cv_text
Profil
3 outilsLire et modifier le profil dont part chaque document.
get_profileGet DoxAI Career ProfileLit le profil, sa révision et l’état du quota.
Lectureupdate_profileUpdate DoxAI Career ProfileModifie des champs du profil ; passez la révision lue juste avant comme base_revision.
Écriturepatch_profile_entriesEdit DoxAI Profile Entries by IDAjoute, modifie ou supprime des entrées du profil par id, en un seul lot.
Écriture
Annonces et analyse
4 outilsEnregistrer des annonces et les évaluer par rapport au profil.
list_opportunitiesList Job OpportunitiesListe les annonces enregistrées, les plus récentes d’abord.
Lectureget_opportunityGet Job OpportunityLit une annonce enregistrée avec son analyse.
Lecturecreate_opportunityCapture Job OpportunityEnregistre une annonce depuis son URL, son texte ou l’id d’une offre.
Écritureanalyze_opportunityAnalyze Job OpportunityÉvalue une annonce par rapport au profil et enregistre l’analyse.
ÉcritureQuota
CV et lettre adaptés
8 outilsRédiger, relire et suivre une candidature par annonce.
quick_applyTailor a CV for a Job PostingD’une annonce à un CV relu, avec sa lettre, en un seul appel.
ÉcritureQuotacreate_applicationOpen ApplicationOuvre une candidature pour une annonce enregistrée.
Écrituregenerate_applicationGenerate Tailored ApplicationRédige le CV adapté et la lettre d’une candidature, puis les relit.
ÉcritureQuotagenerate_letterDraft Cover LetterRédige ou refait la lettre de motivation d’une candidature.
ÉcritureQuotalist_applicationsList ApplicationsListe les candidatures et leur statut, les dernières modifiées d’abord.
Lectureget_applicationGet ApplicationLit une candidature : statut, lettre, notes et points de relecture.
Lectureresolve_review_pointsAnswer Review PointsEnregistre la réponse de l’utilisateur à chaque point de relecture : garder, atténuer ou retirer.
Écritureupdate_application_statusUpdate Application StatusEnregistre où en est une candidature, une fois que l’utilisateur a agi.
Écriture
Documents et PDF
13 outilsCompiler CV et lettres en PDF, gérer les CV enregistrés.
get_application_cv_pdfGet Application CV PDFCompile le CV de la candidature en PDF et renvoie un lien de téléchargement.
Écritureget_application_letterGet Application Cover LetterExporte la lettre en PDF ou en .docx et renvoie un lien de téléchargement.
Écritureresume_list_templatesList Resume TemplatesListe les modèles de CV, couleurs, polices et tailles.
LectureSans connexionresume_get_create_job_exampleGet Resume Job ExampleRenvoie un exemple canonique de cv_data comme point de départ.
Lectureresume_validate_cv_dataValidate Resume DataVérifie cv_data et liste ce qu’il faut corriger, sans compiler.
Lectureresume_create_jobCreate Resume PDF JobLance une compilation PDF à partir de cv_data.
Écritureresume_get_jobGet Resume PDF JobLit l’état d’une compilation et, une fois réussie, le lien du PDF.
Lectureresume_get_pdfGet Resume PDF DownloadRenvoie un lien de courte durée vers le PDF d’une compilation terminée.
Lectureresume_list_jobsList Resume PDF JobsListe les compilations, les plus récentes d’abord.
Lecturecv_list_resumesList ResumesListe les CV enregistrés, les plus récents d’abord.
Lecturecv_get_resumeGet ResumeLit un CV enregistré.
Lecturecv_create_resumeCreate ResumeEnregistre un nouveau CV à partir d’un instantané canonique.
Écriturecv_update_resumeUpdate ResumeRemplace le contenu d’un CV enregistré, ou change son modèle ou son statut.
Écriture
Offre et quota
2 outilsLire l’offre, le quota restant et les infos du serveur.
account_get_billing_statusGet Plan and QuotaLit l’offre, le quota en pourcentage et ai_settings.
Lectureapp_get_infoGet DoxAI InformationLit les métadonnées publiques du serveur : version, endpoints et modèles.
LectureSans connexion
Ressources
Les lectures de ressources sont limitées à l’utilisateur connecté. resources/list renvoie les URI des CV enregistrés.
cv://templatesLe catalogue des modèles de CV. Lisible sans compte.cv://resumesIndex des CV enregistrés de l’utilisateur.cv://resumes/{id}Un CV enregistré, en JSON.cv://profileLe profil de l’utilisateur et l’état de son quota.
Versions du protocole
2025-11-252025-06-182025-03-262024-11-05Le serveur négocie lors de initialize la version la plus récente prise en charge des deux côtés. La sortie structurée des outils demande 2025-11-25 ou 2025-06-18.
Erreurs
Les erreurs d’outil portent un code. Celles qu’un agent doit traiter :
| Code | HTTP | Que faire |
|---|---|---|
auth_required | 401 | Connexion nécessaire (erreur JSON-RPC -32001, data.reason). Sans compte, seuls les outils publics fonctionnent. L’en-tête WWW-Authenticate lance OAuth ; relancez dans la même session. |
unauthorized | 401 | Le jeton bearer est absent ou invalide sur une route qui en demande un, comme l’API REST. Envoyez un jeton valide. |
quota_exceeded | 402 | Le quota de l’offre est épuisé. Prévenez l’utilisateur. |
model_not_available | 403 | L’offre ne permet pas ce model. Lisez ai_settings.models. |
request_in_progress | 409 | Le premier appel tourne encore. Attendez retry_after_seconds, relancez avec le même request_id. |
request_id_conflict | 409 | Ce request_id a servi à une autre action. Prenez-en un nouveau. |
profile_revision_conflict | 409 | Le profil a changé. Relisez get_profile avant de réessayer. |
resume_pdf_not_ready | 409 | Le PDF est en cours de compilation. Attendez retry_after_seconds, puis rappelez. |
rate_limited | 429 | Trop de requêtes en une minute : par jeton, par utilisateur, par session invité, ou trop de compilations de documents. Attendez retry_after_seconds s’il est donné, puis réessayez. Sans compte, la limite est plus basse ; se connecter la relève. |