Quickstart · gibeon.io

1 Haal een access token op

Auth verloopt via OAuth 2.1, Authorization Code + PKCE, uitgegeven door Supabase. Autoriseer gibeon.io vanuit je OAuth-client, keur de toegang goed op het consent-scherm en kies de tenant waarop de agent mag werken. Je krijgt een access token plus een refresh token, geen statische sleutel. De volledige flow met alle endpoints staat op www.gibeon.io/auth.md.

2 Zet hem in je omgeving

export GIBEON_TOKEN=<access_token>

Elke aanvraag gaat naar https://www.gibeon.io/v1 als Authorization: Bearer $GIBEON_TOKEN. De gehoste MCP op https://www.gibeon.io/mcpregelt zijn eigen auth, daarover meer in stap 5.

3 Lijst je spelers op

Haal de schermen in je tenant op en hun online-status.

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

Het equivalent in 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`)

Kies er één en pak zijn id. Die gebruik je in de volgende stap.

4 Wijs content toe + publiceer

Richt een scherm op een andere playlist. De PATCH antwoordt met publish_required: true voor velden die de content wijzigen. Tot je publiceert, blijft de speler de oude toewijzing tonen.

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"

De speler pikt de nieuwe snapshot op bij zijn volgende heartbeat, doorgaans binnen 10 seconden. Publiceer één scherm via /v1/players/<id>/publish of elk scherm in de tenant via /v1/players/publish.

5 Koppel een AI-agent (MCP)

Plak dit in de config van je MCP-host om de 13 gibeon.io-tools beschikbaar te maken voor Claude Desktop, Claude Code of Cursor. De client autoriseert zelf via OAuth bij de eerste verbinding (je keurt het consent-scherm één keer goed), dus er staat geen token in de config:

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

Herstart je client. Vraag hem "hoeveel schermen staan er online in mijn gibeon.io-tenant?" en de agent roept list_players aan en rapporteert terug. De client handelt de auth zelf af, geen aparte installatie.

Wat nu

Volledige endpoint-referentie op www.gibeon.io/dev/reference (interactief, met try-it).
Ruwe OpenAPI 3.1-spec op www.gibeon.io/v1/openapi.yaml voor Postman, Bruno, Insomnia of codegen.
Achtergrond, limieten, veelvoorkomende fouten: API en MCP

Loop je tegen een ruw randje aan? De repo is privé tijdens de launch van het dev-portal. Mail voorlopig [email protected] en we lossen het waar mogelijk dezelfde dag op.