---
lastModified: 2026-11-13
title: Eigenen MCP-Server hinzufügen
description: Verbinden Sie einen Remote-MCP-Server per URL und legen Sie fest, was der Runner Agent mit jedem seiner Tools tun darf.
seo:
  description: "Verbinden Sie Ihren eigenen Remote-MCP-Server per URL mit Runner, mit oder ohne API-Schlüssel, und stellen Sie jedes Tool auf Erlauben, Erst fragen oder Aus, bevor der Agent es nutzen kann."
---

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

1. Öffnen Sie Ihr Projekt und wählen Sie **Agent → Tools**.
2. Wählen Sie in der Zeile **Eigenen MCP-Server hinzufügen** die Schaltfläche **Server hinzufügen**.
3. 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.
4. 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.
5. 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.
6. **Welche Agenten es nutzen dürfen** zeigt **Alle Agenten**. Sie können das später pro Agent ändern.
7. Wählen Sie **Ich vertraue diesem Server**.
8. Wählen Sie **Verbinden und Tools finden**. Runner verbindet sich mit dem Server und listet seine Tools auf.
9. 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.

## Verwandte Leitfäden

- [Verbinden und steuern Sie Agent Apps](./agent-apps)
- [Apps und Integrationen Übersicht](../apps-and-integrations)
- [Fehlerbehebung bei einer App-Verbindung](./troubleshooting)