MCP-Server

Ein MCP-Server ist ein kleines Programm, das dem Assistenten zusätzliche Tools bietet — ein Ticketsystem lesen, eine Datenbank abfragen, ein Design-Tool steuern. Pia kann MCP-Server starten, die auf deinem eigenen Computer laufen, und deren Tools zusammen mit seinen eigenen an den Assistenten weitergeben. Öffne die Liste über Einstellungen → Assistent → MCP-Server.

MCP-Server, die du hier hinzufügst, laufen nur auf diesem Computer. Pia startet jeden als lokales Programm und spricht mit ihm über dessen Ein- und Ausgabe. Ein Server, der im Internet hinter einer URL liegt, kann nicht hinzugefügt werden — Pia lehnt das ab mit „Entfernte Server werden nicht unterstützt — nur Server, die Pia auf diesem Computer startet.“ Tools, die der Pia-Server liefert, sind eine andere Sache und werden unter Plugins verwaltet.

Einen Server hinzufügen

Server hinzufügen öffnet ein Formular mit fünf Feldern:

Feld	Was hinein gehört
Name	Wie du den Server nennen möchtest. Bestimmt auch das Tool-Präfix.
Befehl	Das Programm, mit dem Pia den Server startet — `npx`, `uvx`, `python`, oder ein vollständiger Pfad zu einer ausführbaren Datei.
Argumente	Eins pro Zeile.
Umgebungsvariablen	Ein `SCHLÜSSEL=Wert` pro Zeile.
Arbeitsverzeichnis	Optional. Der Ordner, in dem der Server startet.

Umgebungswerte werden für dein Windows-Konto verschlüsselt gespeichert, sodass ein API-Token, das du dort einträgst, von keinem anderen Konto auf demselben Rechner gelesen werden kann und nie mit Pia Cloud synchronisiert wird.

Das Formular aus JSON ausfüllen

Die meisten MCP-Server werden als JSON-Schnipsel für einen anderen Client dokumentiert. Statt ihn Feld für Feld abzutippen, füge ihn bei Konfiguration einfügen ein und klicke auf Aus JSON übernehmen. Pia akzeptiert einen mcpServers-Eintrag oder ein einfaches Objekt mit einem command darin und liest daraus Name, Befehl, Argumente und Umgebungsvariablen aus:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "C:\\Work"]
    }
  }
}

Füge jeweils einen Server auf einmal ein. Ein Schnipsel mit mehreren wird abgelehnt mit „Darin steht mehr als ein Server. Bitte einzeln hinzufügen.“ Das Formular bleibt nach dem Einlesen des JSON bearbeitbar, sodass du einen Pfad korrigieren oder ein Token ergänzen kannst, bevor du speicherst.

Die Verbindung testen, bevor du speicherst

Verbindung testen startet den Server sofort, fragt ihn, welche Tools er anbietet, und meldet das Ergebnis zurück. Das ist der schnellste Weg, einen falschen Pfad oder ein fehlendes Token zu finden — die Alternative wäre, es erst zu bemerken, wenn der Assistent zum ersten Mal nach einem Tool greift.

Bei Erfolg steht dort „Verbunden. N Tool(s) verfügbar.“, und die Tool-Liste darunter wird gefüllt.
Bei Fehlschlag steht dort „Verbindung fehlgeschlagen: …“ mit dem Grund, den der Server angegeben hat.

Beim ersten Mal kann Verbindung testen bis zu 90 Sekunden dauern. Ein Befehl wie npx -y <Paket> lädt den Server erst herunter, bevor er antwortet, und das geschieht nur beim ersten Lauf.

Festlegen, welche Tools ein Server anbieten darf

Hake unter Verfügbare Tools die Tools an, die der Assistent haben soll. „Nur angehakte Tools werden dem Assistenten angeboten.“ heißt genau das: Ein Tool, das du abhakst, ist nicht nur nicht genehmigt — der Assistent erfährt nie, dass es existiert, und kann nicht darum bitten, es auszuführen. Alle und Keine setzen die ganze Liste auf einmal, und ein Tool, das etwas löschen kann, ist mit kann löschen markiert.

Ein Server, den du noch nicht getestet hast, bietet alle seine Tools an. Die Liste zeigt „Teste die Verbindung, um die Tools dieses Servers zu sehen.“, bis Pia sie gesehen hat, und bis du sie eingrenzst, steht der gesamte Satz des Servers zur Verfügung.

Tool-Namen tragen das Präfix des Servers

Jedes Tool eines lokalen MCP-Servers wird in <prefix>__<tool> umbenannt, bevor der Assistent es sieht — ein search-Tool auf einem Server namens „Jira Cloud“ wird zu jira_cloud__search. Das Präfix stammt aus dem Namen des Servers, klein geschrieben, wobei alles, was kein Buchstabe oder keine Ziffer ist, zu einem Unterstrich wird; es wird im Formular als Tool-Präfix angezeigt, damit du siehst, wie der Assistent das Tool nennen wird.

Das Präfix sorgt dafür, dass zwei Server, die beide ein search-Tool anbieten, gleichzeitig eingeschaltet sein können, ohne zu kollidieren, und keiner kann eines von Pias eigenen Tools überdecken.

Die Detailseite eines Servers lesen

Wählst du einen Server in der Liste aus, öffnet sich rechts seine Detailseite. Sie zeigt:

Ob er Verbunden, Deaktiviert, Wird gestartet… oder Nicht verbunden ist — ein Server, der nicht starten konnte, nennt den Grund in derselben Zeile.
Seinen Befehl, seine Argumente und sein Arbeitsverzeichnis.
Die Namen seiner Umgebungsvariablen, nie ihre Werte.
Jedes Tool, das er anbietet, wobei die von dir gesperrten Tools als gesperrt markiert sind, dazu eine Zusammenfassung „N von M Tool(s) freigegeben“.

Verbindung testen steht auf dieser Seite neben Bearbeiten und Löschen, sodass du auch bei einem ausgeschalteten Server abfragen kannst, was er anbietet, ohne ihn erst einzuschalten.

Ein Server, der nicht läuft, zeigt die Tools, die beim letzten Lauf freigegeben waren, entsprechend gekennzeichnet. Ein Server, den Pia noch nie gestartet hat, zeigt „Starten Sie diesen Server oder verwenden Sie „Verbindung testen“, um seine Tools zu sehen.“

Einen Server ausschalten und entfernen

Jede Zeile in der Liste hat einen Schalter. Schaltest du einen Server aus, wird er gestoppt und seine Tools werden dem Assistenten entzogen; schaltest du ihn wieder ein, startet er erneut. Wenn du einen laufenden Server bearbeitest, speichert das und startet ihn neu, was das Formular als „Wird gespeichert… der Server startet neu.“ meldet.

Löschen entfernt den Server endgültig und fragt vorher nach — „X“ entfernen? Die Tools stehen dem Assistenten dann nicht mehr zur Verfügung.“

Wenn ein Server nicht startet

Der Grund, den Pia meldet, kommt vom Server selbst; das sind die häufigsten:

Der Befehl steht nicht in deinem PATH. Gib stattdessen den vollständigen Pfad zur ausführbaren Datei statt ihres bloßen Namens an.
Eine benötigte Umgebungsvariable fehlt. Die meisten Server, die einen kostenpflichtigen Dienst ansprechen, brauchen ein API-Token unter Umgebungsvariablen.
Das Arbeitsverzeichnis existiert nicht. Lass es leer, außer die Dokumentation des Servers verlangt ausdrücklich eines.
Der erste Lauf lädt noch herunter. Ein npx -y-Befehl holt das Paket erst, bevor er antwortet; teste erneut, sobald das erledigt ist.

Nächste Schritte

Um festzulegen, welche dieser Tools ohne Nachfrage laufen dürfen, siehe Tool-Berechtigungen. Für die Tools, die dein Pia-Server liefert, siehe Plugins.