DEVELOPER PORTAL

Schnellstart

Vom leeren Terminal zur veröffentlichten Änderung in fünf Schritten. Jeder Schnipsel hier läuft gegen deinen echten Tenant. Keine Sandbox, kein Wert, den du einmal kopierst und vergisst.

1 Hol dir ein Access Token

Die Auth läuft über OAuth 2.1, Authorization Code + PKCE, ausgegeben von Supabase. Autorisiere gibeon.io aus deinem OAuth-Client, bestätige den Zugriff auf dem Consent-Screen und wähl den Tenant, auf dem der Agent arbeiten darf. Du bekommst ein Access Token plus ein Refresh Token, keinen statischen Key. Der vollständige Flow mit allen Endpoints steht auf www.gibeon.io/auth.md.

2 Leg es in deine Umgebung

export GIBEON_TOKEN=<access_token>

Jede Anfrage geht an https://www.gibeon.io/v1 als Authorization: Bearer $GIBEON_TOKEN. Das gehostete MCP unter https://www.gibeon.io/mcpregelt seine eigene Auth, mehr dazu in Schritt 5.

3 Liste deine Player auf

Hol dir die Bildschirme in deinem Tenant und ihren Online-Status.

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

Das Node/Deno-Äquivalent:

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`)

Wähl einen aus und nimm seine id. Die brauchst du im nächsten Schritt.

4 Inhalt neu zuweisen + veröffentlichen

Richte einen Bildschirm auf eine andere Playlist. Der PATCH antwortet mit publish_required: true für Felder, die den Inhalt ändern. Bis du veröffentlichst, zeigt der Player weiter die alte Zuweisung. 

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"

Der Player holt sich den neuen Snapshot beim nächsten Heartbeat, meist innerhalb von 10 Sekunden. Veröffentliche einen einzelnen Bildschirm über /v1/players/<id>/publish oder jeden Bildschirm im Tenant über /v1/players/publish.

5 Häng einen KI-Agenten an (MCP)

Füg das in die Config deines MCP-Hosts ein, um die 13 gibeon.io-Tools für Claude Desktop, Claude Code oder Cursor bereitzustellen. Der Client autorisiert sich beim ersten Verbinden selbst über OAuth (du bestätigst den Consent-Screen einmal), es steht also kein Token in der Config:

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

Starte deinen Client neu. Frag ihn „wie viele Bildschirme sind in meinem gibeon.io-Tenant online?“ und der Agent ruft list_players auf und meldet zurück. Der Client regelt die Auth selbst, keine separate Installation.

Wie geht’s weiter

Irgendwo hakt’s? Das Repo ist während des Launch des Developer-Portals privat. Schreib vorerst an [email protected] und wir beheben es, wo möglich, noch am selben Tag.