El servidor MCP de Virtual CV
Actualizado
El servidor MCP de Virtual CV permite que el propio asistente de IA de una persona que busca empleo (ChatGPT, Claude, Claude Code) trabaje con su Virtual CV: leer y editar sus CVs, leer los empleos que Virtual CV encontró para ella, mantener al día su seguimiento de postulaciones, leer su kit de postulación para rellenar un formulario y ayudarla a prepararse con sus informes de entrevistas de práctica. Habla el Model Context Protocol en una sola dirección, se conecta cuando la persona inicia sesión en Virtual CV desde el asistente, y nunca gasta créditos, ni usa la IA de Wipperoz, ni se postula por nadie, ni accede a datos de otras personas.
Conectar
El servidor es https://api.wipperoz.com/v1/cv/mcp. Usa Streamable HTTP y no guarda sesión: cada petición es un POST que se responde por sí solo con JSON, y cualquier otro método se responde con 405 y Allow: POST.
ChatGPT
ChatGPT se conecta iniciando sesión. Añade una aplicación personalizada (conector), que necesita el modo de desarrollador en un plan de pago, con la dirección del servidor https://api.wipperoz.com/v1/cv/mcp y OAuth como autenticación, y conéctala: ChatGPT abre Virtual CV, donde la persona inicia sesión y le da permiso. Lo que elige ahí se explica en Iniciar sesión desde un asistente, más abajo.
Claude (claude.ai, Claude Desktop y las aplicaciones móviles)
Añade un conector personalizado con la dirección del servidor https://api.wipperoz.com/v1/cv/mcp y conéctalo: Claude abre Virtual CV, donde la persona inicia sesión y le da permiso. No hay ninguna clave que poner: Virtual CV solo se conecta iniciando sesión.
Claude Code y otros clientes
Cualquier cliente que inicie sesión en servidores MCP remotos con OAuth se conecta igual. En Claude Code, añade el servidor y luego autentícalo desde /mcp:
claude mcp add --transport http virtual-cv https://api.wipperoz.com/v1/cv/mcp
Un cliente que inicia sesión a través de una dirección local (http://127.0.0.1) recibe en la página de consentimiento un aviso de que cualquier programa de ese ordenador puede usar su nombre.
Gemini todavía no es compatible.
Iniciar sesión desde un asistente
Las personas se conectan solo con OAuth 2.1; Virtual CV no tiene claves de API. El asistente encuentra dónde iniciar sesión a partir de la dirección del servidor: una petición sin inicio de sesión se responde con 401 y 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". Ese documento nombra el servidor de autorización, https://api.wipperoz.com, y lista los mismos seis permisos en scopes_supported. El inicio de sesión es el flujo de código de autorización con PKCE (S256), para el recurso https://api.wipperoz.com/v1/cv/mcp; un cliente se identifica con un documento de metadatos de cliente o se registra dinámicamente. Una petición que no nombra ningún permiso pide los seis, y la persona los reduce; los nombres que el servidor no concede se descartan.
Si la persona no ha iniciado sesión en Virtual CV, primero lo hace, con contraseña o con Google, y vuelve a la misma página. Virtual CV le muestra el nombre del asistente, la cuenta para la que trabajará (la suya, por su correo electrónico) y la dirección a la que la devuelve, y marca qué puede hacer, al menos una opción:
| Permiso | Scope | Herramientas |
|---|---|---|
| Ver tus CVs | cv:read |
list_cvs, get_cv |
| Crear y editar tus CVs | cv:write |
create_cv, update_cv_section, duplicate_cv |
| Ver los empleos que Virtual CV encontró para ti | jobs:read |
list_job_matches, get_job |
| Registrar y actualizar tus postulaciones | applications:write |
save_job, log_application, update_application, list_applications |
| Leer tu kit de postulación | kit:read |
get_application_kit |
| Ver tus informes de entrevistas de práctica | practice:read |
list_practice_sessions, get_practice_report, start_practice |
Los permisos son independientes: ninguno incluye a otro, así que un asistente que solo tiene cv:write no puede leer un CV. Una solicitud de consentimiento dura 10 minutos.
Aquí solo una cuenta de Virtual CV (de una persona que busca empleo) puede permitir una conexión; una cuenta de Orbit se rechaza. La conexión es de la persona que la permitió y solo llega a sus propios datos. Aparece en Virtual CV → Configuración → Seguridad → Asistentes conectados, con lo que puede hacer, cuándo se conectó y cuándo se usó por última vez, y Desconectar ahí rechaza su siguiente petición. Al cerrar la cuenta de Virtual CV se eliminan todas las conexiones con sus códigos y tokens, y la exportación de datos de la persona lista sus conexiones (account/assistant-connections.json). Un cliente puede terminar su propia conexión con el endpoint de revocación de los metadatos del servidor de autorización (RFC 7009): cualquiera de sus tokens termina la conexión entera. Los tokens de acceso duran una hora y los de actualización rotan y duran 30 días cada uno, así que un asistente que pasa 30 días sin usar Virtual CV tiene que volver a iniciar sesión.
Una conexión sirve solo para este servidor. Aquí se rechaza una clave de API o una conexión de Orbit, y Orbit rechaza una conexión de Virtual CV. jobs:read y applications:write también son nombres de permisos de Orbit, pero el jobs:read de un token de Virtual CV lee los matches de la propia persona y nada de Orbit.
Las herramientas
| Herramienta | Qué hace | Permiso |
|---|---|---|
list_cvs |
List CVs. Los CVs de la persona, del último editado al primero: cv_id, name, headline, status (draft, live u offline), completeness, created_at, updated_at y url, con total y max_cvs. |
cv:read |
get_cv |
Read a CV. Un CV (cv_id), sección por sección, con lo que está verificado. |
cv:read |
create_cv |
Create a CV. Un CV privado nuevo a partir de name y al menos una sección. Responde cv_id, name, created_at y url. |
cv:write |
update_cv_section |
Update a CV section. Sustituye una sección (section) de un CV (cv_id) por content. Responde cv_id, section, changed, updated_at y url. |
cv:write |
duplicate_cv |
Duplicate a CV. Una copia privada de un CV (cv_id) con un nombre nuevo (name), como la hace la propia aplicación. Responde el nuevo cv_id, source_cv_id, name, created_at y url. |
cv:write |
list_job_matches |
List job matches. Los empleos que Virtual CV ya encontró para la persona, como los muestra su página Empleos: primero las invitaciones de empleadores y después el mejor encaje. Cada uno lleva job_id, cv_id, title, company, location, fit (de 0 a 100), posted_at, source, invited, link y por qué encaja. cv_id lo limita a un CV; limit es 20 por defecto y 50 como máximo. |
jobs:read |
get_job |
Read a job match. Un match (job_id, y cv_id o el CV de la persona que mejor encaja) completo: la descripción, las habilidades del puesto, las habilidades que cumple y las que faltan, las fortalezas, las carencias, el análisis de la IA cuando lo hay y la invitación de un empleador. |
jobs:read |
save_job |
Save a job. Añade un empleo al seguimiento como saved: title, company y, si se quiere, url, site y location. Responde application_id. |
applications:write |
log_application |
Log an application. Registra que la persona se postuló a un empleo guardado (application_id) con uno de sus CVs (cv_id), el día applied_on (hoy si se omite). Responde status, applied_on, tracked_link y tracked_link_live. |
applications:write |
update_application |
Update an application. Fija status (applied, interviewing, offer, rejected o withdrawn) y, si se quiere, note, de hasta 500 caracteres ("" la borra). |
applications:write |
list_applications |
List applications. El seguimiento, del más reciente al más antiguo, hasta 100 (total dice cuántos hay): el status, cv_id, applied_on, note, tracked_link y link_activity (opens, first_opened_at, last_opened_at) de cada entrada, y las postulaciones hechas en Wipperoz. |
applications:write |
get_application_kit |
Get the application kit. Lo que piden los formularios de postulación, sacado del Virtual CV de la persona: nombre, datos de contacto, enlaces, experiencia, formación, habilidades, certificaciones e idiomas, cada uno marcado como verificado o no, sus respuestas guardadas, enlaces de 10 minutos al PDF de su CV y a una carta de presentación para company, y el enlace de seguimiento de una postulación. |
kit:read |
list_practice_sessions |
List practice sessions. Las sesiones de entrevistas de práctica de la persona, de la más reciente a la más antigua (hasta 50; has_more indica que hay más antiguas): session_id, fechas, estado, el puesto practicado, tipo y duración de la entrevista, estilo, idioma, el CV usado y el estado del informe con su resultado general. |
practice:read |
get_practice_report |
Read a practice report. Un informe (session_id), solo texto, como lo muestra la página del informe: puntos fuertes, prioridades, cada pregunta tal como se hizo con las respuestas de la persona y su valoración, los reintentos y cómo habló (ritmo, pausas, muletillas). report_not_ready mientras se prepara. |
practice:read |
start_practice |
Open Interview Practice. Un enlace que abre la práctica en Virtual CV con un puesto ya indicado: uno de sus matches (job_id, que también necesita jobs:read) o un title, con company y job_link si los tiene. No empieza nada: la persona elige la entrevista y la empieza en Virtual CV. |
practice:read |
Cada herramienta lleva su título (en inglés, como lo muestra el asistente) y sus anotaciones MCP, y tools/list nombra las quince (las tres de entrevistas de práctica, solo mientras se ofrecen); una herramienta para la que la conexión no lleva el permiso responde forbidden_scope. Las nueve que solo leen (list_cvs, get_cv, list_job_matches, get_job, list_applications, get_application_kit, list_practice_sessions, get_practice_report y start_practice) llevan readOnlyHint: true. create_cv, duplicate_cv y save_job escriben sin sobrescribir nada (destructiveHint: false). update_cv_section, update_application y log_application pueden sustituir lo que había (registrar de nuevo una postulación sustituye su CV y su fecha), así que llevan destructiveHint: true e idempotentHint: true. Las entradas son estrictas: un argumento desconocido se rechaza antes de que la herramienta se ejecute. url abre el CV en el editor de Virtual CV.
Un Virtual CV está en vivo: si el CV está publicado, update_cv_section cambia su página pública al momento. La descripción de la herramienta pide al asistente que lo confirme con la persona antes de sobrescribir una sección.
Secciones
Las secciones (sections) de un CV son fijas. En update_cv_section, content es la sección entera: un objeto para personal y summary, y una lista para el resto. Lo que deja fuera se borra, salvo lo que es de solo lectura, que se conserva.
| Sección | Contiene |
|---|---|
personal |
headline, first_name, last_name, email, phone, location, right_to_work; identity_verified es de solo lectura |
summary |
summary, short_summary, highlights |
experience |
puestos: title, company, location, start_date, end_date, current, description, hasta tres metrics (value, label); skills_used, verified y verified_by son de solo lectura |
education |
institution, degree, field, location, start_date, end_date, current, description |
skills |
name, category, group; level lo calcula Virtual CV y es de solo lectura |
languages |
name, proficiency |
awards |
premios y certificaciones: name, category, date, issuer, description, credential_id, credential_url, expiry_date; verified es de solo lectura |
projects |
name, category, contribution, blurb, description, location, start_date, end_date, current, metric |
interests |
una lista de palabras |
social_links |
platform, url, username, visible |
references |
solo name, de solo lectura: los datos de contacto de las referencias nunca se devuelven y no se pueden escribir |
create_cv acepta las mismas secciones salvo references. Solo acepta datos estructurados: no tiene ningún argumento de archivo, documento ni URL de archivo, y nunca importa, traduce ni adapta.
Lo verificado es de solo lectura
Parte de un CV puede estar verificada: un puesto en un empleador que la persona verificó con su correo laboral, un puesto con un aval, un premio que coincide con una credencial verificada con Credly o Microsoft Learn y, cuando su identidad está verificada, su nombre y sus apellidos. get_cv marca cada uno (verified, verified_by, identity_verified).
- Una entrada verificada tiene que volver sin cambios en
content, en cualquier posición. Si cambia o falta, la actualización se rechaza converified_read_only. - Con la identidad verificada,
first_nameylast_namese conservan si se dejan fuera, y se rechazan si son distintos. - Nada de lo que se escribe por MCP recibe una insignia de verificado. Una escritura cuyo resultado mostraría una (un puesto nuevo en el empleador verificado, un premio que coincide con una credencial verificada, un nombre en un CV nuevo cuando la identidad está verificada) se rechaza con
verification_not_allowed.duplicate_cvcopia las entradas verificadas como lo hace la aplicación, y en la copia siguen siendo de solo lectura.
Matches de empleo
list_job_matches y get_job leen los matches que Virtual CV ya hizo para la persona, como los muestra su página Empleos, y solo los actuales: otro empleo es not_found. Ninguna busca matches nuevos, busca otros empleos, lee un saldo ni usa un modelo. link es donde la persona se postula: la página de postulación de un puesto de Orbit en www.wipperoz.com, o el anuncio original. Ninguna herramienta se postula. Para adaptar un CV a un empleo, un asistente duplica el CV con el que encajó (duplicate_cv) y cambia la copia con los datos de la propia persona (update_cv_section).
El seguimiento de postulaciones
save_job, log_application, update_application y list_applications escriben y leen las entradas que muestra la página Postulaciones de la persona, al momento, con las mismas comprobaciones que la página.
- Un empleo es un
titley unacompany(hasta 200 caracteres cada uno) y, si se quiere, unaurl(https, hasta 2.048; un parámetro que parece un inicio de sesión, como un token, un código, una clave o una sesión, o que lleva una dirección de correo, se quita antes de guardarla), elsite(hasta 100; se toma del enlace si se omite) y unalocation(hasta 200). Nunca el texto del anuncio ni la conversación. log_applicationconvierte un empleo guardado en una postulación (applied; una que ya va más adelante conserva su estado), con fechaapplied_ono la de hoy, y le da untracked_linkla primera vez que tiene un CV:https://wprz.me/y un código único para esa postulación. El enlace abre la página pública del CV, y solo mientras ese CV está publicado (tracked_link_live); si no lo está,tracked_link_notelo dice.- Una apertura se cuenta una vez por visitante y día UTC, solo en el seguimiento: nunca se registra como una vista del CV. Nunca se cuentan una petición
HEAD, una precarga o un prerenderizado del navegador, ni una petición sin user agent o con el de una vista previa de enlaces o un analizador de correo. Una apertura significa que alguien abrió el enlace, no que el empleador leyó el CV. La persona recibe una notificación y un correo en la primera apertura y, después, como mucho uno al día por enlace, salvo que los desactive. - Los estados son
saved,applied,interviewing,offer,rejectedywithdrawn. - Las postulaciones hechas en Wipperoz, a un puesto de Orbit, se listan con
source: "orbit",read_only: trueystatus: "applied". Las hace avanzar el empleador, así quelog_applicationyupdate_applicationrespondenread_onlypara una de ellas. - Ninguna herramienta elimina una entrada. Una persona puede tener hasta 2.000 entradas; por encima de eso,
save_jobrespondeapplication_limit.
El kit de postulación
get_application_kit devuelve los datos de contacto de la persona, su correo electrónico y su teléfono, tal como los piden los formularios, y solo a su propio asistente. get_cv también los muestra, en la sección personal.
- Qué CV:
cv_idsi se indica; si no, el CV de la postulación (application_id); si no, el CV publicado más reciente o, en su defecto, el más reciente.cv.chosen_becausedice cuál (requested,applicationodefault). - Qué carta de presentación: una de las cartas de ese CV escrita para
company, si la hay. - Archivos: el PDF del CV y la carta de presentación, cada uno con un
status:ready,out_of_date(el CV o la carta cambiaron después de generar el PDF; el enlace sigue) onot_generated(sin enlace: la persona lo descarga una vez en la aplicación). Los enlaces duran 10 minutos (expires_at). - La postulación: con
application_id, su puesto, su empresa, su estado y su enlace de seguimiento, para que el asistente dé al empleador el enlace de seguimiento en lugar del habitual.
Solo lee y nunca escribe: ninguna herramienta guarda una respuesta. Su descripción pide al asistente que rellene un formulario solo con el kit, que nunca invente, que deje a la persona cualquier pregunta demográfica o legal (origen étnico, género, discapacidad, edad, religión, salud, antecedentes penales) y que nunca envíe el formulario ni pase al paso siguiente si la persona no lo dice.
Informes de entrevistas de práctica
list_practice_sessions y get_practice_report leen, como texto, las sesiones y los informes de entrevistas de práctica de la propia persona. Nunca devuelven una grabación, audio ni vídeo, ni la práctica de otra persona. start_practice solo crea un enlace: no crea ninguna sesión ni cobra nada. La persona revisa el puesto, elige la entrevista y la empieza en Virtual CV, donde se graba y se escribe su informe. Las tres herramientas aparecen solo mientras la práctica se ofrece a los asistentes. Privacidad y grabaciones de las entrevistas de práctica explica quién ve qué.
Errores
Una herramienta que no hace lo que se le pide responde con un error de herramienta, isError: true, y error.code con una frase que el asistente puede transmitir:
forbidden_scope: la conexión no lleva el permiso que necesita la herramienta;error.scopelo nombra.not_found: esa persona no tiene ese CV, ese match, esa postulación o esa sesión de práctica. Lo de otra persona también esnot_found.invalid_input: un argumento no encaja;error.fieldlo nombra.verified_read_only: la actualización cambió o dejó fuera algo verificado;error.sectionyerror.itemsdicen qué.verification_not_allowed: la escritura habría mostrado una insignia de verificado en algo que escribió el asistente;error.itemsdice en qué.cv_limit: la persona ya tieneerror.max_cvsCVs.read_only: la postulación se hizo en Wipperoz y solo la hace avanzar el empleador.application_limit: la persona ya sigueerror.maxpostulaciones.report_not_ready: el informe de práctica aún se está preparando; vuelve a intentarlo en unos minutos.internal_error: no se cambió nada; vuelve a intentarlo.
La capa HTTP responde con un error JSON-RPC:
| Estado | error.code |
Cuándo |
|---|---|---|
401 |
-32001 |
No hay inicio de sesión de Virtual CV, o se desconectó o caducó, o es una clave de Orbit. WWW-Authenticate dice dónde iniciar sesión. |
405 |
-32000 |
Un método que no es POST. |
429 |
-32029 |
Se superó un límite (abajo). error.data lleva window, limit, resets_at y retry_after_seconds. |
400 |
-32700 |
El cuerpo no es JSON. |
500 |
-32603 |
El servidor no pudo responder. |
Límites
Cada persona tiene, por defecto:
- 60 peticiones por minuto. Cada petición cuenta una, salvo una llamada a una herramienta, que cuenta como se indica abajo.
- 500 unidades al día, contadas solo en llamadas a herramientas: una lectura cuenta una y una escritura dos. Las escrituras son
create_cv,update_cv_section,duplicate_cv,save_job,log_applicationyupdate_application. El día se reinicia a las 00:00 UTC. - 10 CVs:
create_cvyduplicate_cvse rechazan concv_limitcuando la persona ya tiene esa cantidad.
Por encima de un límite, el servidor responde 429 con X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset y Retry-After, y el mensaje dice cuándo se reinicia. Una llamada rechazada por el límite diario no cuenta.
Lo que nunca hace
- Gastar créditos. Todas las herramientas son gratis: ninguna lee un saldo, cobra ni usa un modelo.
- Postularse por nadie. Ninguna herramienta envía una postulación ni contacta con un empleador: los enlaces los abre la persona.
- Eliminar o publicar. Ninguna herramienta elimina un CV ni una postulación, ni publica un CV o lo pone fuera de línea.
- Importar un archivo. Un PDF se importa en la aplicación de Virtual CV, donde lo lee la IA de Wipperoz.
- Compartir datos de otras personas. Ninguna herramienta devuelve datos de contacto de referencias, quién dio un aval, el CV o las postulaciones de otra persona ni identificadores internos aparte de
cv_id,job_idyapplication_id. - Llegar a otra persona. Todas las herramientas trabajan con los datos de quien inició sesión.