Aller au contenu

Galaxie Artibox

Le serveur MCP de prise de rendez-vous

Branchez un assistant IA compatible MCP sur Artibox Calendar. Il trouve des créneaux et gère vos rendez-vous, avec exactement les droits de votre jeton.

Le serveur MCP de prise de rendez-vous d'Artibox Calendar suit le Model Context Protocol (révision 2025-06-18, transport « Streamable HTTP », JSON-RPC 2.0). Un assistant ou un agent qui parle MCP peut ainsi lister vos types de rendez-vous, chercher des créneaux libres, réserver, déplacer ou annuler, sans que vous écriviez de code.

Artibox Calendar ne fournit pas d'assistant : le serveur MCP sert l'assistant que vous choisissez, avec un jeton que vous contrôlez.

Adresse et authentification

  • Adresse : POST https://adresse-de-votre-application/api/v1/mcp
  • En-tête : x-api-key, avec un jeton personnel (rdv_pat_…) ou un jeton d'accès OAuth (rdv_oat_…).
  • Sans état : un message JSON-RPC par requête, pas de Mcp-Session-Id. GET et DELETE répondent 405.
  • C'est un appel /api/v1 ordinaire : l'organisation du jeton, sa limite de 100 appels par minute, et pour chaque outil sa portée.

Limite actuelle : les clients qui n'envoient que Authorization: Bearer … après leur propre parcours OAuth MCP ne sont pas encore pris en charge. Utilisez un client capable d'envoyer l'en-tête x-api-key, ou un pont comme mcp-remote.

Les outils

  • list_event_types (portée types:lire) : les types actifs que vous pouvez proposer, avec leur identifiant, leur nom, leur durée, leur mode et leur adresse publique.
  • find_available_slots (types:lire) : les créneaux libres d'un type (type_id, from, to, timezone), 7 jours par défaut et 62 au plus, calculés comme sur la page de réservation.
  • book_meeting (reservations:ecrire) : réserve un créneau (type_id, start, name, email, et au besoin phone, timezone, locale, answers) ; l'invité reçoit sa confirmation.
  • list_bookings (reservations:lire) : les rendez-vous visibles, 30 jours par défaut, filtrables par état et courriel, les 50 premiers.
  • cancel_booking (reservations:ecrire) : annule un rendez-vous (booking_id, reason) ; l'invité est prévenu.
  • reschedule_booking (reservations:ecrire) : déplace un rendez-vous (booking_id, start) sur un créneau libre du même type.

Un outil dont le jeton n'a pas la portée n'apparaît pas dans tools/list. Les heures s'écrivent en ISO 8601 avec décalage. Chaque résultat porte un résumé lisible (en français si la requête envoie Accept-Language: fr, sinon en anglais) et les données structurées.

Se connecter au serveur MCP de prise de rendez-vous

Créez d'abord un jeton dans Réglages › Intégrations, avec types:lire pour consulter, et reservations:lire et reservations:ecrire pour gérer les rendez-vous : le pas à pas est dans le démarrage rapide.

Claude Code

claude mcp add --transport http artibox-calendar https://adresse-de-votre-application/api/v1/mcp \
  --header "x-api-key: rdv_pat_…"

Un client configuré en JSON

{
  "mcpServers": {
    "artibox-calendar": {
      "url": "https://adresse-de-votre-application/api/v1/mcp",
      "headers": { "x-api-key": "rdv_pat_…" }
    }
  }
}

Par le pont mcp-remote

{
  "mcpServers": {
    "artibox-calendar": {
      "command": "npx",
      "args": ["mcp-remote", "https://adresse-de-votre-application/api/v1/mcp", "--header", "x-api-key:${ARTIBOX_TOKEN}"],
      "env": { "ARTIBOX_TOKEN": "rdv_pat_…" }
    }
  }
}

Essayer avec curl

URL=https://adresse-de-votre-application/api/v1/mcp
curl -s "$URL" -H "content-type: application/json" -H "accept: application/json, text/event-stream" \
  -H "x-api-key: $RDV_TOKEN" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

curl -s "$URL" -H "content-type: application/json" -H "accept: application/json, text/event-stream" \
  -H "x-api-key: $RDV_TOKEN" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"find_available_slots","arguments":{"type_id":"ID_DU_TYPE","timezone":"Europe/Paris"}}}'

Erreurs

Une erreur du protocole revient en erreur JSON-RPC : -32700 JSON illisible, -32600 requête invalide (dont un lot), -32601 méthode inconnue, -32602 outil inconnu ou arguments hors du schéma. Un outil qui s'exécute mais est refusé (créneau pris, rendez-vous introuvable, portée absente) rend un résultat isError, que l'assistant lit pour se corriger.

Sécurité

Le serveur n'ajoute aucun droit : un outil fait exactement ce que ferait la route de l'API correspondante avec le même jeton. Donnez au jeton les seules portées nécessaires, une date d'expiration, et révoquez-le dès qu'il ne sert plus. Les autres façons d'intégrer sont sur la page développeurs et dans la référence de l'API.

Questions fréquentes

Quels assistants peuvent utiliser le serveur MCP ?

Tout client MCP capable d'envoyer un en-tête personnalisé (x-api-key) en transport HTTP, ou passant par le pont mcp-remote.

L'assistant peut-il voir tous les rendez-vous de l'organisation ?

Non. Il voit ce que voit le membre du jeton, dans les portées du jeton. Un membre ne voit que ses rendez-vous et ceux de ses types.

Une réservation faite par l'assistant est-elle différente ?

Non : elle suit les mêmes règles que la page de réservation, porte l'origine api et l'invité reçoit les mêmes messages.

Branchez votre assistant

Créez votre compte, puis un jeton avec les portées de votre choix.

Créer mon compte