Le serveur MCP de Virtual CV
Mis à jour
Le serveur MCP de Virtual CV permet à l’assistant IA d’une personne en recherche d’emploi (ChatGPT, Claude, Claude Code) de travailler avec son Virtual CV : lire et modifier ses CV, lire les offres que Virtual CV a trouvées pour elle, tenir à jour son suivi de candidatures, lire son dossier de candidature pour remplir un formulaire et l’aider à se préparer à partir de ses rapports d’entretiens d’entraînement. Il parle le Model Context Protocol à une seule adresse, se connecte quand la personne se connecte à Virtual CV depuis l’assistant, et ne dépense jamais de crédits, n’utilise pas l’IA de Wipperoz, ne postule pour personne et n’accède pas aux données d’autres personnes.
Se connecter
Le serveur est https://api.wipperoz.com/v1/cv/mcp. Il utilise Streamable HTTP et ne garde aucune session : chaque requête est un POST qui reçoit sa propre réponse en JSON, et toute autre méthode reçoit 405 avec Allow: POST.
ChatGPT
ChatGPT se connecte en faisant s’identifier la personne. Ajoutez une application personnalisée (connecteur), qui nécessite le mode développeur avec un forfait payant, avec l’adresse du serveur https://api.wipperoz.com/v1/cv/mcp et OAuth comme authentification, puis connectez-la : ChatGPT ouvre Virtual CV, où la personne s’identifie et l’autorise. Ce qu’elle y choisit est décrit plus bas, dans Se connecter depuis un assistant.
Claude (claude.ai, Claude Desktop et les applications mobiles)
Ajoutez un connecteur personnalisé avec l’adresse du serveur https://api.wipperoz.com/v1/cv/mcp et connectez-le : Claude ouvre Virtual CV, où la personne s’identifie et l’autorise. Aucune clé n’est à définir : Virtual CV se connecte uniquement par identification.
Claude Code et les autres clients
Tout client qui se connecte aux serveurs MCP distants avec OAuth se connecte de la même façon. Dans Claude Code, ajoutez le serveur, puis authentifiez-le depuis /mcp :
claude mcp add --transport http virtual-cv https://api.wipperoz.com/v1/cv/mcp
Un client qui s’identifie par une adresse locale (http://127.0.0.1) affiche, sur la page de consentement, un avertissement : n’importe quel programme de cet ordinateur peut utiliser son nom.
Gemini n’est pas encore pris en charge.
Se connecter depuis un assistant
Les personnes se connectent uniquement avec OAuth 2.1 ; Virtual CV n’a pas de clés d’API. L’assistant trouve où se connecter à partir de la seule adresse du serveur : une requête sans identification reçoit 401 avec WWW-Authenticate: Bearer realm="virtual-cv", resource_metadata="https://api.wipperoz.com/.well-known/oauth-protected-resource/v1/cv/mcp", scope="cv:read cv:write jobs:read applications:write kit:read practice:read". Ce document nomme le serveur d’autorisation, https://api.wipperoz.com, et liste les six mêmes portées dans scopes_supported. L’identification suit le flux du code d’autorisation avec PKCE (S256), pour la ressource https://api.wipperoz.com/v1/cv/mcp ; un client se fait connaître par un document de métadonnées client ou s’enregistre dynamiquement. Une demande qui ne nomme aucune portée les demande toutes les six, et la personne les restreint ; les noms que le serveur n’accorde pas sont ignorés.
Si la personne n’a pas de session ouverte sur Virtual CV, elle s’identifie d’abord, avec un mot de passe ou avec Google, et revient sur la même page. Virtual CV lui montre le nom de l’assistant, le compte pour lequel il travaillera (le sien, par son adresse e-mail) et l’adresse vers laquelle il la renvoie, et elle coche ce qu’il peut faire, au moins une autorisation :
| Autorisation | Portée | Outils |
|---|---|---|
| Voir vos CV | cv:read |
list_cvs, get_cv |
| Créer et modifier vos CV | cv:write |
create_cv, update_cv_section, duplicate_cv |
| Voir les offres que Virtual CV a trouvées pour vous | jobs:read |
list_job_matches, get_job |
| Enregistrer et mettre à jour vos candidatures | applications:write |
save_job, log_application, update_application, list_applications |
| Lire votre dossier de candidature | kit:read |
get_application_kit |
| Voir vos rapports d’entretiens d’entraînement | practice:read |
list_practice_sessions, get_practice_report, start_practice |
Les portées sont indépendantes : aucune n’en inclut une autre, donc un assistant qui n’a que cv:write ne peut pas lire un CV. Une demande de consentement dure 10 minutes.
Seul un compte Virtual CV (celui d’une personne en recherche d’emploi) peut autoriser une connexion ici ; un compte Orbit est refusé. La connexion appartient à la personne qui l’a autorisée et n’atteint que ses propres données. Elle figure dans Virtual CV → Paramètres → Sécurité → Assistants connectés, avec ce qu’elle permet, sa date de connexion et sa dernière utilisation, et Déconnecter y refuse sa requête suivante. La fermeture du compte Virtual CV supprime toutes les connexions avec leurs codes et jetons, et l’export des données de la personne liste ses connexions (account/assistant-connections.json). Un client peut mettre fin à sa propre connexion avec le point de révocation des métadonnées du serveur d’autorisation (RFC 7009) : n’importe lequel de ses jetons met fin à toute la connexion. Les jetons d’accès durent une heure et les jetons d’actualisation sont renouvelés à chaque usage et durent 30 jours chacun : un assistant qui reste 30 jours sans utiliser Virtual CV doit se reconnecter.
Une connexion ne vaut que pour ce serveur. Une clé d’API ou une connexion Orbit est refusée ici, et une connexion Virtual CV est refusée par Orbit. jobs:read et applications:write sont aussi des noms de portées Orbit, mais le jobs:read d’un jeton Virtual CV lit les offres trouvées pour la personne elle-même et rien d’Orbit.
Les outils
| Outil | Ce qu’il fait | Portée |
|---|---|---|
list_cvs |
List CVs. Les CV de la personne, du dernier modifié au premier : cv_id, name, headline, status (draft, live ou offline), completeness, created_at, updated_at et url, avec total et max_cvs. |
cv:read |
get_cv |
Read a CV. Un CV (cv_id), section par section, avec ce qui est vérifié. |
cv:read |
create_cv |
Create a CV. Un nouveau CV privé à partir de name et d’au moins une section. Répond cv_id, name, created_at et url. |
cv:write |
update_cv_section |
Update a CV section. Remplace une section (section) d’un CV (cv_id) par content. Répond cv_id, section, changed, updated_at et url. |
cv:write |
duplicate_cv |
Duplicate a CV. Une copie privée d’un CV (cv_id) sous un nouveau nom (name), comme la fait l’application elle-même. Répond le nouveau cv_id, source_cv_id, name, created_at et url. |
cv:write |
list_job_matches |
List job matches. Les offres que Virtual CV a déjà trouvées pour la personne, comme les affiche sa page Offres : les invitations des employeurs d’abord, puis la meilleure correspondance. Chacune a job_id, cv_id, title, company, location, fit (de 0 à 100), posted_at, source, invited, link et la raison de la correspondance. cv_id limite à un CV ; limit vaut 20 par défaut, 50 au plus. |
jobs:read |
get_job |
Read a job match. Une offre (job_id, et cv_id ou le CV de la personne qui correspond le mieux) en entier : la description, les compétences du poste, les compétences présentes et manquantes, les points forts, les lacunes, l’analyse de l’IA quand il y en a une, et l’invitation d’un employeur. |
jobs:read |
save_job |
Save a job. Ajoute une offre au suivi comme saved : title, company et, au besoin, url, site et location. Répond application_id. |
applications:write |
log_application |
Log an application. Consigne que la personne a postulé à une offre enregistrée (application_id) avec l’un de ses CV (cv_id), le jour applied_on (aujourd’hui s’il est omis). Répond status, applied_on, tracked_link et tracked_link_live. |
applications:write |
update_application |
Update an application. Définit status (applied, interviewing, offer, rejected ou withdrawn) et, au besoin, note, jusqu’à 500 caractères ("" l’efface). |
applications:write |
list_applications |
List applications. Le suivi, du plus récent au plus ancien, jusqu’à 100 (total indique combien il y en a) : le status, cv_id, applied_on, note, tracked_link et link_activity (opens, first_opened_at, last_opened_at) de chaque entrée, et les candidatures envoyées sur Wipperoz. |
applications:write |
get_application_kit |
Get the application kit. Ce que demandent les formulaires de candidature, à partir du Virtual CV de la personne : nom, coordonnées, liens, parcours, formation, compétences, certifications et langues, chacun marqué vérifié ou non, ses réponses enregistrées, des liens de 10 minutes vers le PDF de son CV et vers une lettre de motivation pour company, et le lien de suivi d’une candidature. |
kit:read |
list_practice_sessions |
List practice sessions. Les entretiens d’entraînement de la personne, du plus récent au plus ancien (jusqu’à 50 ; has_more indique qu’il y en a de plus anciens) : session_id, dates, statut, le poste travaillé, le type et la durée de l’entretien, le style, la langue, le CV utilisé, et le statut du rapport avec son résultat global. |
practice:read |
get_practice_report |
Read a practice report. Un rapport (session_id), en texte seulement, tel que la page du rapport l’affiche : points forts, priorités, chaque question telle qu’elle a été posée avec les réponses de la personne et leur évaluation, les nouvelles tentatives, et l’élocution (débit, pauses, mots de remplissage). report_not_ready tant qu’il est en préparation. |
practice:read |
start_practice |
Open Interview Practice. Un lien qui ouvre l’entraînement dans Virtual CV avec un poste déjà indiqué : l’une de ses offres (job_id, qui demande aussi jobs:read) ou un title, avec company et job_link si elle les a. Il ne lance rien : la personne choisit l’entretien et le lance dans Virtual CV. |
practice:read |
Chaque outil porte son titre (en anglais, tel que l’assistant l’affiche) et ses annotations MCP, et tools/list nomme les quinze (les trois d’entraînement aux entretiens seulement tant qu’ils sont proposés) ; un outil dont la connexion ne porte pas la portée répond forbidden_scope. Les neuf qui ne font que lire (list_cvs, get_cv, list_job_matches, get_job, list_applications, get_application_kit, list_practice_sessions, get_practice_report et start_practice) portent readOnlyHint: true. create_cv, duplicate_cv et save_job écrivent sans rien remplacer (destructiveHint: false). update_cv_section, update_application et log_application peuvent remplacer ce qui existait (enregistrer de nouveau une candidature remplace son CV et sa date) : ils portent donc destructiveHint: true et idempotentHint: true. Les entrées sont strictes : un argument inconnu est refusé avant que l’outil ne s’exécute. url ouvre le CV dans l’éditeur de Virtual CV.
Un Virtual CV est en ligne : quand le CV est publié, update_cv_section modifie immédiatement sa page publique. La description de l’outil demande à l’assistant de confirmer avec la personne avant de remplacer une section.
Sections
Les sections (sections) d’un CV sont fixes. Dans update_cv_section, content est la section entière : un objet pour personal et summary, une liste pour les autres. Ce qui est omis est effacé, sauf ce qui est en lecture seule, qui est conservé.
| Section | Contenu |
|---|---|
personal |
headline, first_name, last_name, email, phone, location, right_to_work ; identity_verified est en lecture seule |
summary |
summary, short_summary, highlights |
experience |
postes : title, company, location, start_date, end_date, current, description, jusqu’à trois metrics (value, label) ; skills_used, verified et verified_by sont en lecture seule |
education |
institution, degree, field, location, start_date, end_date, current, description |
skills |
name, category, group ; level est calculé par Virtual CV et en lecture seule |
languages |
name, proficiency |
awards |
prix et certifications : name, category, date, issuer, description, credential_id, credential_url, expiry_date ; verified est en lecture seule |
projects |
name, category, contribution, blurb, description, location, start_date, end_date, current, metric |
interests |
une liste de mots |
social_links |
platform, url, username, visible |
references |
name uniquement, en lecture seule : les coordonnées des références ne sont jamais renvoyées et ne peuvent pas être écrites |
create_cv accepte les mêmes sections sauf references. Il n’accepte que des données structurées : aucun argument de fichier, de document ou d’URL de fichier, et il n’importe, ne traduit ni n’adapte jamais rien.
Ce qui est vérifié est en lecture seule
Une partie d’un CV peut être vérifiée : un poste chez un employeur que la personne a vérifié avec son e-mail professionnel, un poste qui a reçu une recommandation, un prix qui correspond à une certification vérifiée avec Credly ou Microsoft Learn et, une fois son identité vérifiée, ses prénom et nom. get_cv signale chacun d’eux (verified, verified_by, identity_verified).
- Une entrée vérifiée doit revenir inchangée dans
content, à n’importe quelle position. Modifiée ou absente, la mise à jour est refusée avecverified_read_only. - Avec une identité vérifiée,
first_nameetlast_namesont conservés s’ils sont omis, et refusés s’ils sont différents. - Rien de ce qui est écrit par MCP n’est marqué comme vérifié. Une écriture dont le résultat afficherait une marque de vérification (un nouveau poste chez l’employeur vérifié, un prix qui correspond à une certification vérifiée, un nom sur un nouveau CV une fois l’identité vérifiée) est refusée avec
verification_not_allowed.duplicate_cvcopie les entrées vérifiées comme le fait l’application, et elles restent en lecture seule sur la copie.
Offres correspondantes
list_job_matches et get_job lisent les correspondances que Virtual CV a déjà établies pour la personne, comme les affiche sa page Offres, et seulement les actuelles : une autre offre est not_found. Aucun des deux ne lance de recherche de correspondances, ne cherche d’autres offres, ne lit de solde ni n’appelle de modèle. link est l’endroit où la personne postule : la page de candidature d’un poste Orbit sur www.wipperoz.com, ou l’annonce d’origine. Aucun outil ne postule. Pour adapter un CV à une offre, un assistant duplique le CV qui correspond (duplicate_cv) et modifie la copie avec les informations de la personne elle-même (update_cv_section).
Le suivi des candidatures
save_job, log_application, update_application et list_applications écrivent et lisent les entrées qu’affiche la page Candidatures de la personne, immédiatement, avec les mêmes contrôles que la page.
- Une offre est un
titleet unecompany(jusqu’à 200 caractères chacun) et, au besoin, uneurl(https, jusqu’à 2 048 ; un paramètre qui ressemble à une connexion, comme un jeton, un code, une clé ou une session, ou qui contient une adresse e-mail, est retiré avant l’enregistrement), lesite(jusqu’à 100 ; déduit du lien s’il est omis) et unelocation(jusqu’à 200). Jamais le texte de l’annonce ni la conversation. log_applicationfait d’une offre enregistrée une candidature (applied; une candidature déjà plus avancée garde son statut), datée deapplied_onou d’aujourd’hui, et lui donne untracked_linkla première fois qu’elle a un CV :https://wprz.me/suivi d’un code propre à cette candidature. Le lien ouvre la page publique du CV, et seulement tant que ce CV est publié (tracked_link_live) ; sinon,tracked_link_notele précise.- Une ouverture est comptée une fois par visiteur et par jour UTC, dans le suivi uniquement : elle n’est jamais enregistrée comme une vue du CV. Une requête
HEAD, un préchargement ou un prérendu du navigateur, et une requête sans user agent ou avec celui d’un aperçu de liens ou d’un analyseur d’e-mails ne sont jamais comptés. Une ouverture signifie que quelqu’un a ouvert le lien, pas que l’employeur a lu le CV. La personne reçoit une notification et un e-mail à la première ouverture, puis au plus un par jour pour chaque lien, sauf si elle les désactive. - Les statuts sont
saved,applied,interviewing,offer,rejectedetwithdrawn. - Les candidatures envoyées sur Wipperoz, à un poste Orbit, sont listées avec
source: "orbit",read_only: trueetstatus: "applied". C’est l’employeur qui les fait avancer :log_applicationetupdate_applicationrépondent doncread_onlypour l’une d’elles. - Aucun outil ne supprime d’entrée. Une personne peut avoir jusqu’à 2 000 entrées ; au-delà,
save_jobrépondapplication_limit.
Le dossier de candidature
get_application_kit renvoie les coordonnées de la personne, son adresse e-mail et son numéro de téléphone, comme les formulaires les demandent, et uniquement à son propre assistant. get_cv les montre aussi, dans la section personal.
- Quel CV :
cv_ids’il est indiqué ; sinon le CV de la candidature (application_id) ; sinon le CV publié le plus récent, ou à défaut le plus récent.cv.chosen_becauseindique lequel (requested,applicationoudefault). - Quelle lettre de motivation : une lettre de ce CV écrite pour
company, s’il y en a une. - Fichiers : le PDF du CV et la lettre de motivation, chacun avec un
status:ready,out_of_date(le CV ou la lettre a changé après la création du PDF ; le lien reste) ounot_generated(pas de lien : la personne le télécharge une fois dans l’application). Les liens durent 10 minutes (expires_at). - La candidature : avec
application_id, son intitulé, son entreprise, son statut et son lien de suivi, pour que l’assistant donne à l’employeur le lien de suivi plutôt que le lien habituel.
Il lit et n’écrit jamais : aucun outil n’enregistre de réponse. Sa description demande à l’assistant de remplir un formulaire uniquement à partir du dossier, de ne jamais rien inventer, de laisser à la personne toute question démographique ou juridique (origine ethnique, genre, handicap, âge, religion, santé, casier judiciaire) et de ne jamais envoyer le formulaire ni passer à l’étape suivante sans son accord.
Rapports d’entretiens d’entraînement
list_practice_sessions et get_practice_report lisent, en texte, les entretiens d’entraînement et les rapports de la personne elle-même. Ils ne renvoient jamais d’enregistrement, d’audio ou de vidéo, ni l’entraînement d’une autre personne. start_practice ne fait que créer un lien : il ne crée aucune session et ne facture rien. La personne vérifie le poste, choisit l’entretien et le lance dans Virtual CV, où il est enregistré et son rapport rédigé. Les trois outils ne sont listés que tant que l’entraînement est proposé aux assistants. Confidentialité et enregistrements des entretiens d’entraînement indique qui voit quoi.
Erreurs
Un outil qui ne fait pas ce qui lui est demandé répond par une erreur d’outil, isError: true, et error.code avec une phrase que l’assistant peut relayer :
forbidden_scope: la connexion ne porte pas la portée dont l’outil a besoin ;error.scopela nomme.not_found: cette personne n’a pas ce CV, cette offre, cette candidature ou cet entretien d’entraînement. Ceux d’une autre personne sont aussinot_found.invalid_input: un argument ne convient pas ;error.fieldle nomme.verified_read_only: la mise à jour a modifié ou omis quelque chose de vérifié ;error.sectioneterror.itemsprécisent quoi.verification_not_allowed: l’écriture aurait affiché une marque de vérification sur un contenu écrit par l’assistant ;error.itemsprécise lequel.cv_limit: la personne a déjàerror.max_cvsCV.read_only: la candidature a été envoyée sur Wipperoz, et seul l’employeur la fait avancer.application_limit: la personne suit déjàerror.maxcandidatures.report_not_ready: le rapport d’entraînement est encore en préparation ; réessayez dans quelques minutes.internal_error: rien n’a été modifié ; réessayez.
La couche HTTP répond par une erreur JSON-RPC :
| Statut | error.code |
Quand |
|---|---|---|
401 |
-32001 |
Aucune connexion Virtual CV, une connexion déconnectée ou expirée, ou une clé Orbit. WWW-Authenticate indique où se connecter. |
405 |
-32000 |
Une méthode autre que POST. |
429 |
-32029 |
Une limite est dépassée (voir plus bas). error.data contient window, limit, resets_at et retry_after_seconds. |
400 |
-32700 |
Le corps n’est pas du JSON. |
500 |
-32603 |
Le serveur n’a pas pu répondre. |
Limites
Chaque personne dispose, par défaut, de :
- 60 requêtes par minute. Chaque requête compte pour une, sauf un appel d’outil, qui compte comme indiqué ci-dessous.
- 500 unités par jour, comptées uniquement sur les appels d’outils : une lecture compte pour une et une écriture pour deux. Les écritures sont
create_cv,update_cv_section,duplicate_cv,save_job,log_applicationetupdate_application. La journée est remise à zéro à 00:00 UTC. - 10 CV :
create_cvetduplicate_cvsont refusés aveccv_limitdès que la personne en a autant.
Au-delà d’une limite, le serveur répond 429 avec X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset et Retry-After, et le message indique quand elle est remise à zéro. Un appel refusé au titre de la limite quotidienne ne compte pas.
Ce qu’il ne fait jamais
- Dépenser des crédits. Tous les outils sont gratuits : aucun ne lit un solde, ne facture ni n’appelle un modèle.
- Postuler pour quelqu’un. Aucun outil n’envoie de candidature ni ne contacte un employeur : c’est la personne qui ouvre les liens.
- Supprimer ou publier. Aucun outil ne supprime de CV ou de candidature, ni ne publie un CV ou le met hors ligne.
- Importer un fichier. Un PDF s’importe dans l’application Virtual CV, où l’IA de Wipperoz le lit.
- Partager les données d’autres personnes. Aucun outil ne renvoie les coordonnées des références, les auteurs des recommandations, le CV ou les candidatures d’une autre personne ni d’identifiant interne autre que
cv_id,job_idetapplication_id. - Atteindre une autre personne. Chaque outil travaille sur les données de la personne qui s’est connectée.