Eigenen MCP-Server hinzufügen

Verbinden Sie einen Remote-MCP-Server per URL und legen Sie fest, was der Runner Agent mit jedem seiner Tools tun darf.

Wenn ein Dienst, den Sie nutzen, einen MCP-Server hat, können Sie seine Tools dem Runner Agent geben. Fügen Sie die Server-URL ein. Runner findet die Tools des Servers. Dann legen Sie fest, was der Agent mit jedem Tool tun darf.

Nutzen Sie das für einen Dienst, der nicht unter Tools verbinden steht, etwa Ihr eigenes ERP, ein Lagersystem oder ein Tool, das Ihr Team betreibt.

Bevor Sie beginnen

Einstiegspfad: Projekt → Agent → Tools → Eigenen MCP-Server hinzufügen

Sie benötigen:

die Rolle Shop-Inhaber oder Admin. Andere Mitglieder können keinen Server hinzufügen, ändern oder entfernen;
die URL eines Remote-MCP-Servers, etwa https://example.com/mcp; und
den API-Schlüssel und seinen Header-Namen, falls der Server einen Schlüssel braucht.

Der Server muss diese Bedingungen erfüllen:

Er muss im öffentlichen Internet erreichbar sein. Runner verbindet sich nicht mit localhost oder mit einer privaten Netzwerkadresse.
Er muss den MCP-HTTP-Transport (Streamable HTTP) nutzen. Runner führt keinen lokalen Kommandozeilen-Server (stdio) für Sie aus.
Er muss ohne Anmeldung oder mit einem API-Schlüssel in einem Request-Header arbeiten. OAuth ist noch nicht verfügbar.

Ein Shop kann bis zu 10 MCP-Server haben. Runner übernimmt bis zu 100 Tools pro Server.

Wichtig: Runner kann nicht prüfen, was ein eigener Server mit Ihren Daten macht. Fügen Sie nur Server hinzu, die Sie betreiben oder gut kennen.

Einen Server hinzufügen

Öffnen Sie Ihr Projekt und wählen Sie Agent → Tools.
Wählen Sie in der Zeile Eigenen MCP-Server hinzufügen die Schaltfläche Server hinzufügen.
Geben Sie die Server-URL ein. Oder fügen Sie die JSON-Konfiguration aus der Server-Doku in JSON-Konfiguration einfügen ein. Runner übernimmt die URL und den Schlüssel-Header aus der Konfiguration.
Optional: Geben Sie im Feld Name einen Namen ein. Wenn Sie es leer lassen, verwendet Runner den Namen des Servers. Runner zeigt diesen Namen im Chat, wenn es ein Tool nutzt.
Wählen Sie unter Wie Runner sich anmeldet die Option Keine Anmeldung oder API-Schlüssel. Füllen Sie für API-Schlüssel die Felder Header-Name und Schlüssel aus, etwa mit Authorization und Bearer sk-…. Runner speichert den Schlüssel verschlüsselt. Niemand, auch Sie nicht, kann ihn wieder auslesen.
Welche Agenten es nutzen dürfen zeigt Alle Agenten. Sie können das später pro Agent ändern.
Wählen Sie Ich vertraue diesem Server.
Wählen Sie Verbinden und Tools finden. Runner verbindet sich mit dem Server und listet seine Tools auf.
Wählen Sie für jedes Tool eine Regel. Wählen Sie dann die Schaltfläche mit dem Servernamen und hinzufügen, zum Beispiel ERP hinzufügen.

Wenn der Server hinzugefügt ist, erscheint er unter Verbunden mit dem Tag Eigener MCP.

Festlegen, was jedes Tool darf

Jedes Tool bekommt eine von drei Regeln:

Erlauben: Der Agent nutzt das Tool, ohne Sie zu fragen.
Erst fragen: Der Agent zeigt Ihnen den Aufruf im Chat. Das Tool läuft erst, wenn Sie ihn freigeben.
Aus: Der Agent kann das Tool nicht nutzen.

Runner schätzt für jedes Tool anhand seines Namens eine Startregel und gruppiert die Tools nach dieser Regel:

Gruppe	Startregel	Tool-Namen, die Runner hier einordnet
Liest Daten	Erlauben	Namen, die mit einem Lesewort wie `list`, `get` oder `search` beginnen. Außerdem jeder Name, den Runner nicht erkennt.
Ändert Daten	Erst fragen	Namen, die `send`, `reply`, `remove`, `publish`, `pay`, `charge`, `refund` oder `price` enthalten.
Löscht Daten	Aus	Namen, die `delete` oder `trash` enthalten.

Prüfen Sie die Regel jedes Tools, bevor Sie den Server hinzufügen. Runner liest nur den Namen des Tools, nicht, was das Tool tut. Ein Tool wie update_inventory oder create_customer startet mit Erlauben in Liest Daten. Der Agent könnte dann Daten ändern, ohne Sie zu fragen. Stellen Sie solche Tools auf Erst fragen oder Aus.

Sie können die Regel jedes Tools ändern, bevor Sie den Server hinzufügen. Später ändern Sie sie unter Was jeder Agent darf auf der Seite des Servers. Ein Tool, das der Server später hinzufügt, startet mit Erst fragen, oder mit Aus, wenn sein Name delete oder trash enthält.

Die Regeln gelten für jeden Chat in diesem Projekt. Runner prüft sie bei jedem Tool-Aufruf.

Einen Server verwalten

Öffnen Sie den Server unter Verbunden in Agent → Tools. Seine Seite hat diese Steuerelemente:

Steuerelement oder Angabe	Was es tut
Server-URL und Kopier-Schaltfläche	Unter Verbindung. Server-URL kopieren kopiert die URL.
Status	Zeigt, wann der Server zuletzt geantwortet hat, oder Noch nicht geprüft.
Anmeldung	Zeigt Keine Anmeldung oder die letzten vier Zeichen des Schlüssels. Schlüssel hinzufügen oder Ersetzen ändert den Schlüssel.
Verbindung testen oder Tools aktualisieren	Verbindet sich erneut mit dem Server und holt seine aktuelle Tool-Liste. Neue Tools starten mit Erst fragen, oder mit Aus bei Lösch-Tools.
Server entfernen	Entfernt den Server. Agenten verlieren seine Tools, und seine Tool-Regeln werden gelöscht. Sie können ihn später erneut hinzufügen.

Wenn etwas schiefgeht

Meldung	Was zu tun ist
Geben Sie eine vollständige Server-URL ein, z. B. https://example.com/mcp.	Geben Sie die vollständige URL einschließlich Pfad ein.
Runner erreicht nur öffentliche Server. Diese URL zeigt auf ein privates Netzwerk.	Verwenden Sie eine URL, die aus dem Internet erreichbar ist.
Diese URL hat geantwortet, aber nicht als MCP-Server. Prüfen Sie den Pfad.	Suchen Sie in der Server-Doku nach dem MCP-Pfad. Er endet oft auf `/mcp`.
Runner erreicht diesen Server nicht. Prüfen Sie die URL und ob er online ist.	Stellen Sie sicher, dass der Server läuft und die URL stimmt.
Der Server hat den Schlüssel abgelehnt. Prüfen Sie Header-Name und Schlüssel.	Prüfen Sie beide Werte. Manche Server brauchen `Bearer` vor dem Schlüssel.
Der Server hat geantwortet, hat aber keine Tools.	Der Server hat für diesen Schlüssel keine Tools. Prüfen Sie die Einstellungen des Servers.
Dieser Shop hat bereits die maximale Anzahl an MCP-Servern. Entfernen Sie zuerst einen.	Entfernen Sie einen Server, den Sie nicht nutzen.

Unter Verbunden zeigt ein Server, der nicht mehr funktioniert, Nicht erreichbar oder Schlüssel abgelehnt. Wählen Sie Beheben, um den Server zu öffnen, und ersetzen Sie dann den Schlüssel oder prüfen Sie den Server.