# MCP für Agenten

# MCP-Zugang

## Endpunkt

`https://mcp.tec.1885.cloud/mcp`

Der MCP-Client verwendet denselben Bearer Consumer-Key und dieselben Tabellen-
und Produktscopes wie die REST API.

Diese MCP-Dokumentation ist direkt unter
[`https://mcp.tec.1885.cloud`](https://mcp.tec.1885.cloud) und
[`https://mcp.tec.1885.cloud/mcp-docs`](https://mcp.tec.1885.cloud/mcp-docs)
erreichbar. Die REST-/OpenAPI-Dokumentation liegt getrennt unter
[`https://api.tec.1885.cloud/api-docs`](https://api.tec.1885.cloud/api-docs).

## Werkzeuge

### `list_business_questions`

Listet die 50 Goldfragen mit Persona, Antwortstatus und zuständigem
Datenprodukt. Die Liste kann nach Geschäftsführung, Einkauf, Kalkulation, HR
oder Antwortstatus gefiltert werden.

### `get_business_question`

Liest eine Frage anhand ihrer stabilen `BQ-*`-ID und liefert spezifische sowie
gemeinsame Akzeptanzkriterien, den ehrlichen Blockertext und die verbindliche
Hintergrundstrategie. Das Werkzeug behauptet keine Fachkennzahl, wenn das
zuständige Datenprodukt sie noch nicht freigegeben liefert.

### `answer_business_question`

Beantwortet eine Goldfrage anhand ihrer `BQ-*`-ID. Für bereits angebundene
Fragen wird eine minimierte Projektion des freigegebenen, versionierten
Snapshots geliefert. Für nicht angebundene oder fachlich blockierte Fragen
kommt sofort `business_answer_included: false` mit dem konkreten Blocker und
der vorgesehenen Hintergrundstrategie. Der benötigte Produktscope bleibt auch
bei diesem Komfortwerkzeug verbindlich.

Zuplo bildet OpenAPI-Pfadparameter in MCP unter `pathParams` ab. Der direkte
Tool-Aufruf für `get_business_question` und `answer_business_question` verwendet
daher diese Argumentform:

```json
{
  "pathParams": {
    "questionId": "BQ-HR-01"
  }
}
```

Die jeweils aktuelle Argumentstruktur ist zusätzlich über MCP `tools/list`
maschinenlesbar. Ein Client darf keine flache Eigenschaft `questionId` senden.

### `list_available_tables`

Listet alle 13 Tabellen mit Zweck, Quelle, Grain, Primärschlüssel, Datenstandsfeld, POC-Status und der konkreten Zugriffsfreigabe des Consumers.

### `describe_table`

Erklärt eine einzelne Tabelle einschließlich projizierter Felder und bekannter fachlicher Besonderheiten. Dieses Werkzeug sollte vor der ersten Zeilenabfrage verwendet werden.

### `read_table_rows`

Liest eine Seite mit bis zu 100 Zeilen. Folgeseiten werden mit `next_cursor` abgerufen. Das Werkzeug akzeptiert weder SQL noch frei formulierte Filter oder Schreibbefehle.

### `get_fleet_opex_dashboard`

Liefert den freigegebenen Management-Snapshot mit vollen Geschäftsjahren,
vergleichbaren Halbjahreswerten, exakt datierter Gesamthistorie, Bestand,
Verknüpfungsabdeckung und Aktualitätsversatz. Der Consumer benötigt den Scope
`fleet.opex.dashboard`.

### `list_rulebooks`

Listet Regelwerksdokumente mit Quelle, Stand, Domäne und verfügbarer
Abschnittszahl.

### `list_rulebook_sources`

Liest den kuratierten Quellenkatalog mit Status, Rechtsnatur, Quell-URL und
Aliasen.

### `search_rulebook_sections`

Durchsucht den Volltext und liefert belegbare Treffer mit Regelwerk, Fundstelle,
Stand und Quellbezug. Die Ergebnismenge ist auf 50 Abschnitte begrenzt.

## Empfohlenes Agentenverhalten

1. Fragenkatalog lesen und die passende `BQ-*`-ID bestimmen.
2. Einzelstatus, Akzeptanz und zuständiges Datenprodukt prüfen.
3. Nur bei vorhandenem Produktpfad das freigegebene Produkt aufrufen.
4. Für Drill-downs Tabellenkatalog und Tabellenbeschreibung prüfen.
5. Kleine Seite laden und nur bei Bedarf paginieren.
6. Quell-IDs, Snapshot, Datenstand und fachliche Grenze beibehalten.