Aller au contenu
← Retour aux fonctionnalités
Model Context Protocol

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. 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. 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. 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.

Essayer