Servidor MCP de CazVid

El servidor MCP es un servidor remoto sin estado en https://mcp.cazvid.com/mcp. Apunta cualquier cliente MCP hacia él (Claude Code, conectores personalizados de Claude.ai, el modo desarrollador de ChatGPT, Cursor, VS Code) y el agente obtiene quince herramientas que envuelven las APIs públicas de Job Builder, Candidate Search, Webhooks, Job Search y CRM de CazVid. El servidor no guarda secretos: reenvía tu clave de API de CazVid a la API upstream, y toda la aplicación de cuotas y planes ocurre en el upstream.

Proporciona tu clave de API de CazVid de una de dos formas. Ambas usan la misma ruta de validación; elige la que soporte tu cliente.

Authorization: Bearer cazvid_jb_...
x-api-key: cazvid_jb_...

claude mcp add --transport http cazvid https://mcp.cazvid.com/mcp \
  --header "Authorization: Bearer cazvid_jb_YOUR_KEY"

{
  "mcpServers": {
    "cazvid": {
      "url": "https://mcp.cazvid.com/mcp",
      "headers": { "Authorization": "Bearer cazvid_jb_YOUR_KEY" }
    }
  }
}

{
  "servers": {
    "cazvid": {
      "type": "http",
      "url": "https://mcp.cazvid.com/mcp",
      "headers": { "Authorization": "Bearer cazvid_jb_YOUR_KEY" }
    }
  }
}

https://mcp.cazvid.com/mcp/cazvid_jb_YOUR_KEY

Las herramientas de cada familia se exponen como una sola lista plana. preview_job y create_job cubren la publicación de empleos; search_candidates cubre la búsqueda de candidatos; list_webhook_endpoints cubre los webhooks; search_jobs cubre la búsqueda de empleos; las nueve herramientas crm_* cubren el CRM; list_api_usage reporta las cuotas de las cinco familias.

create_job crea por defecto un borrador revisable y solo publica cuando se lo pides explícitamente. Su clave de idempotencia se deriva del contenido de la solicitud, así que reintentar con argumentos idénticos en 24 horas devuelve el empleo ya creado en vez de un duplicado. search_candidates es de solo lectura y no devuelve datos de contacto. list_webhook_endpoints es de solo lectura y nunca devuelve secretos de firma; los endpoints se crean, verifican, rotan y eliminan en la app de CazVid o en la API REST. search_jobs es de solo lectura y devuelve empleos públicos, cada uno con un applyUrl y nunca datos de contacto del reclutador. En el CRM, crm_upsert_contact deduplica por correo o teléfono dentro del workspace, así que un reintento que lleve alguno de esos devuelve el contacto existente en vez de un duplicado (un contacto creado solo con nombre no tiene clave de deduplicación, así que reintentarlo puede producir un segundo contacto); crm_log_interaction nunca se deduplica, así que no reintentes a ciegas una llamada que pueda haber tenido éxito; y crm_delete_contact es un borrado suave que archiva el contacto junto con sus interacciones y membresías de listas.

El servidor MCP usa la misma clave de CazVid Developer API y las mismas cuotas diarias por organización que las APIs REST. No hay nada nuevo que aprovisionar.

• Job Builder: 10 llamadas exitosas de preview_job o create_job por organización por día UTC.
• Candidate Search: 100 llamadas de search_candidates por organización por día UTC, más un límite de ráfaga de 20 por minuto.
• Webhooks: list_webhook_endpoints no consume cuota. El tope de la familia de webhooks es sobre las entregas de eventos, no sobre esta herramienta - hasta 5.000 entregas por organización por día.
• Job Search: 500 llamadas de search_jobs por organización por día UTC, más un límite de ráfaga de 30 por minuto.
• CRM: 500 llamadas crm_* por organización por día UTC, más un límite de ráfaga de 30 por minuto. Es una cuota separada de las demás familias, y cada llamada con cuota cuenta, incluidas las lecturas. crm_upload_resume además consume 1 de una cuota separada de subida de currículums de 50 por clave de API por día UTC.
• list_api_usage no consume cuota y reporta lo usado, lo restante y las horas de reinicio de las cinco familias.
• Todas las cuotas se reinician a la medianoche UTC. Una llamada limitada por tasa devuelve la hora de reinicio y te dirige a list_api_usage.
• Las claves provienen de Perfil > Developer API en la app de CazVid. El alcance de job-search es gratuito - cualquier cuenta registrada de CazVid puede generar una clave para él. Los alcances de job-builder, candidate-search y crm requieren un plan Platinum, Diamond o Enterprise, y los webhooks requieren un plan Platinum o superior. Una sola clave puede llevar todos los alcances que permita tu plan.

Para los contratos completos de solicitud y respuesta, consulta la documentación de Job Builder API, la documentación de Candidate Search API, la documentación de Webhooks API, la documentación de Job Search API y la documentación de CRM API.

Conectarse y listar herramientas funciona sin una clave para que la configuración del conector nunca se rompa. Llamar a una herramienta sin clave no falla con error - devuelve una guía clara de cómo agregar tu clave.

• El handshake (initialize) y tools/list funcionan sin clave, así que un cliente puede completar la configuración y mostrar las quince herramientas.
• Una llamada a una herramienta sin clave devuelve un mensaje legible que explica cómo conectarse, no un error de protocolo.
• Una vez que se proporciona una clave (por encabezado o forma de ruta), la misma llamada corre contra la cuota de tu organización.