Lokaler MCP-Server

Im Kerry Studio verbindet der lokale MCP-Server Desktop-KI-Assistenten, Cursor, Claude Desktop und andere, mit Ihren gespeicherten Verbindungen. Ohne ihn bedeutet das Auflisten von Tabellen oder das Ausführen von SQL aus dem Chat, Schema oder Ergebnisse von Hand einzufügen. Kerry lauscht nur auf Ihrem Computer, behält Passwörter, SSH und Zertifikate in der Anwendung und gibt dem Assistenten das Projekt, die Umgebung, den Datenbanktyp, den Datenbanknamen, das Schema und die Ergebnisse der Abfragen, die er ausführt. Kerrys Server empfangen das nicht. Der KI-Client kann das, was MCP zurückgegeben hat, an sein Cloud-Modell senden.

Bevor Sie beginnen

Sie brauchen:

• Einen geöffneten workspace in Kerry Studio
• Einen Desktop-KI-Client, der MCP unterstützt

Das Panel öffnen

1. Öffnen Sie einen workspace.
2. Klicken Sie in der rechten Seitenleiste auf das Symbol MCP-Server.
3. Oder nutzen Sie die workspace-Fußzeile (MCP aktiviert / MCP deaktiviert), oder die Befehlspalette (⌘K / CtrlK) und wählen Sie MCP-Panel öffnen.

Standardmäßig startet der Server nicht erneut, wenn Sie Kerry Studio beenden und wieder öffnen. Die Start-Einstellungen liegen unter Einstellungen → MCP (Zahnradsymbol in der Kopfzeile Konfiguration des Panels, oder Befehlspalette ⌘K / CtrlK → Einstellungen: MCP):

• Beim App-Start → Mit eingeschaltetem Server starten: startet den MCP-Server, wenn Kerry Studio öffnet (standardmäßig aus).
• Beim App-Start → Immer im schreibgeschützten Modus starten: beim nächsten Start kehrt er zum Schreibschutz zurück, auch wenn die vorherige Sitzung im Vollmodus war (standardmäßig an).

Im Panel öffnet das Buch-Symbol neben dem Zahnrad die Dokumentation (Dokumentation öffnen).

Den KI-Client einrichten

1. Schalten Sie im Panel MCP-Server aktivieren ein.
2. Klicken Sie auf JSON kopieren.
3. Fügen Sie das JSON in die MCP-Einstellungen Ihres Clients ein (oder führen Sie es mit der Konfiguration zusammen, die Sie schon haben).
4. Starten Sie den Client neu, wenn er Server nicht von selbst neu lädt.

Die Standardadresse ist http://127.0.0.1:18765/mcp. HTTP-Port im Panel ändert diesen Port. Das Feld ist gesperrt, solange der Server eingeschaltet ist. JSON kopieren verwendet den aktuellen Port und das echte Token. Verwenden Sie nicht das Beispiel YOUR_TOKEN.

{
  "mcpServers": {
    "kerry-studio": {
      "url": "http://127.0.0.1:18765/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Schreibschutz und Vollmodus

Standardmäßig ist der Server schreibgeschützt: der Assistent kann Verbindungen auflisten, Schema prüfen und Leseabfragen ausführen: SELECT, SHOW, DESCRIBE, EXPLAIN (einschließlich ANALYZE eines SELECT). INSERT, UPDATE, DELETE, SELECT … FOR UPDATE, SELECT INTO, INTO OUTFILE und WITH-Abfragen, die Daten ändern, werden abgelehnt.

Schreibschutz öffnet die Datenbank bereits. Ohne das gibt es kein Schema und kein SELECT. Kerry ist das, was die Sitzung öffnet, auf Ihrem Computer, mit den Zugangsdaten in der Anwendung. Tabs müssen nicht verbunden sein.

Ein Moduswechsel im Panel gilt sofort, Sie müssen Kerry Studio also nicht neu starten.

Unter Einstellungen → MCP → Schreibgeschützt hält Beim Starten des Servers Schreibschutz erzwingen (standardmäßig an) den Schalter Schreibgeschützter Modus im Panel angehakt und gesperrt und wendet Schreibschutz an, sobald der Server eingeschaltet wird.

Worauf der Assistent zugreifen kann

Passwörter, SSH und Zertifikate bleiben in Kerry. Kerry ist das, was die Datenbanksitzung öffnet, auf Ihrem Computer. Verbindungsfehler geben weder Benutzername, Host, Passwort noch Dateipfad zurück. SQL-Ergebnisse, die der Assistent erhält, lassen ebenfalls Dateipfade, Hosts, Verbindungs-URIs und Schlüssel weg. Das Raster des Tabs in Kerry bleibt unverändert.

Die Verbindungsliste zeigt Projekt, Umgebung, Datenbanktyp und Datenbankname (bei einer lokalen Datei den Dateinamen, nicht den Pfad).

Bei eingeschaltetem Server erhält der Assistent außerdem:

• Tabellen- und Sichtnamen
• Spalten und Tabellendetails
• bis zu 500 Zeilen aus jedem SQL-Ergebnis, das der Assistent ausführt

Kerry sendet das nicht an Kerrys Server. Der KI-Client empfängt es auf Ihrem Computer und kann, wenn das Modell in der Cloud liegt, das Empfangene an seinen Anbieter senden.

Wie Sie im Chat fragen

Nennen Sie Projekt und Umgebung, nicht nur die technische Verbindungsbezeichnung (zum Beispiel postgres).

Beispiele:

• „im Projekt billing, Umgebung Entwicklung, liste die Tabellen“
• „in Billing / Entwicklung, welche Spalten hat public.products?“

Der Assistent nutzt die in Kerry gespeicherten Verbindungen. SQL ohne @alias läuft in einer eigenen Sitzung: es wechselt weder den Tab noch die Seitenleiste Entitäten. SQL mit @alias, zum Beispiel @billing.orders, nutzt den aktiven SQL-Tab, wie Abfrage ausführen: @projekt.tabelle folgt der Umgebung des Tabs. Der aktive Tab muss SQL sein und mit diesem Projekt und dieser Umgebung verknüpft. Nur gespeicherte Projekte erscheinen in Entitäten.

Was der Assistent tun kann

Sehen, wer verbunden ist

Der Abschnitt Beobachtbarkeit des Panels listet Apps, die mit Kerry sprechen.

• Die Zahl oben ist, wie viele Apps verbunden sind.
• Jede Karte ist eine App. Die Zahl auf der Karte ist, wie viele Datenbanksitzungen diese App geöffnet hat.
• Ein Hinweis erscheint, wenn eine App sich verbindet, trennt oder beginnt, eine Datenbank abzufragen, auch wenn das Panel geschlossen ist.

Um eine App zu entfernen: klicken Sie auf das Papierkorbsymbol der Karte (Verbindung trennen) und bestätigen Sie. Das beendet die Verbindung dieser App. Wenn eine andere App dieselbe Datenbank noch nutzt, bleibt sie. Wenn es die letzte war, schließt Kerry die MCP-Verbindungen für diese Datenbank.

Fehlerbehebung

• Der KI-Client erreicht Kerry nicht: stellen Sie sicher, dass die URL 127.0.0.1 verwendet, nicht localhost, und dass der Port HTTP-Port entspricht. Nach einer Portänderung JSON kopieren erneut verwenden.
• Der Client verbindet sich nach dem Einfügen des JSON nicht: schalten Sie den Server im Panel aus und wieder ein, oder starten Sie den KI-Client neu.
• Die Abfrage wurde abgelehnt: der Server ist schreibgeschützt. Schalten Sie den Vollmodus ein, wenn das Schreiben beabsichtigt ist. SHOW und EXPLAIN eines SELECT sind Lesezugriffe; FOR UPDATE und SELECT INTO sind es nicht.
• Die Datenbank wurde nicht gefunden: fragen Sie nach Projekt und Umgebung (Name oder @alias), nicht nach der Verbindungsbezeichnung.
• SQL mit @alias ist fehlgeschlagen: fokussieren Sie einen SQL-Tab, der mit diesem Projekt und dieser Umgebung verknüpft ist, wie bei Abfrage ausführen.

Wenn Sie das Token im Panel neu erzeugen, fügen Sie das JSON erneut in den Client ein.