Démarrage rapide

1 Obtenez un jeton d’accès

L’authentification passe par OAuth 2.1, Authorization Code + PKCE, émis par Supabase. Autorisez gibeon.io depuis votre client OAuth, validez l’accès sur l’écran de consentement et choisissez le tenant sur lequel l’agent peut travailler. Vous obtenez un jeton d’accès et un jeton de rafraîchissement, pas une clé statique. Le flux complet avec tous les endpoints se trouve sur www.gibeon.io/auth.md.

2 Placez-le dans votre environnement

export GIBEON_TOKEN=<access_token>

Chaque requête part vers https://www.gibeon.io/v1 avec Authorization: Bearer $GIBEON_TOKEN. Le MCP hébergé sur https://www.gibeon.io/mcpgère sa propre authentification, voir l’étape 5.

3 Listez vos players

Récupérez les écrans de votre tenant et leur état en ligne.

curl https://www.gibeon.io/v1/players \
  -H "Authorization: Bearer $GIBEON_TOKEN"

L’équivalent en Node/Deno :

const res = await fetch('https://www.gibeon.io/v1/players', {
  headers: { Authorization: `Bearer ${process.env.GIBEON_TOKEN}` },
})
const { data } = await res.json()
console.log(`${data.length} screens, ${data.filter(p => p.status === 'online').length} online`)

Choisissez-en un et notez son id. Vous l’utiliserez à l’étape suivante.

4 Réassignez du contenu + publiez

Pointez un écran vers une autre playlist. Le PATCH répond avec publish_required: true pour les champs qui modifient le contenu. Tant que vous ne publiez pas, le player continue d’afficher l’ancienne affectation.

curl -X PATCH https://www.gibeon.io/v1/players/<player_id> \
  -H "Authorization: Bearer $GIBEON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "playlist_id": "<playlist_id>" }'

curl -X POST https://www.gibeon.io/v1/players/<player_id>/publish \
  -H "Authorization: Bearer $GIBEON_TOKEN"

Le player récupère le nouveau snapshot à son prochain heartbeat, en général sous 10 secondes. Publiez un seul écran via /v1/players/<id>/publish ou tous les écrans du tenant via /v1/players/publish.

5 Branchez un agent IA (MCP)

Collez ceci dans la config de votre hôte MCP pour exposer les 13 outils gibeon.io à Claude Desktop, Claude Code ou Cursor. Le client s’autorise lui-même via OAuth à la première connexion (vous validez l’écran de consentement une fois), donc aucun jeton ne figure dans la config :

{
  "mcpServers": {
    "gibeon": {
      "url": "https://www.gibeon.io/mcp"
    }
  }
}

Redémarrez votre client. Demandez-lui « combien d’écrans sont en ligne dans mon tenant gibeon.io ? » et l’agent appelle list_players puis vous répond. Le client gère l’authentification lui-même, aucune installation séparée.

Et ensuite

• Référence complète des endpoints sur www.gibeon.io/dev/reference (interactive, avec try-it).
• Spec OpenAPI 3.1 brute sur www.gibeon.io/v1/openapi.yaml pour Postman, Bruno, Insomnia ou la génération de code.
• Contexte, limites, erreurs courantes : API en MCP

Un point qui coince ? Le dépôt est privé pendant le lancement du portail développeur. Pour l’instant, écrivez à [email protected] et nous corrigeons le jour même quand c’est possible.