Aller au contenu

Branchez vos agents sur votre agenda.

Un agent, N8N ou tout client MCP propose vos vrais créneaux, crée et déplace vos rendez-vous. Mêmes gardes que le produit, rien ne s’invente.

Console MCP

Démo, données d’exemple, rien n’est envoyé

Requête, POST /api/mcp

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "lister_types_de_rendez_vous",
    "arguments": {}
  }
}

Réponse, structuredContent

L'essentiel

  • Adresse : https://www.favhour.com/api/mcp (JSON-RPC en POST, mode sans état).
  • Authentification : Authorization: Bearer fh_live_... La clé se crée dans Mon compte, section Connexions et API (offre Pro), et ne s'affiche qu'une fois : nous n'en gardons que l'empreinte.
  • 240 appels d'outils par heure et par organisation, révocation immédiate.
  • Serveur à Paris, dans la même région que la base de données.

Les 9 outils

  • lister_types_de_rendez_vousVos types actifs : identifiant, nom, durée.
  • lister_creneaux_disponiblesLes meilleurs créneaux réellement libres, jamais inventés.
  • creer_rendez_vousRéserve pour un invité, par les mêmes gardes que la page publique.
  • annuler_rendez_vousAnnule proprement : invité prévenu, agenda nettoyé.
  • replanifier_rendez_vousDéplace vers un créneau libre, email de replanification compris.
  • lister_rendez_vousVos prochains rendez-vous, du plus proche au plus lointain.
  • bilan_activiteTenus, absences, taux de tenue, types les plus demandés.
  • memoire_inviteLa Mémoire de la relation avec un invité, pour préparer ou relancer.
  • lister_contactsLe carnet de relations et ses badges, sans vos notes internes.

Une limite voulue : l'API ne donne jamais accès à vos notes internes.

Brancher un client MCP

La plupart des clients MCP lisent une configuration de cette forme :

{
  "mcpServers": {
    "favhour": {
      "url": "https://www.favhour.com/api/mcp",
      "headers": { "Authorization": "Bearer fh_live_VOTRE_CLE" }
    }
  }
}

Puis, en conversation : « Quels créneaux ai-je de libres jeudi ? », « Réserve 30 minutes avec camille@exemple.com mardi à 10 h », « Fais-moi le bilan du mois ».

Brancher N8N

Nœud MCP Client, transport HTTP Streamable, adresse du serveur ci-dessus, authentification par en-tête Authorization. Les 9 outils apparaissent dans le nœud : nouveau lead vers creer_rendez_vous, bilan du lundi vers votre canal d'équipe, relances depuis le carnet.

Vérifier à la main

curl -s https://www.favhour.com/api/mcp \
-H "Authorization: Bearer fh_live_VOTRE_CLE" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Webhooks sortants

Indépendamment du MCP, chaque réservation, annulation ou replanification peut appeler VOTRE serveur : les webhooks sortants se configurent dans Mon compte et alimentent n'importe quel outil interne. Le MCP est la conversation ; le webhook est le réflexe. Chaque envoi est signé (en-tête X-Favhour-Signature, HMAC SHA-256).

POST https://votre-outil.example/favhour
X-Favhour-Event: booking.confirmed
X-Favhour-Signature: t=...,v1=...

{"type": "booking.confirmed",
 "data": {"booking": {"status": "confirmed",
   "attendee": {"name": "...", "email": "..."}}}}

Sécurité, en clair

  • Chaque outil est borné à l'organisation de la clé : aucun identifiant fabriqué n'en sort.
  • Les écritures passent par les verrous et re-vérifications du produit : pas de rendez-vous sur un créneau pris.
  • Clés hachées (SHA-256), jamais rejouables depuis chez nous, dernière utilisation visible, révocation immédiate.
  • Débit limité par organisation ET par adresse appelante, entrées validées, erreurs neutres.

Une question, un client MCP qui coince, un besoin d’outil supplémentaire ? Écrivez-nous, un humain répond.