Model Context Protocol (MCP)

MCP ist das offene Protokoll, mit dem KI-Assistenten externe Tools ansprechen. Dieser Server wird automatisch aus den Grants-Datenmodellen erzeugt - eine Installationszeile, KI-Client konfigurieren, und dein Assistent kann Daten lesen, anlegen, ändern und löschen. Die Authentifizierung läuft über dieselben persönlichen Zugriffstokens wie der Rest der API - du legst genau fest, welche Modelle der Assistent anfassen darf.

Installation

Eine Zeile, eine Datei. Das Skript landet unter deinem Home-Verzeichnis - kein pip install, kein systemweiter Eingriff. Wähle dein Betriebssystem in den Tabs.

curl -fsSL https://granttool.de/xapi2/mcp/install.sh | bash

Token bereitstellen

Erstelle ein persönliches Zugriffstoken (PAT) im Integrationen-Menü und hake die Scopes an, die die KI bekommen soll - nur Lesen für sichere Exploration oder Lesen + Schreiben für aktives Bearbeiten. PATs sind widerrufbar und mit Scopes versehen, sodass ein geleaktes Token mit einem einzigen Klick ausgehebelt ist. Übergib das Token per Umgebungsvariable GRANTSMCP_TOKEN in der Server-Konfig deines KI-Clients (empfohlen) oder führe grantsmcp login --token pat_... einmal aus, dann bleibt das Token für alle weiteren Aufrufe gespeichert.

export GRANTSMCP_TOKEN=pat_...
grantsmcp doctor

KI-Client konfigurieren

Jeder MCP-fähige KI-Client akzeptiert eine kleine JSON-Konfig, die festlegt, welche Server gestartet werden. Füge das Snippet unten in die MCP-Konfig deines Clients ein und starte ihn neu. Der Server läuft lokal als Subprozess deines Clients - er nimmt keine eingehenden Verbindungen aus dem Netz an.

{
  "mcpServers": {
    "grantsmcp": {
      "command": "grantsmcp",
      "args": [],
      "env": {
        "GRANTSMCP_TOKEN": "pat_..."
      }
    }
  }
}

Was der Assistent kann

Jedes Datenmodell stellt pro verfügbarer Operation ein Tool bereit. Lese-Tools ({type}_list, {type}_get) können bedenkenlos aufgerufen werden; Schreib-Tools ({type}_create, {type}_update, {type}_delete) verändern Daten und sollten vorher mit dir bestätigt werden. Der Server kann keine Benutzer anlegen, Tokens verwalten oder die Abrechnung ändern - das passiert in der Grants-Weboberfläche.

Beispiel-Prompts

Sobald der Server in deinem KI-Client registriert ist, erkennt das Modell die Tools automatisch. Diese Prompts zeigen, wie du die Datenmodelle gemeinsam mit der KI bearbeitest.

Confirm you can talk to the Grants server, then list the
five most recently created derived_docs. Summarise the result.

Umgebungsvariablen

Lokaler Diagnose-Befehl

Das gleiche Skript ist auch direkt aus der Shell aufrufbar - nützlich, wenn der KI-Client meldet, dass der Server nicht startet.

# Server reachable? Token valid? Tool surface rendered?
grantsmcp doctor

Sicherheit

Der Server läuft lokal als Subprozess deines KI-Clients und nimmt keine eingehenden Verbindungen aus dem Netz an. Tool-Aufrufe gehen ausschließlich an die offizielle API-Adresse, die in dein Skript eingebrannt ist; eine Umleitung an einen anderen Host würde dein Token nicht mitnehmen. Das Token kannst du jederzeit im Integrationen-Menü widerrufen.

• Keine Benutzer- oder Token-Verwaltung. Der Server kann keine Konten anlegen, keine Passwörter ändern, keine Tokens minten oder widerrufen, keine Abrechnung anfassen - nur Datenmodelle.
• PAT-Scopes sind die Bremse. Vergib genau die Scopes, die der Assistent braucht. Ein nur-Lese-PAT macht den Server zur sicheren Erkundungssitzung.
• Schreib-Tools sind als destructive markiert. Die meisten KI-Clients fragen vor dem Aufruf nach - lass die Bestätigung dort an.
• Server-Prüfungen bleiben aktiv. Validierung, Zugriffsregeln und Audit-Log laufen für jeden Tool-Aufruf genauso wie für die Web-UI.

Telemetrie + Auto-Update

Der Server sendet pro Tool-Aufruf ein anonymes Analyse-Event (Tool-Name, Version, OS - keine Argumente, keine Feldwerte), damit das Team, das diese App betreibt, die Nutzung sieht. Abschalten mit GRANTSMCP_NO_TELEMETRY=1. Zusätzlich prüft der Server höchstens alle 24 Stunden auf eine neuere Version und ersetzt sich selbst; GRANTSMCP_NO_AUTOUPDATE=1 deaktiviert das. Die neuen Bytes greifen beim nächsten Host-Neustart - die laufende Session behält den alten Code, damit eine laufende Anfrage nicht abbricht.