Saltar al contenido
← Volver a las funciones
Model Context Protocol

El servidor MCP de Peatch

Peatch expone un servidor MCP. Cualquier cliente que hable el Model Context Protocol puede conectarse, leer el espacio de trabajo que una persona aprobó (vacantes abiertas, candidatos, entrevistas, puntuación y briefs de puesto) y proponer cambios que solo se aplican cuando esa persona los confirma en Peatch.

Qué es

Un servidor MCP es una forma normalizada de que un cliente de IA invoque un conjunto de herramientas documentadas. Peatch implementa la mitad servidor. Tu cliente implementa la otra, y ambos se ponen de acuerdo sobre el protocolo en lugar de sobre una integración a medida.

Funciona cualquier cliente conforme. Nada de esta página es propio de un proveedor.

Endpoint

Dirección
https://peatch.ai/api/mcp
Revisión del protocolo
2025-06-18
Transporte
JSON-RPC 2.0 sobre HTTP POST, un objeto por petición. Sin SSE, sin streaming, sin cabecera de sesión, y los lotes en array se rechazan.
Métodos
initialize, ping, tools/list, tools/call
Capacidades
Solo herramientas. Recursos y prompts no están implementados y responden método no encontrado.
Cuerpo máximo de petición
64 KiB

Autorización

OAuth 2.1. No hay clave de API que pegar ni secreto de cliente que guardar.

Descubrimiento
Se sirven los dos documentos de metadatos, así que un cliente encuentra el servidor de autorización solo a partir del recurso. Un token rechazado vuelve como 401 con un desafío WWW-Authenticate que nombra la URL de metadatos.
Registro del cliente y PKCE
El registro dinámico es abierto y sin autenticar, y solo emite clientes públicos. PKCE es obligatorio y únicamente S256: un método ausente o plain se rechaza, en el endpoint de autorización y de nuevo en el de token.
Duraciones
El código de autorización vive 60 segundos y es de un solo uso. El token de acceso vive una hora. Los tokens de actualización rotan en cada uso pero heredan el vencimiento original: 30 días son un techo absoluto desde el primer consentimiento, tras lo cual una persona vuelve a consentir. Reutilizar un token ya consumido revoca toda la familia.
Un token, un espacio de trabajo
El espacio lo elige la persona al consentir y queda fijado en el token. Ninguna petición posterior puede influirlo. La pertenencia se revisa en cada llamada: quitar a alguien del espacio detiene sus tokens al instante, sin paso de revocación.
Revocación
No hay endpoint RFC 7009. La revocación es una acción de producto: un administrador del espacio elimina la conexión en los ajustes de Peatch, lo que revoca toda la concesión, acceso y actualización incluidos.

Qué se sirve

Veinte herramientas de lectura y veintiuna de escritura. El endpoint solo lista una herramienta si su nombre está en una lista de autorización del servidor y su clase declarada es lectura o escritura. Una lectura se ejecuta al instante. Una escritura nunca se ejecuta en la llamada: devuelve una acción pendiente con un enlace de confirmación, y solo se ejecuta si la persona que conectó el cliente la aprueba en Peatch en 24 horas. La herramienta de lectura get_pending_action indica después al cliente si se aprobó y qué devolvió.

  • Vacantes y su flujo de invitaciones

    list_batches, get_batch_details, get_batch_candidates, analyze_batch, send_batch_invites, create_batch, update_batch, add_invite_to_batch

  • Análisis del proceso y de los abandonos

    analyze_pipeline_health, analyze_rejection_patterns

  • Candidatos y sus expedientes

    get_candidate_details, compare_candidates, get_personality_profile, generate_candidate_brief, update_hiring_status, update_invite_hiring_status, create_job_requirement, add_to_shortlist, remove_from_shortlist, update_shortlist_status

  • Plantillas de entrevista y configuración de puntuación

    list_scenarios, list_topics, get_scoring_agent, analyze_score_calibration, create_scenario, create_scenario_from_onboarding, update_scenario, delete_scenario, create_topic, update_topic, delete_topic, create_scoring_agent, update_scoring_agent

  • Programación

    check_calendar_status, list_scheduled_interviews, schedule_interview

  • Briefs de puesto

    get_role_brief, get_role_brief_gaps, create_role_brief, update_role_brief

  • Seguimiento de los cambios propuestos

    get_pending_action

Ese número es lo que la puerta sirve hoy, no un contrato fijo. Los nombres de herramienta son identificadores estables y no se traducen.

Límites de uso

Se aplican cuatro límites, y el primero es el que vas a encontrar.

  • 60 peticiones por minuto y por IP de cliente, antes de autenticar. Es el límite que manda para un cliente aislado.
  • 300 peticiones por minuto y por token, tras autenticar.
  • 60 llamadas a herramientas por minuto y por token.
  • 240 llamadas por minuto y por espacio de trabajo, compartidas entre sus tokens.

Las ventanas son fijas y alineadas al reloj, no deslizantes. Una llamada rechazada devuelve 429; hay que interpretar el código legible por máquina, nunca el mensaje, que está localizado.

Lo que no puede hacer por sí solo

Cada cambio espera a una persona, y lo impone el servidor, no el cliente.

  • Nunca envía un correo, y no añade ningún candidato sin tu confirmación.
  • No puede cambiar una puntuación, una rúbrica ni una vacante sin tu confirmación.
  • No puede descartar a nadie sin tu confirmación, y nunca mientras el candidato sigue en la entrevista.

Un enlace de confirmación caduca a las 24 horas, y el cambio solo se aplica en el espacio elegido al dar el consentimiento. Algunas herramientas llaman a un modelo de lenguaje para redactar su respuesta, así que una llamada no es gratuita aunque no cambie nada.

Conectarse

  1. 1

    Declara el servidor en tu cliente

    Apunta tu cliente MCP a la dirección de arriba. Los clientes con registro dinámico no necesitan nada más.

  2. 2

    Una persona lo aprueba

    Peatch muestra qué cliente pide acceso y a qué espacio accederá. Un administrador del espacio lo aprueba, y solo entonces se emite un token.

  3. 3

    Invoca herramientas

    Lanza tools/list para ver qué expone este espacio, y luego tools/call.

Qué responde en la práctica

  • ¿Para qué puestos estoy contratando ahora mismo?
  • ¿Quiénes son los cinco mejores candidatos de este puesto?
  • ¿Dónde se atasca mi proceso, y desde cuándo?
  • ¿Qué le falta a mi brief del puesto?

Las respuestas salen del espacio aprobado, y cada cifra remite a una entrevista que una persona puede abrir.

Incluido en todos los planes

Sin complemento ni licencia aparte. Si tienes un espacio de trabajo en Peatch, puedes conectarle un cliente.

Pruébalo