# PGB Data Platform POC

# Daten direkt nutzen

Die PGB Data Platform stellt deterministisch übertragene Unternehmensdaten über zwei gleichwertige Kanäle bereit:

- **REST API** für Anwendungen, Dashboards, Skripte und Fachtools;
- **MCP** für KI-Tools und Agenten, die Tabellen selbst verstehen und abfragen sollen.

Der aktuelle POC umfasst einen Katalog mit 13 Tabellen. Ein benannter Zuplo-Consumer erhält genau die Tabellen in `allowed_tables`, die er für seinen Anwendungsfall benötigt. Abfragen sind read-only, paginiert und auf höchstens 100 Zeilen je Aufruf begrenzt.

## Der schnellste Weg

1. Consumer-Key beim PGB Data Platform Owner anfordern.
2. Mit `GET /v1/tables` beziehungsweise `list_available_tables` prüfen, welche Tabellen der Consumer lesen kann.
3. Mit `GET /v1/tables/{tableKey}` beziehungsweise `describe_table` Grain, Felder und Datenhinweise verstehen.
4. Mit `GET /v1/tables/{tableKey}/rows` beziehungsweise `read_table_rows` Daten lesen.
5. Für die nächste Seite den gelieferten `next_cursor` übernehmen.

Die API enthält kein freies SQL und keine Schreiboperationen. REST und MCP verwenden dieselbe Tabellen-Allowlist.

## Fachliche Abnahme

Der [50-Fragen-Katalog](/fragenkatalog) zeigt, welche Fragen aus
Geschäftsführung, Einkauf, Kalkulation und HR vorgeführt werden, wann eine
Antwort als akzeptiert gilt und welche Hintergrundmaßnahme statt einer
langsamen Raw-Abfrage greift.