---
title: "Für Entwickler — Bau mit OXOM"
description: "Entwickler-Ressourcen für OXOM: OpenAPI-3.1-Spezifikation, OXOM MCP Server (Streamable HTTP), OAuth 2.0 für Agents, Agent Cards und llms.txt."
canonical: https://oxom.de/developers
last-updated: 2026-10-10
---

# Für Entwickler — Bau mit OXOM

> Entwickler-Ressourcen für OXOM: OpenAPI-3.1-Spezifikation, OXOM MCP Server (Streamable HTTP), OAuth 2.0 für Agents, Agent Cards und llms.txt.

Canonical HTML: https://oxom.de/developers
## MCP Server
Ein Model-Context-Protocol-Server über Streamable HTTP mit 10 Tools. Bei der Freigabe entscheidet die Person, worauf die Verbindung zugreifen darf: ein Workspace oder alle, in denen sie Mitglied ist. Mitgliedschaft und Rolle werden bei jedem Aufruf neu geprüft.

- Endpunkt: https://mcp.oxom.de/mcp
- Transport: Streamable HTTP (nicht Legacy-SSE), Protokollversion 2025-06-18
- Anmeldung: OAuth 2.0, Authorization Code + PKCE (S256)
- Client-ID: `oxom-claude` (öffentlicher Client, kein Secret; Dynamic Registration ist nicht implementiert)
- Server Card (ohne Anmeldung): https://oxom.de/.well-known/mcp/server-card.json
- Discovery ohne Token: `initialize`, `ping`, `tools/list`, `resources/list`, `resources/read` antworten ohne Bearer-Token — nur `tools/call` nicht.

### Tools
- `list_workspaces` (lesen) — Workspaces dieser Verbindung auflisten
- `list_links` (lesen) — Short Links mit Slug, Ziel und Klickzahlen
- `create_link` (schreiben) — Short Link aus Ziel-URL und optionalem Slug anlegen
- `search_docs` (lesen) — Docs-Metadaten (Titel, Emoji) durchsuchen
- `create_doc` (schreiben) — neues, leeres Doc anlegen
- `search_drive_files` (lesen) — Dateien im R2-Drive suchen und auflisten
- `create_upload_link` (schreiben) — signierten, ablaufenden Upload-Link erzeugen
- `get_team_time` (lesen) — eigene Team-Time-Verfügbarkeit lesen
- `set_stream_plan` (schreiben) — persönlichen .ics-Kalender als Stream Plan hinterlegen
- `list_streamelements_commands` (lesen) — StreamElements-Chat-Commands des Kanals

## Anmeldung (OAuth für Agents)
OXOM nutzt den Standard: OAuth 2.0 mit Authorization Code und PKCE. Autorisierungsserver ist app.oxom.de, Ressourcenserver der MCP-Endpunkt. API-Schlüssel gibt es nicht.

- Komplette Anleitung: https://oxom.de/auth.md
- AS-Metadaten (RFC 8414): https://app.oxom.de/.well-known/oauth-authorization-server
- Protected-Resource-Metadaten (RFC 9728): https://mcp.oxom.de/.well-known/oauth-protected-resource
- Grant Types: `authorization_code`, `refresh_token`

Scopes (so eng wie möglich anfragen): `links:read`, `links:write`, `docs:read`, `docs:write`, `drive:read`, `drive:write`, `workspace:read`.

## Public REST API
Bewusst klein und ohne Anmeldung: Bezahllinks nachschlagen und abschließen, Slug und Domain beim Onboarding prüfen, OG-Bilder erzeugen.

- OpenAPI 3.1: https://oxom.de/openapi.json
- Versionierung: datumsbasiert über den `OXOM-Version`-Header; Abkündigungen kommen als `Deprecation`- und `Sunset`-Header
- Idempotenz: schreibende Aufrufe nehmen einen `Idempotency-Key`-Header an
- Fehler: nur JSON, mit maschinenlesbarem `error.code` und lesbarer `error.message`
- Rate Limits: `RateLimit-Limit`, `RateLimit-Remaining`, `RateLimit-Reset`, dazu `Retry-After` bei 429

Endpunkte: `GET /api/onboard/check-slug`, `POST /api/onboard/check-domain`, `GET /api/pay/{key}`, `POST /api/pay/{key}/checkout`, `POST /api/pay/{key}/verify`, `POST /api/pay/{key}/gift`, `GET /api/og`.

## WebMCP
oxom.de registriert seine öffentlichen Funktionen zusätzlich als In-Page-Tools über `navigator.modelContext` (WebMCP, W3C-Community-Draft). Ein Agent im Browser der Besucherin kann sie direkt aufrufen, statt das DOM zu bedienen — bewusst nur die nicht angemeldete Oberfläche, ohne Zugangsdaten.

## Discovery-Dokumente
- A2A Agent Card: https://oxom.de/.well-known/agent-card.json
- MCP-Manifest: https://oxom.de/.well-known/mcp.json
- Agent-Skills-Index: https://oxom.de/.well-known/agent-skills/index.json
- Anweisungen für Agents: https://oxom.de/.well-known/agent-skills (auch /.well-known/agent-skills/SKILL.md)
- KI-Ressourcenkatalog (ARD): https://oxom.de/.well-known/ai-catalog.json
- API-Katalog (RFC 9727): https://oxom.de/.well-known/api-catalog
- llms.txt: https://oxom.de/llms.txt (Entwickler-Ausgabe: https://oxom.de/developers/llms.txt)

## Support
Fragen zur Anbindung oder eine Redirect-URI, die für deinen Agent eingetragen werden soll: support@oxom.de. Status: https://status.oxom.de

## Weiterlesen
- [MCP in Claude einrichten](https://oxom.de/docs/mcp)
- [Tools mit Parametern](https://oxom.de/docs/mcp/tools)
- [Anmeldung für Agents (auth.md)](https://oxom.de/auth.md)
- [OpenAPI-Spezifikation](https://oxom.de/openapi.json)
- [Docs](https://oxom.de/docs)
- [GitHub](https://github.com/oxom-de)