Lokalen Server hinzufügen
Sie benötigen einen vorhandenen, geprüften MCP-Server, etwa ein lokales server.mjs. Ersetzen Sie die Beispielpfade durch tatsächliche geprüfte absolute Pfade. add kann eine gleichnamige Konfiguration überschreiben; prüfen Sie vorhandene Einträge zuerst.
lurus mcp add local-docs --command node --args /absolute/path/server.mjs --cwd /absolute/path/project --timeout 15000 --project
lurus mcp list
add speichert die Konfiguration, startet aber noch keinen Server. Ohne --project wird sie global gespeichert; mit dem Flag im aktuellen Projekt. Die entsprechende .lurus/settings.json sieht so aus:
{
"mcpServers": {
"local-docs": {
"type": "stdio",
"command": "node",
"args": ["/absolute/path/server.mjs"],
"cwd": "/absolute/path/project",
"env": { "DOCS_MODE": "readonly" },
"timeout": 15000,
"trust": false,
"includeTools": [],
"excludeTools": []
}
}
}
Global verwenden Sie denselben Aufbau unter ~/.lurus/settings.json. Prüfen Sie Programm, Argumente, Umgebung und Arbeitsverzeichnis. DOCS_MODE hat nur eine Wirkung, wenn der Server diese Variable unterstützt; sie garantiert keinen Schreibschutz durch die CLI. Starten Sie eine neue Sitzung und prüfen Sie die Freigabe zum Start des Projektservers.
HTTP, SSE und Header
Fiktive Remoteendpoints, nicht ungeprüft aufrufen:
lurus mcp add remote-docs --url https://example.invalid/mcp --type http --timeout 15000
lurus mcp add legacy-docs --url https://example.invalid/sse --type sse --project
Geben Sie genau eines von --command oder --url an. Ohne --type gilt bei einer URL http, bei einem lokalen Befehl stdio. --args <args...>, --env <KEY=VALUE...> und --cwd sind nur lokal verfügbar; --header <KEY=VALUE...> nur für Remote-Server. Schlüssel und Wert werden am ersten = getrennt. Schreiben Sie keine echten Secrets in Beispiele, Shell-History oder Repositorys.
Die CLI speichert Headerwerte geschützt und hinterlegt headerRefs in den Einstellungen statt Klartextsecrets. Diese Referenzen gelten für den jeweiligen Geltungsbereich, Server und Projektpfad; erzeugen oder bearbeiten Sie sie nicht von Hand. Verwenden Sie headers nur für bewusst nicht sensible Werte. Header werden auf ungültige Zeichen geprüft. --timeout erwartet eine positive ganze Zahl in Millisekunden; in der Konfiguration ist eine positive endliche Zahl zulässig. Standardmäßig gelten 15.000 ms.
Vollständige Optionen und Toolfilter
Optionen für lurus mcp add: --command, --url, --type, --args, --env, --cwd, --header, --timeout, --trust, --project. Settings beschreibt zusätzlich headers, headerRefs, includeTools, excludeTools.
Filterbeispiel für tatsächliche unqualifizierte Servertoolnamen:
{
"includeTools": ["search_docs", "read_doc"],
"excludeTools": ["read_doc"]
}
Übernehmen Sie dieses Fragment in das vorhandene Serverobjekt, nicht als vollständige Settingsdatei. Eine leere Einschlussliste schränkt nicht ein; die Ausschlussliste hat Vorrang. Im Beispiel bleibt nur search_docs verfügbar. Verwenden Sie exakte Namen, keine Globs und keine qualifizierten Namen wie mcp__server__tool. Der Server muss die genannten Tools tatsächlich anbieten.
Startconsent versus Trust
Projektserver benötigen vor dem Start eine Freigabe. Diese verleiht ihren Tools keinen Vertrauensstatus: Projektserver bleiben auch bei trust: true nicht vertrauenswürdig. Globales trust: true oder --trust ist eine bewusste Vertrauensfreigabe für die globale Serverquelle, aber kein Sicherheitsnachweis. Zusätzliche Werkzeug-, Berechtigungs- und Rollenfilter gelten weiterhin; eigene Agenten erhalten dadurch keine MCP-Tools.
Ein Projektobjekt ersetzt einen gleichnamigen globalen Server vollständig. Wird die Projektquelle abgelehnt, ist kein automatischer Start des globalen Servers garantiert. URLs müssen HTTP oder HTTPS verwenden. Die vorhandenen Zielprüfungen bieten keinen umfassenden SSRF-Schutz; prüfen Sie Ziele und Datenfreigabe selbst.
Stdio-Server erhalten zugelassene Umgebungsvariablen sowie konfigurierte env-Werte. LURUS_MCP_PASS_ENV ergänzt kommaseparierte Variablennamen. Jeder freigegebene Wert ist für den Serverprozess vollständig sichtbar. Schlüssel und Tokens werden nicht automatisch allgemein vererbt.
Laufzeit verwalten und entfernen
/mcp
/mcp restart local-docs
/mcp refresh-tools
/mcp zeigt den Status. restart verbindet neu, aktualisiert aber nicht automatisch die sichtbaren Tooldefinitionen. refresh-tools erneuert diese Definitionen; danach kann ein Cachetreffer ausbleiben. Starten Sie bei neuen Servern oder Konfigurationsänderungen vorzugsweise eine neue Sitzung.
lurus mcp remove local-docs --project
lurus mcp remove remote-docs
lurus mcp list
Der Geltungsbereich muss zum Eintrag passen. remove entfernt Konfiguration und zugehörige Headerreferenzen, soweit möglich. Prüfen Sie gemeldete Fehler. Validierungs- und Settingsfehler sowie unbekannte Einträge beim Entfernen enden mit Exitcode 1.
Fehlersuche
Startet der Server nicht, prüfen Sie Zustimmung, Befehl, absolute Pfade, Arbeitsverzeichnis und Timeout. Bei falscher Toolauswahl prüfen Sie Einschluss- und Ausschlussnamen und verwenden Sie refresh-tools. Projektserver bleiben absichtlich ohne globale Vertrauensfreigabe. Bei ungültigen Headerreferenzen nutzen Sie die CLI im richtigen Geltungsbereich, statt gespeicherte Daten zu manipulieren. Geben Sie fehlende Umgebungsvariablen gezielt frei, nicht sämtliche Secrets.
Weiter: Berechtigungen, Einstellungen.