Aller au contenu

Galaxie Artibox

Serveur MCP · Référence de l'API

Le point d'entrée MCP pour les assistants et agents IA.

Envoyer un message JSON-RPC au serveur MCP

POST/mcp

Portée : * Tout jeton : chaque action vérifie sa propre portée

Création : l'en-tête Idempotency-Key évite un doublon pendant 24 heures.

Paramètres

NomOùTypeObligatoireDescription
Idempotency-Keyen-têtestringnonUne clé de votre choix (255 caractères au plus) : rejouée dans les 24 heures, la même requête rend la première réponse sans rien recréer ; en cours, 409 ; sur une autre route, 422.

Corps de la requête

Un message JSON-RPC 2.0 du protocole MCP (initialize, ping, tools/list, tools/call)

Exemple de requête
curl -X POST 'https://www.artibox-calendar.com/api/v1/mcp' \
  -H "x-api-key: $RDV_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Réponses

  • 200 Réussi
  • 401 Jeton absent, inconnu ou expiré
  • 403 Portée manquante ou droit refusé
  • 404 Introuvable (ou d'une autre organisation)
  • 409 Conflit : créneau pris ou requête en cours
  • 422 Données refusées : le détail est donné champ par champ
  • 429 Trop d'appels : attendez Retry-After

Flux MCP (non proposé : 405)

GET/mcp

Portée : * Tout jeton : chaque action vérifie sa propre portée

Exemple de requête
curl -X GET 'https://www.artibox-calendar.com/api/v1/mcp' \
  -H "x-api-key: $RDV_TOKEN"

Réponses

  • 200 Réussi
  • 401 Jeton absent, inconnu ou expiré
  • 403 Portée manquante ou droit refusé
  • 404 Introuvable (ou d'une autre organisation)
  • 422 Données refusées : le détail est donné champ par champ
  • 429 Trop d'appels : attendez Retry-After

Flux MCP (non proposé : 405)

DELETE/mcp

Portée : * Tout jeton : chaque action vérifie sa propre portée

Exemple de requête
curl -X DELETE 'https://www.artibox-calendar.com/api/v1/mcp' \
  -H "x-api-key: $RDV_TOKEN"

Réponses

  • 200 Réussi
  • 401 Jeton absent, inconnu ou expiré
  • 403 Portée manquante ou droit refusé
  • 404 Introuvable (ou d'une autre organisation)
  • 429 Trop d'appels : attendez Retry-After