Im Kerry Studio verbindet der lokale MCP-Server Ihre gespeicherten Verbindungen mit einem Desktop-KI-Client, etwa Claude Desktop, ChatGPT, Gemini, Conductor, Cursor, OpenCode und andere. Ohne ihn müssen Sie Tabellen auflisten, Spalten prüfen oder SQL im Chat ausführen, indem Sie Schema oder Ergebnisse von Hand einfügen.
Der Server lauscht nur auf Ihrem Computer. Passwörter, SSH und Zertifikate bleiben in der Anwendung geschützt. MCP legt sie nicht offen. Der Assistent erhält das Projekt, die Umgebung, den Datenbanktyp, den Datenbanknamen, das Schema und die Ergebnisse der Abfragen, die er ausführt. Kerry sendet das nicht an die Server von Sireeus. Was beim Assistenten ankommt, ist konfigurierbar: welche Projekte und Umgebungen der Server nutzen darf, und welche Werte in mcp.log und in der Antwort ausgeblendet werden. Der KI-Client kann das, was MCP zurückgegeben hat, dennoch an sein Cloud-Modell senden. Nutzen Sie ihn daher nur mit Agenten, denen Sie vertrauen.
Bevor Sie beginnen
Sie brauchen:
- Einen geöffneten workspace in Kerry Studio
- Einen Desktop-KI-Client, der MCP unterstützt
Das Panel öffnen
- Öffnen Sie einen workspace.
- Klicken Sie in der rechten Seitenleiste auf das Symbol MCP-Server.
- 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
- Schalten Sie im Panel MCP-Server aktivieren ein.
- Klicken Sie auf JSON kopieren.
- 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).
- Starten Sie den Client neu, wenn er Server nicht von selbst neu lädt.
Wenn der Client MCP als lokales Binary einträgt, etwa OpenCode, fügen Sie das JSON nicht ein. Verwenden Sie den Befehl unter So nutzen Sie es in OpenCode.
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"
}
}
}
}So nutzen Sie es in OpenCode
Einige Desktop-KI-Clients, etwa OpenCode, tragen einen MCP-Server standardmäßig als lokales Binary ein. Kerry ist kein Server dieses Typs. Er lauscht per HTTP auf Ihrem Computer. In solchen Apps tragen Sie Kerry über die URL ein, nicht als Befehl.
Das JSON im Format mcpServers gilt für Clients, die eine Konfiguration einfügen. In OpenCode, mit eingeschaltetem Server im Panel, führen Sie aus:
opencode mcp add kerry-studio --global --url http://127.0.0.1:18765/mcp --header 'Authorization=Bearer YOUR_TOKEN'Ersetzen Sie YOUR_TOKEN durch das Token, das JSON kopieren ins JSON setzt. Wenn Sie HTTP-Port geändert haben, verwenden Sie diesen Port in der URL. --global macht Kerry in jedem OpenCode-Projekt verfügbar. Wenn der Befehl dieses Flag ablehnt, hat Ihre Version es nicht. Führen Sie denselben Befehl ohne --global aus.
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 in der Sitzung des Assistenten. Ohne das gibt es kein Schema und kein SELECT. Die SQL-Tabs von Kerry 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.
Berechtigungen
In Kerry Studio schränken Berechtigungen ein, welche gespeicherten Projekte und Umgebungen der lokale MCP-Server verwenden darf. Ohne diese Einschränkung ist jede gespeicherte Verbindung für den Assistenten verfügbar. Standard sind alle Projekte und Umgebungen.
Schreibgeschützt sowie Lesen und Schreiben haben jeweils eigene Listen. So können Sie den Lesemodus auf dem ganzen Katalog lassen und im Vollmodus nur einige Projekte freigeben.
Öffnen Sie Berechtigungen über Konfigurieren im MCP-Panel, unter Einstellungen → MCP oder über die Befehlspalette (⌘K / CtrlK) unter MCP-Berechtigungen.
In Berechtigungen des MCP-Servers wechselt oben zwischen Schreibgeschützt und Lesen und Schreiben. Aktiv zeigt, welche dieser Listen das Panel gerade anwendet: Ist Schreibgeschützter Modus eingeschaltet, sitzt die Markierung auf Schreibgeschützt; ist er aus, sitzt sie auf Lesen und Schreiben. Eine Liste zu ändern lässt die andere unverändert.
In der Liste Lesen und Schreiben legt Standard fürs Schreiben Einfügen, Aktualisieren und Löschen für die Liste fest, standardmäßig alle drei an. Jedes Projekt oder jede Verbindung kann von diesem Standard abweichen. Die Änderung gilt bei der nächsten Anfrage des Assistenten.
Wenn Alle Projekte und Umgebungen zulassen eingeschaltet ist, nutzt der Server den ganzen Katalog in dieser Liste. Schalten Sie es aus, wenn Sie Projekte einzeln wählen wollen.
Ist der Schalter aus, hat jedes Projekt und jede Umgebung des Projekts ein eigenes Steuerelement. Unter Zugriff automatisch gewähren auf entscheiden Sie, ob Neue Projekte und ihre aktuellen Umgebungen und Neue Umgebungen in den Projekten von selbst dazukommen. Die Suche schränkt die Anzeige nach Projekt, SQL-Alias (@alias) oder Umgebung ein. Alle aktivieren und Alle deaktivieren gelten für das Sichtbare. Der Pfeil daneben macht dasselbe für eine Umgebung: Alle in einer Umgebung aktivieren oder Alle in einer Umgebung deaktivieren.
Wenn Sie Schreibgeschützter Modus im Panel ein- oder ausschalten, wendet Kerry die passende Liste an. Die Änderung gilt bei der nächsten Anfrage des Assistenten. Steht das Projekt nicht auf dieser Liste, öffnet Kerry die Verbindung nicht für den Assistenten. Eine Abfrage mit @alias, zum Beispiel @billing.orders, zeigt auf eine gespeicherte Verbindung und wird ebenfalls blockiert, wenn diese Verbindung nicht zugänglich ist.
Worauf der Assistent zugreifen kann
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
- Steuerung des ER-Diagramm-Tabs im geöffneten Workspace
Das ER-Diagramm steuern
Im Kerry Studio kann der Assistent den ER-Diagramm-Tab so nutzen, wie Sie es tun würden. Er öffnet den Tab für dieses Projekt und diese Umgebung, falls er noch nicht existiert, oder fokussiert den bereits offenen. Wenn dieser Tab noch nicht verbunden ist, verbindet die Nutzung des Diagramms (Synchronisieren, Filtern, Einpassen) ihn und aktualisiert das Schema. Der Assistent steuert nur ER-Diagramm-Tabs. Die MCP-Berechtigungen gelten für Öffnen, Synchronisieren und Umgebungswechsel. Er filtert auch Tabellen, ändert das Layout, fokussiert Beziehungen, passt den Zoom an und exportiert das Bild. Beim Export speichert Kerry die Datei im Ordner unter Einstellungen → MCP. Standard ist der Schreibtisch. Wenn das nicht gelingt, fragt Kerry, wo gespeichert werden soll. Der Assistent erhält den vollständigen Pfad. MCP kann den Ordner nicht wählen.
SQL ohne @alias bleibt in einer eigenen Sitzung und wechselt den Tab nicht. SQL mit @alias, zum Beispiel @billing.orders, nutzt den aktiven SQL-Tab.
Während der Assistent das Diagramm steuert, zeigt der Tab die Marke MCP. Die Fußzeile des Workspace zeigt steuert die UI.
Beispiele:
- „Öffnen Sie das ER-Diagramm für das Projekt billing in der Umgebung Entwicklung.“
- „Im Diagramm zeigen Sie nur die Tabellen, die mit
public.ordersin Beziehung stehen.“ - „Passen Sie das Diagramm an und exportieren Sie es als PNG.“
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
| Modus | Der Assistent kann |
|---|---|
| Schreibgeschützt | Verbindungen auflisten, ein Projekt und eine Umgebung finden, Tabellen und Spalten prüfen, im Schema suchen, lesendes SQL ausführen, den ER-Diagramm-Tab öffnen und steuern |
| Voll | Alles oben, plus das in Berechtigungen freigegebene schreibende SQL (Einfügen, Aktualisieren und Löschen) |
Sehen, wer verbunden ist
Der Abschnitt Beobachtbarkeit des Panels listet Apps, die mit Kerry sprechen.
- Die Zahl unten 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.
Den Server prüfen
In Kerry Studio schreibt die Datei mcp.log jeden Austausch mit dem Assistenten, mit App und Sitzung. In der Datei ist REQUEST die Anfrage, die der Assistent gesendet hat, einschließlich des SQL. RESPONSE ist, was Kerry zurückgegeben hat. Öffnen Sie die Datei in der Kopfzeile Beobachtbarkeit des MCP-Panels oder unter Einstellungen, MCP.
Kerry blendet den Wert aus, wenn der Feldname dem Begriff der Liste entspricht oder ihn enthält. Es blendet den Wert auch aus, wenn das SQL der Spalte einen anderen Namen gibt, sie in einem Ausdruck verwendet, oder das Feld in JSON liest und unter einem anderen Namen zurückgibt. Das gilt in PostgreSQL, MySQL, Oracle und SQLite.
Standardmäßig wird ausgeblendet:
- In der Datei und in der Antwort an den Assistenten: Werte von Passwörtern, Tokens, Autorisierung und privaten Schlüsseln, wenn das Feld zur Standardliste dieses Ziels passt.
- Nur in der Datei mcp.log: Werte von Feldern, deren Name email ist oder enthält, und E-Mails im Text, auch wenn sie nicht aus einer Spalte namens email stammen.
- Nur in der Antwort an den Assistenten: Verbindungszeichenfolgen, Schlüssel und Fehlertexte, die Host, Benutzer, Pfad oder Passwort zeigen würden. Das hängt nicht vom Spaltennamen ab.
Das SQL steht in mcp.log, weil die Prüfung die Anfrage so speichert, wie sie angekommen ist. Nutzen Sie die Datei, um zu prüfen, ob eine Spalte aus Ihrer Datenbank im RESPONSE noch mit dem echten Wert erscheint. Das zählt für Felder, die Kerry nicht kennt, etwa einen vollständigen Namen oder ein Dokument. Wenn sie erscheint, fügen Sie unter Geschwärzte Werte im MCP-Panel oder in der Befehlspalette (⌘K / CtrlK) das Feld hinzu, wählen das Ziel (Datei, Assistent oder beides) und ob die Übereinstimmung gleich oder enthält ist.
Wenn Sie die Protokolle ausschalten, bleibt diese Wahl erhalten. Wenn die Datei schon existiert, fragt Kerry nach und entfernt sie.
Fehlerbehebung
- Der KI-Client erreicht Kerry nicht: stellen Sie sicher, dass die URL
127.0.0.1verwendet, nichtlocalhost, 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.
- OpenCode verbindet sich nicht: Kerry ist kein Binary-MCP. Verwenden Sie
opencode mcp addmit--urlund dem HeaderAuthorization. Wenn der Befehl--globalablehnt, lassen Sie das Flag weg. - Die Abfrage wurde abgelehnt: der Server ist schreibgeschützt, oder diese Vorgangsart ist in Berechtigungen aus. Schalten Sie den Vollmodus ein, wenn das Schreiben beabsichtigt ist, und schalten Sie Einfügen, Aktualisieren oder Löschen passend zum SQL ein.
SHOWundEXPLAINeinesSELECTsind Lesezugriffe;FOR UPDATEundSELECT INTOsind es nicht. - Die Datenbank wurde nicht gefunden: fragen Sie nach Projekt und Umgebung (Name oder
@alias), nicht nach der Verbindungsbezeichnung. - SQL mit
@aliasist fehlgeschlagen: fokussieren Sie einen SQL-Tab, der mit diesem Projekt und dieser Umgebung verknüpft ist, wie bei Abfrage ausführen. - Das ER-Diagramm wurde nicht geöffnet oder die Umgebung abgelehnt: prüfen Sie Berechtigungen und nennen Sie Projekt und Umgebung aus dieser Liste. Das MCP-Panel gibt es nur bei einem geöffneten Workspace.
Wenn Sie das Token im Panel neu erzeugen, fügen Sie das JSON erneut in den Client ein.