MCP-Server für KI-Assistenten

IllusionDB ist auch ein MCP-Server (Model Context Protocol): Dein KI-Assistent – Claude Code, Claude Desktop oder ein anderer MCP-Client – fragt darüber Daten selbst ab, wertet sie aus und pflegt Datensätze. Typisch: „Welche Projekte sind überfällig?“, „Summe der Stunden je Kunde im Oktober“ oder „Setz alle Aufgaben von Projekt X auf erledigt“.

Der Endpunkt ist POST /mcp deiner Instanz (außerhalb von /api/v1, Streamable HTTP). Unter Einstellungen → Mein Konto zeigt die Karte MCP-Server die Adresse mit fertigen Befehlen; direkt nach dem Anlegen eines Tokens steht er schon darin.

Einrichten

Claude Code (einmal, im Projektordner; mit --scope user in allen Projekten):

claude mcp add --transport http illusiondb https://db.example.com/mcp --header "Authorization: Bearer <TOKEN>"

Claude Desktop (Einstellungen → Entwickler → Konfiguration bearbeiten; braucht Node.js), danach neu starten:

{
  "mcpServers": {
    "illusiondb": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://db.example.com/mcp", "--header", "Authorization: Bearer <TOKEN>"]
    }
  }
}

Werkzeuge

• Lesen (jeder Token): list_datasources, list_tables, get_table, query_records, get_record, list_views, distinct_values. query_records versteht dieselben Filter, Sortierungen, Gruppierungen und Zusammenfassungen wie GET /tables/{id}/records, z. B. den Filterbaum {"and":[{"col":"status","op":"eq","val":"open"}]}. Tabellen lassen sich per ID oder Namen angeben (tasks, main.tasks, Demo/tasks).
• Ändern (Tokens ohne Nur lesen): create_record, update_record, add_link, remove_link.

Rechte

• Der Token handelt mit den Rechten seines Kontos: Rolle und Tabellen-Berechtigungen gelten für jedes Werkzeug – Tabellen ohne Leserecht tauchen nicht auf, Schreiben braucht Schreibrecht. Lege für einen Assistenten am besten ein eigenes Konto mit genau den nötigen Rechten an.
• Ein Token mit Nur lesen bekommt nur die lesenden Werkzeuge.
• Bewusst nicht per MCP: Datensätze löschen, Spalten, Tabellen oder Ansichten ändern, SQL, Importe, Datenquellen, Skripte, Webhooks, Benutzer, Gruppen, Tokens und Einstellungen.
• Nur API-Tokens; Sitzungs-Cookies, ?token= und der MASTER_TOKEN gelten hier nicht. Anfragen von fremden Browserseiten (Origin) werden abgelehnt, höchstens 600 Aufrufe je Token in 10 Minuten. Der MCP-Server läuft auch ohne Admin-Oberfläche.

Datenschutz

Was der Assistent abfragt, gelangt zu seinem KI-Anbieter. Datensätze können von Benutzern oder fremden Systemen stammen – der Server weist den Assistenten an, sie als Daten zu behandeln, nicht als Anweisungen.