Saltar al contenido principal
WipperozWipperoz
Explorar la documentación

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 con verified_read_only.
  • Con la identidad verificada, first_name y last_name se 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_cv copia 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 title y una company (hasta 200 caracteres cada uno) y, si se quiere, una url (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), el site (hasta 100; se toma del enlace si se omite) y una location (hasta 200). Nunca el texto del anuncio ni la conversación.
  • log_application convierte un empleo guardado en una postulación (applied; una que ya va más adelante conserva su estado), con fecha applied_on o la de hoy, y le da un tracked_link la 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_note lo 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, rejected y withdrawn.
  • Las postulaciones hechas en Wipperoz, a un puesto de Orbit, se listan con source: "orbit", read_only: true y status: "applied". Las hace avanzar el empleador, así que log_application y update_application responden read_only para una de ellas.
  • Ninguna herramienta elimina una entrada. Una persona puede tener hasta 2.000 entradas; por encima de eso, save_job responde application_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_id si 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_because dice cuál (requested, application o default).
  • 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) o not_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.scope lo 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 es not_found.
  • invalid_input: un argumento no encaja; error.field lo nombra.
  • verified_read_only: la actualización cambió o dejó fuera algo verificado; error.section y error.items dicen qué.
  • verification_not_allowed: la escritura habría mostrado una insignia de verificado en algo que escribió el asistente; error.items dice en qué.
  • cv_limit: la persona ya tiene error.max_cvs CVs.
  • read_only: la postulación se hizo en Wipperoz y solo la hace avanzar el empleador.
  • application_limit: la persona ya sigue error.max postulaciones.
  • 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_application y update_application. El día se reinicia a las 00:00 UTC.
  • 10 CVs: create_cv y duplicate_cv se rechazan con cv_limit cuando 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_id y application_id.
  • Llegar a otra persona. Todas las herramientas trabajan con los datos de quien inició sesión.
WipperozWipperoz

Wipperoz es una plataforma interactiva de CV virtual centrada en el video, diseñada para reemplazar los currículums PDF tradicionales por perfiles dinámicos y compartibles.

© 2026 Wipperoz. Todos los derechos reservados

Desarrollado por epoqx.ai