Le serveur MCP de Peatch
Peatch expose un serveur MCP. Tout client parlant le Model Context Protocol peut s’y connecter, lire l’espace de travail qu’un humain a approuvé (postes ouverts, candidats, entretiens, notation et briefs de poste) et proposer des modifications qui ne s’appliquent qu’une fois confirmées par cette personne dans Peatch.
De quoi il s’agit
Un serveur MCP est une façon normalisée, pour un client IA, d’appeler un ensemble d’outils documentés. Peatch implémente la moitié serveur. Votre client implémente l’autre, et les deux s’accordent sur le protocole plutôt que sur une intégration sur mesure.
Tout client conforme fonctionne. Rien sur cette page n’est propre à un éditeur.
Point d’entrée
- Adresse
- https://peatch.ai/api/mcp
- Révision du protocole
- 2025-06-18
- Transport
- JSON-RPC 2.0 sur HTTP POST, un objet par requête. Ni SSE, ni flux, ni en-tête de session, et les tableaux de lots sont refusés.
- Méthodes
- initialize, ping, tools/list, tools/call
- Capacités
- Outils uniquement. Les ressources et les prompts ne sont pas implémentés et répondent méthode introuvable.
- Corps de requête maximal
- 64 Kio
Autorisation
OAuth 2.1. Aucune clé d’API à coller, aucun secret client à stocker.
- Découverte
- Les deux documents de métadonnées sont servis, donc un client retrouve le serveur d’autorisation à partir de la seule ressource. Un jeton refusé revient en 401 avec un défi WWW-Authenticate nommant l’URL des métadonnées.
- Enregistrement du client et PKCE
- L’enregistrement dynamique est ouvert et non authentifié, et n’émet que des clients publics. PKCE est obligatoire et en S256 uniquement : une méthode absente ou plain est refusée, au point d’autorisation puis de nouveau au point de jeton.
- Durées de vie
- Le code d’autorisation vit 60 secondes et ne sert qu’une fois. Le jeton d’accès vit une heure. Les jetons de rafraîchissement tournent à chaque usage mais héritent de l’échéance d’origine : 30 jours forment un plafond absolu depuis le consentement initial, après quoi un humain consent de nouveau. Réutiliser un jeton déjà consommé révoque toute la famille.
- Un jeton, un espace de travail
- L’espace est choisi par l’humain au consentement et figé dans le jeton. Aucune requête ultérieure ne peut l’influencer. L’appartenance est revérifiée à chaque appel : retirer quelqu’un de l’espace arrête ses jetons aussitôt, sans étape de révocation.
- Révocation
- Il n’existe pas de point RFC 7009. La révocation est une action produit : un administrateur de l’espace supprime la connexion dans les réglages Peatch, ce qui révoque toute la concession, accès et rafraîchissement compris.
Ce qui est servi
Vingt outils de lecture et vingt et un outils d’écriture. Le point d’accès ne liste un outil que si son nom figure sur une liste d’autorisation côté serveur et que sa classe déclarée est lecture ou écriture. Une lecture s’exécute aussitôt. Une écriture ne s’exécute jamais à l’appel : elle renvoie une action en attente avec un lien de confirmation, et ne s’exécute que si la personne qui a connecté le client l’approuve dans Peatch sous 24 heures. L’outil de lecture get_pending_action indique ensuite au client si elle a été approuvée et ce qu’elle a renvoyé.
Postes et leur vivier d’invitations
list_batches, get_batch_details, get_batch_candidates, analyze_batch, send_batch_invites, create_batch, update_batch, add_invite_to_batch
Analyse du vivier et des abandons
analyze_pipeline_health, analyze_rejection_patterns
Candidats et leurs dossiers
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
Trames d’entretien et configuration de notation
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
Planification
check_calendar_status, list_scheduled_interviews, schedule_interview
Briefs de poste
get_role_brief, get_role_brief_gaps, create_role_brief, update_role_brief
Suivi des modifications proposées
get_pending_action
Ce nombre est ce que la porte sert aujourd’hui, pas un contrat figé. Les noms d’outils sont des identifiants stables et ne sont pas traduits.
Limites de débit
Quatre limites s’appliquent, et c’est la première que vous rencontrerez.
- 60 requêtes par minute et par adresse IP, avant authentification. C’est la limite qui mord pour un client isolé.
- 300 requêtes par minute et par jeton, après authentification.
- 60 appels d’outil par minute et par jeton.
- 240 appels d’outil par minute et par espace de travail, partagés entre ses jetons.
Les fenêtres sont fixes et alignées sur l’horloge, non glissantes. Un appel refusé renvoie 429 ; c’est le code lisible par machine qu’il faut interpréter, jamais le message, qui est localisé.
Ce qu’il ne peut pas faire seul
Chaque modification attend une personne, et c’est le serveur qui l’impose, pas le client.
- Il n’envoie jamais d’e‑mail, et n’ajoute aucun candidat sans votre confirmation.
- Il ne peut modifier ni une note, ni une grille, ni un poste sans votre confirmation.
- Il ne peut écarter personne sans votre confirmation, et jamais pendant que le candidat est encore en entretien.
Un lien de confirmation expire au bout de 24 heures, et la modification ne s’applique que dans l’espace choisi au consentement. Certains outils appellent un modèle de langage pour composer leur réponse : un appel n’est donc pas gratuit, même quand il ne change rien.
Se connecter
- 1
Déclarez le serveur dans votre client
Pointez votre client MCP vers l’adresse ci-dessus. Les clients qui gèrent l’enregistrement dynamique n’ont besoin de rien d’autre.
- 2
Un humain approuve
Peatch affiche quel client demande l’accès et à quel espace il accédera. Un administrateur de l’espace approuve, et c’est seulement alors qu’un jeton est émis.
- 3
Appelez les outils
Lancez tools/list pour voir ce que cet espace expose, puis tools/call.
Ce qu’il répond concrètement
- Sur quels postes est-ce que je recrute en ce moment ?
- Quels sont les cinq meilleurs candidats sur ce poste ?
- Où mon vivier bloque-t‑il, et depuis quand ?
- Qu’est-ce qui manque à mon brief de poste ?
Les réponses viennent de l’espace approuvé, et chaque chiffre renvoie à un entretien qu’un humain peut ouvrir.
Inclus dans tous les plans
Pas d’option, pas de licence séparée. Si vous avez un espace de travail Peatch, vous pouvez y connecter un client.