Hôtes MCP — Pacerelle Docs

Le serveur MCP Pacerelle donne à un assistant qui tourne dans un hôte MCP une boîte de réception chiffrée. Vous lui écrivez depuis l'application Pacerelle ; l'assistant lit vos demandes avec des outils MCP, fait le travail avec ses outils habituels et répond — sans écrire une ligne de code.

L'hôte doit maintenir l'assistant actif

Installer le serveur ne réveille pas votre assistant à lui seul. L'assistant doit être dans une session qui appelle wait_for_messages en continu. Les hôtes peuvent s'arrêter à une limite de tours, demander des validations ou fermer la session. Pour un agent qui tourne sans surveillance 24 h/24, utilisez plutôt le SDK JavaScript ou Python.

Mise en place

Créer un agent

Dans l'application Pacerelle, ouvrez Agents → Connecter un agent et copiez l'identifiant et le jeton. Voir Gérer vos agents.

Ajouter le serveur à votre hôte

Le serveur s'exécute localement avec npx (Node.js 20+). Ajoutez-le avec les valeurs de votre agent :

claude_desktop_config.json

{
  "mcpServers": {
    "pacerelle": {
      "command": "npx",
      "args": ["-y", "@pacerelle/mcp-server"],
      "env": {
        "PACERELLE_AGENT_ID": "agent_...",
        "PACERELLE_AGENT_TOKEN": "..."
      }
    }
  }
}

Redémarrez l'hôte pour qu'il charge le serveur. Les autres hôtes fonctionnent aussi — utilisez leur format de configuration MCP avec la même commande, les mêmes arguments et les mêmes variables.

Lancer la boucle d'écoute

Dans une nouvelle conversation avec l'assistant, sélectionnez le prompt start_pacerelle, ou demandez :

Démarre ou reprends mon travail Pacerelle. Lis get_status et get_checkpoints, puis wait_for_messages sans curseur. Traite chaque demande autorisée, réponds avec son sourceMessageId et appelle mark_processed une fois traitée. Enregistre un checkpoint avant une interruption. Continue d'écouter tant que cette session le permet ; préviens-moi si l'écoute s'arrête.

Tester depuis votre téléphone

Envoyez un message à l'agent dans Pacerelle et vérifiez qu'une réponse lisible revient avant de quitter votre ordinateur. Laissez l'ordinateur, l'hôte et la session de l'assistant tourner.

Ce que peut faire l'assistant

Le serveur expose huit outils. Tous les détails sont dans la référence du serveur MCP.

Outil	Rôle
`get_status`	État de la connexion, demandes en attente, envois incertains.
`wait_for_messages`	Renvoie les demandes en attente, ou attend jusqu'à 30 s les nouvelles.
`send_message`	Envoie une réponse chiffrée à une demande.
`send_widget`	Envoie un widget comme une confirmation ou un choix.
`mark_processed`	Marque une demande comme traitée. La lecture ne le fait pas.
`get_history`	Demandes et réponses récentes conservées localement.
`save_checkpoint`	Enregistre l'avancement d'une demande avant une interruption.
`get_checkpoints`	Reprend le travail enregistré dans une nouvelle session.

Reprendre dans une autre session

Avant la fin d'une session, l'assistant peut appeler save_checkpoint avec un résumé et la prochaine action. La session suivante lit get_checkpoints, appelle wait_for_messages et reprend là où elle s'était arrêtée — sans que vous colliez de transcription. Un checkpoint ne contient que ce que l'assistant y a explicitement enregistré.

Où est conservé l'état

Le serveur stocke l'état de chiffrement de l'agent, la boîte de réception, les réponses et les checkpoints dans un fichier chiffré sous ~/.pacerelle/mcp (modifiable avec PACERELLE_STORE_ROOT). Les jetons ne sont jamais écrits sur disque.

Un seul hôte à la fois peut utiliser l'état d'un agent sur une machine. Fermez le serveur dans l'ancien hôte avant de l'ouvrir dans un autre.
Sauvegardez le dossier en entier : le fichier d'état et sa clé locale vont ensemble.

Bon à savoir

Les règles d'autorisation de votre hôte s'appliquent toujours à tout ce que fait l'assistant.
Une réponse submitted a été remise au relais — vérifiez la conversation avant de répéter une action importante.
Les demandes en attente restent dans la boîte tant que l'assistant ne les a pas marquées traitées.