DoxAI
SommaireConnecteur MCP

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.

  1. Ajoutez un connecteur personnalisé et nommez-le DoxAI.
  2. Collez l’URL du connecteur indiquée ci-dessous.
  3. Connectez-vous avec votre compte DoxAI quand Claude le demande. La connexion passe par OAuth : aucun token à copier.
https://app.doxai.ch/v1/mcp

La 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_profile pour lire le profil, puis quick_apply avec 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. Ensuite get_application_cv_pdf pour le lien du CV, generate_letter pour rédiger ou refaire la lettre, get_application_letter pour son lien, et update_application_status une fois la candidature envoyée par l’utilisateur.
Appels décomptés du quota
analyze_opportunity, generate_application, generate_letter et quick_apply sont décomptés du quota de l’offre et demandent un request_id stable. Un nouvel essai avec le même request_id renvoie 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_status renvoie 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) et ai_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_apply et generate_application acceptent un model facultatif (un id de ai_settings.models) pour cet appel seulement, avec Plus et Pro. L’offre Gratuit reçoit model_not_available. Leurs résultats contiennent un champ model qui nomme le modèle ayant rédigé le CV.
Appels longs
quick_apply et generate_application durent plusieurs minutes. Ils signalent leur avancement étape par étape quand le client envoie un progressToken, 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 dans cutForTime (quick_apply) ou cut_for_time (generate_application). Après un délai dépassé, relancez avec le même request_id pour 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 outils

Chercher et classer des offres de toute la Suisse.

  • search_jobsSearch Job Ads

    Cherche des offres de toute la Suisse par mots-clés, canton, taux d’activité et date.

    LectureSans connexion
  • get_jobGet Job Ad

    Lit une offre en entier, à partir de l’id renvoyé par search_jobs ou recommend_jobs.

    LectureSans connexion
  • recommend_jobsRecommend Job Ads for a CV or the Profile

    Classe les offres selon le profil, ou selon le texte d’un CV collé (non enregistré).

    LectureSans connexion avec cv_text

Profil

3 outils

Lire et modifier le profil dont part chaque document.

  • get_profileGet DoxAI Career Profile

    Lit le profil, sa révision et l’état du quota.

    Lecture
  • update_profileUpdate DoxAI Career Profile

    Modifie des champs du profil ; passez la révision lue juste avant comme base_revision.

    Écriture
  • patch_profile_entriesEdit DoxAI Profile Entries by ID

    Ajoute, modifie ou supprime des entrées du profil par id, en un seul lot.

    Écriture

Annonces et analyse

4 outils

Enregistrer des annonces et les évaluer par rapport au profil.

  • list_opportunitiesList Job Opportunities

    Liste les annonces enregistrées, les plus récentes d’abord.

    Lecture
  • get_opportunityGet Job Opportunity

    Lit une annonce enregistrée avec son analyse.

    Lecture
  • create_opportunityCapture Job Opportunity

    Enregistre une annonce depuis son URL, son texte ou l’id d’une offre.

    Écriture
  • analyze_opportunityAnalyze Job Opportunity

    Évalue une annonce par rapport au profil et enregistre l’analyse.

    ÉcritureQuota

CV et lettre adaptés

8 outils

Rédiger, relire et suivre une candidature par annonce.

  • quick_applyTailor a CV for a Job Posting

    D’une annonce à un CV relu, avec sa lettre, en un seul appel.

    ÉcritureQuota
  • create_applicationOpen Application

    Ouvre une candidature pour une annonce enregistrée.

    Écriture
  • generate_applicationGenerate Tailored Application

    Rédige le CV adapté et la lettre d’une candidature, puis les relit.

    ÉcritureQuota
  • generate_letterDraft Cover Letter

    Rédige ou refait la lettre de motivation d’une candidature.

    ÉcritureQuota
  • list_applicationsList Applications

    Liste les candidatures et leur statut, les dernières modifiées d’abord.

    Lecture
  • get_applicationGet Application

    Lit une candidature : statut, lettre, notes et points de relecture.

    Lecture
  • resolve_review_pointsAnswer Review Points

    Enregistre la réponse de l’utilisateur à chaque point de relecture : garder, atténuer ou retirer.

    Écriture
  • update_application_statusUpdate Application Status

    Enregistre où en est une candidature, une fois que l’utilisateur a agi.

    Écriture

Documents et PDF

13 outils

Compiler CV et lettres en PDF, gérer les CV enregistrés.

  • get_application_cv_pdfGet Application CV PDF

    Compile le CV de la candidature en PDF et renvoie un lien de téléchargement.

    Écriture
  • get_application_letterGet Application Cover Letter

    Exporte la lettre en PDF ou en .docx et renvoie un lien de téléchargement.

    Écriture
  • resume_list_templatesList Resume Templates

    Liste les modèles de CV, couleurs, polices et tailles.

    LectureSans connexion
  • resume_get_create_job_exampleGet Resume Job Example

    Renvoie un exemple canonique de cv_data comme point de départ.

    Lecture
  • resume_validate_cv_dataValidate Resume Data

    Vérifie cv_data et liste ce qu’il faut corriger, sans compiler.

    Lecture
  • resume_create_jobCreate Resume PDF Job

    Lance une compilation PDF à partir de cv_data.

    Écriture
  • resume_get_jobGet Resume PDF Job

    Lit l’état d’une compilation et, une fois réussie, le lien du PDF.

    Lecture
  • resume_get_pdfGet Resume PDF Download

    Renvoie un lien de courte durée vers le PDF d’une compilation terminée.

    Lecture
  • resume_list_jobsList Resume PDF Jobs

    Liste les compilations, les plus récentes d’abord.

    Lecture
  • cv_list_resumesList Resumes

    Liste les CV enregistrés, les plus récents d’abord.

    Lecture
  • cv_get_resumeGet Resume

    Lit un CV enregistré.

    Lecture
  • cv_create_resumeCreate Resume

    Enregistre un nouveau CV à partir d’un instantané canonique.

    Écriture
  • cv_update_resumeUpdate Resume

    Remplace le contenu d’un CV enregistré, ou change son modèle ou son statut.

    Écriture

Offre et quota

2 outils

Lire l’offre, le quota restant et les infos du serveur.

  • account_get_billing_statusGet Plan and Quota

    Lit l’offre, le quota en pourcentage et ai_settings.

    Lecture
  • app_get_infoGet DoxAI Information

    Lit 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-05

Le 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 :

CodeHTTPQue faire
auth_required401Connexion 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.
unauthorized401Le jeton bearer est absent ou invalide sur une route qui en demande un, comme l’API REST. Envoyez un jeton valide.
quota_exceeded402Le quota de l’offre est épuisé. Prévenez l’utilisateur.
model_not_available403L’offre ne permet pas ce model. Lisez ai_settings.models.
request_in_progress409Le premier appel tourne encore. Attendez retry_after_seconds, relancez avec le même request_id.
request_id_conflict409Ce request_id a servi à une autre action. Prenez-en un nouveau.
profile_revision_conflict409Le profil a changé. Relisez get_profile avant de réessayer.
resume_pdf_not_ready409Le PDF est en cours de compilation. Attendez retry_after_seconds, puis rappelez.
rate_limited429Trop 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.