MCP-Server¶
Ein MCP-Server gibt Chats und Agenten Tools: ein Repository durchsuchen, ein Ticket anlegen, eine Datei lesen. Sie registrieren den Server einmal; Fadenstack verbindet sich mit ihm, listet seine Tools auf und führt ein Tool aus, wenn ein Modell es anfordert – nach den Regeln, die Sie festlegen.

Bevor Sie beginnen¶
- Das Modul MCP ist eingeschaltet (Einstellungen → Module; siehe Module). Seine Seiten finden Sie unter Erweiterungen → MCP Hub.
- Die Adresse des Servers oder der Befehl, der ihn startet, und die Zugangsdaten, die er braucht. Ein Server, der MCP über HTTP spricht, kann auch als Container auf dem Fadenstack-Server selbst laufen (siehe Container).
- Die Modelle, mit denen Ihre Benutzer Tools nutzen, können Tools aufrufen: Bei Ihren eigenen Modellen ist Tool-Aufrufe in den Engine-Einstellungen der Bereitstellung eingeschaltet, bei einem externen Provider Tools des Gateways anbieten (siehe Externe Provider).
Einen Server registrieren¶

- Öffnen Sie Erweiterungen → MCP Hub und wählen Sie Server registrieren.
- Geben Sie unter Servername einen Namen ein und wählen Sie den Transport.
- Geben Sie die Server-URL (HTTP) oder den Befehl (Stdio) ein.
- Wählen Sie den PII-Modus (siehe Personenbezogene Daten).
- Fügen Sie unter Header (HTTP) oder Umgebungsvariablen (Stdio) hinzu, was der Server für den Zugang
braucht, z. B.
Authorization: Bearer <token>. - Wählen Sie Registrieren.
Fadenstack verbindet sich mit dem Server und listet seine Tools auf. Der Server erscheint dann als aktiv, mit der Zahl seiner Tools.
Ein Server, der als Container auf dem Fadenstack-Server läuft, ist unter seinem Namen erreichbar, z. B.
http://mcp-github:8080/mcp, sobald der Container im Netzwerk fadenstack_default ist. Beim Registrieren des
Servers kommt der Container dorthin, wenn seine Klasse MCP oder TENANT_APP ist (siehe
Container); jeder andere Container bleibt, wo er ist. Geben Sie ihm vor dem
Registrieren in seiner Zeile eine dieser Klassen, oder wählen Sie das Netzwerk, wenn Sie den Container
erstellen oder bearbeiten.
Mehr zu den Feldern
| Feld | Was Sie eingeben |
|---|---|
| Servername | Der Name, den die Konsole anzeigt. |
| Transport | Streamable HTTP für aktuelle Server, SSE (älteres HTTP) für ältere oder Stdio (Befehl) für einen Server, den der MCP-Dienst selbst startet. |
| Server-URL | Bei HTTP: die MCP-Adresse des Servers, meist mit /mcp (oder /sse) am Ende, z. B. https://tools.example.internal/mcp. |
| Befehl | Bei Stdio: der Befehl und seine Argumente, z. B. uvx mcp-server-time. |
| Tool-Präfix | Ein kurzer, eindeutiger Name aus Kleinbuchstaben, Ziffern, _ und -, bis zu 32 Zeichen. Die Tools des Servers heißen mcp.<prefix>.<tool>, z. B. mcp.github.search_repositories: Tool-Regeln und das Audit nutzen diesen Namen, das Modell bekommt ihn als mcp_github_search_repositories, einen Namen, den jeder Anbieter annimmt. Bleibt das Feld leer, wird er aus dem Servernamen gebildet. |
| PII-Modus | Was der Server von personenbezogenen Daten sehen darf (siehe Personenbezogene Daten). |
| Zeitlimit (Sekunden) | Wie lange der Verbindungsaufbau und jeder Tool-Aufruf dauern dürfen: 5 bis 600 Sekunden. |
Alle nutzen diese Zugangsdaten
Header und Variablen werden verschlüsselt gespeichert und nie wieder angezeigt; die Konsole listet nur ihre Namen. Jede Person, deren Chat die Tools des Servers nutzt, handelt mit diesen Zugangsdaten. Geben Sie dem Server ein Token mit nur den Rechten, die die Tools brauchen, wo möglich nur mit Leserechten.
Netzwerk durchsuchen sucht auf einem Host (einem Namen oder einer IPv4-Adresse) in einem Portbereich nach MCP-Servern und bietet die gefundenen zur Registrierung an.
Die Seite eines Servers¶
Wählen Sie einen Server in der Liste aus, um seine Seite zu öffnen. Sie zeigt Status, Transport, Präfix, PII-Modus, Zeitlimit und welche Header gesetzt sind und, wenn die letzte Verbindung fehlgeschlagen ist, Der letzte Verbindungsversuch ist fehlgeschlagen mit dem Grund.
| Um | So geht's |
|---|---|
| jedes Tool zu sehen, das der Server anbietet | Entdeckte Tools listet sie auf. |
| ein Tool für alle aus- (oder ein-)zuschalten | Der Schalter Aktiviert neben dem Tool, unter Entdeckte Tools. |
| den ganzen Server aus- oder einzuschalten | Aktiviert oben. |
| die Tools neu aufzulisten | Aktualisieren. |
| die Verbindung zu prüfen und die Tools zu zählen | Testen. |
| URL oder Befehl, Zeitlimit, PII-Modus sowie Header oder Variablen zu ändern | Bearbeiten (siehe unten). |
| ihn mit allen seinen Tools zu entfernen | Server löschen. |

Unter Bearbeiten wird ein gespeicherter Header einzeln ersetzt oder entfernt, ohne dass Sie die anderen neu eingeben müssen. Beim Speichern wird der Server neu verbunden, und seine Tools werden neu aufgelistet.
Wer die Tools nutzen kann¶
Die Tools eines registrierten, aktivierten Servers stehen jedem Chat in der Organisation und den Agenten zur Verfügung. Eine Liste von MCP-Servern pro Person gibt es nicht. Was ausgeführt wird, steuern Sie so:
- Tools ausschalten unter Entdeckte Tools, für Tools, die niemand nutzen soll.
- Tool-Regeln unter Agenten → Governance: ein Tool verbieten, es vor der Ausführung von der Person
bestätigen lassen oder es erlauben, nach Name oder Muster, z. B.
mcp.github.*(siehe Richtlinien und personenbezogene Daten). - Tool-Klassen unter Agenten → Governance: festlegen, ob ein Tool nur liest, schreibt oder löscht. Der Tool-Modus, den Benutzer im Chat wählen, richtet sich nach dieser Klasse. Ein Tool, das niemand eingestuft hat, fragt immer, bevor es läuft.
- Die Server-Tools eines Agenten: Jeder Agent erhält, was ein Chat erhält, nur die Tools, die Sie aufführen
(z. B.
mcp.github.*), oder keine (siehe Agenten und Add-ins). Die Begrenzung gilt, wenn ein Tool läuft, nicht nur bei dem, was dem Modell angeboten wird: Ein Aufruf eines Tools außerhalb davon wird abgelehnt und erreicht den Server nie.
Wie Benutzer die Tools im Chat erhalten¶

- Jedes MCP-Tool ist in einem neuen Chat zunächst ausgeschaltet. Jedes Tool, das dem Modell angeboten wird, braucht in jeder Nachricht Platz; deshalb werden nur die Tools gesendet, die ein Chat braucht.
- Ein Tool wird eingeschaltet, wenn die Person es im Bereich Tools des Chats (der Schraubenschlüssel) einschaltet, wenn ihre Nachricht es nennt oder wenn das Modell es mit seiner Tool-Suche findet. Einmal eingeschaltet, bleibt es für diesen Chat eingeschaltet.
- Der Tool-Modus entscheidet, was ohne Nachfrage laufen darf: Aus, Nur lesen, Fragen (damit beginnt jeder Chat: Tools, die lesen, laufen, jedes andere Tool wartet auf die Zustimmung der Person) oder Automatisch (Tools, die lesen oder schreiben, laufen; zerstörende und nicht eingestufte fragen nach).
Tools im Chat erklärt das für die Benutzer, die damit arbeiten.
Die Tools eines gehosteten Servers eingrenzen
Gehostete Server mit vielen Tools lassen sich oft über einen Header eingrenzen. Der Server von GitHub z. B.
akzeptiert X-MCP-Toolsets: repos oder X-MCP-Readonly: true.
Personenbezogene Daten (PII-Modus)¶
Ist das Modul Datenschutz (PII) eingeschaltet, kann die PII-Richtlinie des Chats personenbezogene Daten durch Platzhalter ersetzen, bevor ein Modell sie sieht. Was ein Tool dann erhält, hängt vom PII-Modus seines Servers ab:
| Modus | Das Tool erhält |
|---|---|
| Zulassen (keine Filterung) | Die echten Werte. |
| Schwärzen (personenbezogene Daten entfernen) | Die Platzhalter; personenbezogene Daten, die in den Argumenten des Aufrufs gefunden werden, werden ebenfalls entfernt. |
| Blockieren (ablehnen, wenn personenbezogene Daten gefunden werden) | Nichts: Der Aufruf wird abgelehnt, wenn seine Argumente personenbezogene Daten enthalten. |
Wählen Sie für einen Server außerhalb Ihrer Organisation Schwärzen oder Blockieren. Diese beiden Modi brauchen das PII-Modul: Ist es ausgeschaltet oder nicht erreichbar, wird der Aufruf abgelehnt, es wird nichts gesendet, und der Chat zeigt, dass die Prüfung auf personenbezogene Daten nicht laufen konnte. Starten Sie das PII-Modul oder stellen Sie, falls die Prüfung für diesen Server nicht nötig ist, seinen PII-Modus auf Zulassen. Die Seite des Servers und die Dialoge Registrieren und Bearbeiten zeigen eine Warnung, solange das Modul aus ist.
Ein Server, den Sie bei ausgeschaltetem PII-Modul registrieren, startet mit Zulassen, bei laufendem Modul mit Schwärzen. Bestehende Server behalten ihren Modus.
Wenn es nicht funktioniert¶
| Sie sehen | Was Sie tun |
|---|---|
| „… ist registriert, konnte aber nicht verbunden werden: … Öffnen Sie den Server, um die URL oder die Zugangsdaten zu korrigieren.“ | Der Server ist gespeichert, steht aber auf Fehler. Öffnen Sie ihn, lesen Sie den Grund und wählen Sie Bearbeiten. Die häufigen Gründe stehen in den nächsten drei Zeilen. |
Der Grund lautet 401 Unauthorized |
Der Server braucht Zugangsdaten: Fügen Sie sie als Header hinzu, z. B. Authorization: Bearer <token>. |
Der Grund lautet 404 |
Unter dieser Adresse gibt es keinen MCP-Endpunkt: Adressen für Streamable HTTP enden meist auf /mcp, Adressen für SSE auf /sse. |
Der Grund lautet Connection refused |
Unter dieser Adresse lauscht nichts, oder der Fadenstack-Server erreicht sie nicht. |
Der Grund lautet Cannot reach bei einem Container auf dem Fadenstack-Server |
Der Container ist nicht im Netzwerk fadenstack_default. Wählen Sie dieses Netzwerk unter Netzwerke, wenn Sie den Container bearbeiten, und wählen Sie dann auf der Seite des Servers Aktualisieren. |
| „… is a link-local address“ oder „… a cloud metadata address“ beim Registrieren, Bearbeiten oder Durchsuchen | Die Adresse liegt, oder ihr Name löst sich auf, in 169.254.0.0/16 oder fe80::/10, beim Metadatendienst einer Cloud oder auf 0.0.0.0. Solche Adressen ruft Fadenstack nicht auf; der MCP-Dienst prüft vor dem Verbinden noch einmal, denn ein Name kann später auf eine andere Adresse zeigen. Geben Sie die eigene Adresse des Servers ein: Adressen in Ihrem Netzwerk, auf diesem Server und Containernamen gehen. |
| „MCP-Server … ist …“ im Dashboard | Der Server ist fehlerhaft oder getrennt, und seine Tools stehen Chats nicht zur Verfügung. Öffnen Sie ihn und wählen Sie Testen. |
| Benutzer sehen im Chat keine Tools | Prüfen Sie, ob der Server aktiviert ist, ob seine Tools aktiviert sind und ob das Modell, mit dem sie chatten, Tools aufrufen kann. |