Zum Hauptinhalt springen
Über den Trassets-MCP-Server lesen KI-Clients deine Daten der Data API v1 per Model Context Protocol. Jeder Aufruf läuft mit deinem API-Key und unterliegt denselben Einschränkungen, Grants und demselben Rate-Limit wie ein direkter API-Request.

​
Was der MCP-Server kann

Der Server bietet fünf Tools. Alle lesen nur; jedes ruft mit deinem Key einen Endpunkt der Data API auf.

​
Endpunkt und Key

Du brauchst einen Key mit Kanal MCP. Ein Administrator erzeugt ihn im Portal wie jeden anderen Key (siehe Authentifizierung) und wählt unter Channel den Eintrag MCP. Ein Key gilt für genau einen Kanal: Der MCP-Server lehnt für die API erzeugte Keys ab, die REST-API lehnt MCP-Keys ab.
Daten, die ein Tool zurückgibt, verarbeitet der Modellanbieter deines KI-Clients. Binde nur Clients an, deren Anbieter deine Organisation für diese Daten freigegeben hat, und kombiniere den MCP-Server nicht mit Tools, die Daten an Dritte senden können. Siehe Risiken.

​
Unterstützte KI-Clients

MCP ist modellunabhängig: Das Modell bringt der Client mit, welches Modell antwortet, hängt also von deinem Client ab. Entscheidend ist, ob der Client einen festen API-Key-Header an einen entfernten MCP-Server senden kann. Eine Anmeldung per OAuth unterstützt der MCP-Server noch nicht, Clients, die nur OAuth anbieten, können sich deshalb nicht verbinden. Stand November 2026. Die Anbieter ändern ihre MCP-Unterstützung häufig; passt ein Schritt nicht, sieh in der Dokumentation des Clients nach.

​
Beispiel: Claude Code

Frag Claude Code danach, welche Trassets-Tabellen es lesen kann. Andere Clients brauchen dieselben zwei Werte: die URL und den Key, als X-API-Key-Header oder als Authorization: Bearer <key>. Schreib den Key nicht im Klartext in eine Config-Datei, die du committest: Cursor löst ${env:TRASSETS_MCP_KEY} in headers auf, VS Code fragt ihn über ${input:...} ab.

​
Beispiel: Microsoft Copilot Studio

  1. Öffne deinen Agent, geh zu Tools, wähle Add a tool und füge einen neuen Model-Context-Protocol-Server hinzu.
  2. Gib einen Namen, eine Beschreibung und https://mcp.trassets.ai/mcp als Server-URL ein.
  3. Wähle bei der Authentifizierung API key, Typ Header, und trag X-API-Key als Header-Namen ein.
  4. Leg eine Verbindung an, gib deinen MCP-Key ein und wähle Add to agent. Alle fünf Tools sind standardmäßig aktiv.
  5. Prüfe vor dem Veröffentlichen, mit welchen Zugangsdaten das Tool arbeitet. Mit den Zugangsdaten des Erstellers (Maker-provided credentials) liest jeder, der den Agent nutzt, mit deinem Key und sieht alles, was dein Key sehen darf. Lass stattdessen einen Administrator pro Nutzer einen MCP-Key erzeugen, und jeder Nutzer verbindet sich mit seinem eigenen Key.
Frag den Agent danach zum Beispiel: „Welche Trassets-Tabellen kannst du lesen?“ oder „Wie viele Objekte sind in den Daten?“

​
Grenzen

  • Nur lesen. Der Server kann keine Daten anlegen oder ändern.
  • Keine Berechnungen. Tools liefern Zeilen, keine Summen, Durchschnitte oder KPIs. Fragst du nach einer Summe, rechnet das Modell deines Clients sie aus den gelesenen Zeilen aus und kann sich dabei verzählen oder nach einer Seite aufhören. Für Zeilenanzahlen liefern die Tools total. Vorberechnete Kennzahlen gibt es nur in den KPI-Tabellen.
  • Kleine Seiten. Ein Tool-Aufruf liefert höchstens 200 Zeilen (Standard 50). Eine große Tabelle braucht viele Aufrufe, und jeder zählt gegen das Budget deines Keys von 2.500 Requests pro Stunde (siehe Rate-Limits). Für vollständige Exporte nutze die REST-API mit einem eigenen Key für den Kanal API (siehe Paginierung).
  • Nur exakte Filter. get_table_data filtert nach exakten Werten auf den Filterspalten einer Tabelle. Bereiche und Textsuche gibt es nicht.
  • Aktualität. Die Daten sind so aktuell wie der letzte Sync der jeweiligen Tabelle; ein festes Intervall gibt es nicht. get_changes zeigt last_sync_at pro Tabelle (siehe Sync-Zyklus).
  • Nur API-Key. Eine Anmeldung per OAuth gibt es noch nicht (siehe Unterstützte KI-Clients).

​
Risiken

  • Daten verlassen Trassets. Alles, was ein Tool zurückgibt, geht an den Modellanbieter deines Clients und wird nach dessen Bedingungen verarbeitet. Deine Organisation entscheidet, welcher Anbieter welche Daten verarbeiten darf. Nutze Keys ohne die Grants für personenbezogene Daten, solange der Anwendungsfall sie nicht braucht.
  • Anweisungen in den Daten. Freitextfelder wie Kommentare oder Buchungstexte können Text enthalten, der wie eine Anweisung klingt. Die Tools weisen das Modell an, solchen Text zu ignorieren, aber kein Modell hält sich verlässlich daran.
  • Tools, die Daten nach außen senden. Ein Agent, der deine Daten liest, solchen Text verarbeitet und zugleich Daten versenden kann (E-Mail, Web-Requests, Datei-Uploads, MCP-Server, die anderswo schreiben), lässt sich dazu bringen, deine Daten an Dritte zu schicken. Nutze den Trassets-MCP-Server nur in Agents und Sitzungen ohne solche Tools.
  • Ungeprüfte Antworten. Das Modell kann Felder falsch lesen, Tabellen verwechseln oder von einer Seite hochrechnen. Prüfe Zahlen gegen die API oder deine Berichte, bevor du dich auf sie verlässt.
  • Ein Key pro Person. Erzeuge pro Person einen eigenen MCP-Key, benenne ihn im Portal nach ihr und gib ihn nicht weiter, auch nicht über einen Agent, den andere nutzen. Verlässt jemand die Organisation, lösch seinen Key; damit endet sein MCP-Zugang.

​
Fehlermeldungen

Tools melden Fehler als Text. Die häufigsten: