# MCP-Server: dem KI-Agenten Werkzeuge anderer Systeme geben

> Verbinden Sie den MCP-Server eines anderen Systems mit dem Enydea-KI-Agenten, wählen Sie, welche Werkzeuge er nutzen darf, und prüfen Sie jeden Aufruf.

Source: https://enydea.com/de/documentation/agent-mcp-servers · Last updated 2026-10-17

## Was MCP-Server tun

MCP (Model Context Protocol) ist ein offener Standard, mit dem eine KI Werkzeuge in einem anderen System nutzen kann. Unter **MCP-Server** verbinden Sie den MCP-Server eines anderen Systems mit dem Enydea-KI-Agenten. Der Agent kann dann in diesem System Dinge nachschlagen oder handeln, aber nur mit den Werkzeugen, die ein Firmenadmin einschaltet.

Das ist die umgekehrte Richtung zum Enydea-Connector. Mit dem Connector arbeiten Claude oder ChatGPT mit Ihren Enydea-Daten. Über **MCP-Server** arbeitet Enydeas eigener Agent mit einem anderen System. Zum Connector siehe [KI-Assistenten-Connector](https://enydea.com/de/documentation/connect-ai-assistants-mcp.md).

## Bevor Sie beginnen

- Sie müssen Firmenadmin sein. Alle anderen sehen **Nur Firmenadmins können MCP-Server verwalten.**
- Der Server muss MCP über HTTP (den Transport Streamable HTTP) unter einer öffentlichen `https://`-Adresse sprechen. Ein Server, der auf Ihrem eigenen Computer oder in einem privaten Netzwerk läuft, kann nicht verbunden werden.
- Wenn der Server einen Schlüssel braucht, besorgen Sie sich beim Anbieter einen API-Schlüssel oder ein Token. Server, die nur eine Anmeldung über eine Browserseite (OAuth) akzeptieren, werden nicht unterstützt.

## Einen Server hinzufügen

1. Öffnen Sie **Einstellungen** (Settings) -> **Integrationen** (Integrations) und scrollen Sie nach unten zu **MCP-Server**. Klicken Sie auf **MCP-Server hinzufügen**.
2. Füllen Sie **MCP-Server verbinden** aus:
   - **Name**: ein Name, den Sie wiedererkennen. Der Kurzname, den Enydea daraus bildet, muss in Ihrem Unternehmen eindeutig sein.
   - **Server-URL (https)**: die Adresse, die Ihnen der Anbieter nennt.
   - **Authentifizierung**: **Bearer-Token** (der Standard, gesendet als `Authorization: Bearer`-Header), **Benutzerdefinierter Header** mit einem **Header-Name** wie `X-API-Key` oder **Keine**.
   - **Token / API-Schlüssel**, sofern Sie nicht **Keine** gewählt haben. Der Wert wird verschlüsselt gespeichert und nie wieder angezeigt.
   - **Max. Aufrufe pro Agentenlauf**: 1 bis 100, Standard 20.
3. Klicken Sie auf **Verbinden**. Enydea listet sofort die Werkzeuge des Servers auf, alle ausgeschaltet, und eine Meldung nennt, wie viele es gefunden hat. Schlägt das Auflisten fehl, nennt die Meldung den Grund, und der Server zeigt eine Fehlerzeile.

## Festlegen, was der Agent nutzen darf

Öffnen Sie das Panel des Servers. Jedes Werkzeug zeigt seinen Namen, seine Beschreibung, seine Eingaben und eine Richtlinie:

| Richtlinie | Bedeutung |
|---|---|
| **Deaktiviert** | Der Agent sieht das Werkzeug nicht. Jedes Werkzeug beginnt hier. |
| **Erlaubt** | Der Agent ruft das Werkzeug auf, wann immer seine Aufgabe es erfordert. |
| **Nach Bestätigung fragen** | Das Werkzeug verweigert die Ausführung, bis der Agent es erneut mit einem Zustimmungs-Flag aufruft. Der Agent ist angewiesen, Sie vorher zu fragen. |

Badges helfen bei der Entscheidung. **schreibgeschützt** und **kann ändern/löschen** stammen vom Server. **führt Aktionen aus (laut Name)** bedeutet, dass der Server nichts kennzeichnet, der Name aber mit einem Wort wie create, delete oder send beginnt. Wenn Sie ein Werkzeug, das laut Kennzeichnung oder Name handelt, auf **Erlaubt** setzen, werden Sie zuerst um Bestätigung gebeten.

- **Schreibgeschützte Tools zulassen** setzt die Werkzeuge, die der Server als nur lesend kennzeichnet, auf **Erlaubt**. Kennzeichnet der Server keines, erlaubt es die Werkzeuge, deren Namen nicht nach einer Aktion aussehen.
- **Alle zulassen** schaltet nach Ihrer Bestätigung jedes Werkzeug ein: Werkzeuge, die handeln, erhalten **Nach Bestätigung fragen**, Abfragen erhalten **Erlaubt**.
- **Alle ausschalten** schaltet jedes Werkzeug aus.
- **Tools filtern** durchsucht die Liste. Ein eingeschaltetes Werkzeug zeigt den Namen, den der Agent verwendet: `mcp__<short name>__<tool>`.

## Einen Server verwalten

Die Kopfzeile des Panels zeigt ein Statussymbol und wie viele Werkzeuge eingeschaltet sind.

- Der Schalter **Aktiviert** entzieht dem Agenten den ganzen Server oder gibt ihn zurück, ohne die Werkzeugeinstellungen zu ändern.
- **Tools aktualisieren** listet die Werkzeuge erneut auf. Neue Werkzeuge stehen zunächst auf **Deaktiviert**. Ein eingeschaltetes Werkzeug, dessen Beschreibung oder Eingaben sich geändert haben, wird ausgeschaltet und mit **geändert – prüfen** markiert, damit ein Server nicht unbemerkt ändern kann, was ein erlaubtes Werkzeug tut. Wenn Sie eine Richtlinie wählen, verschwindet die Markierung. Enydea sucht nicht selbstständig nach Änderungen.
- **Authentifizierung** im Panel ändert den Modus, den **Header-Name** und das Token (**Token ersetzen**). Klicken Sie auf **Authentifizierung speichern**. Wenn Sie **Keine** wählen, wird das gespeicherte Token gelöscht.
- **Entfernen** löscht den Server nach Ihrer Bestätigung.

Im Panel lassen sich URL, Name und Aufruflimit nicht ändern. Entfernen Sie den Server und fügen Sie ihn neu hinzu.

## Aufrufprotokoll

Wenn Sie das Panel eines Servers öffnen, wird **Letzte Aufrufe** geladen: die letzten 100 Aufrufe, die neuesten zuerst, mit Zeitpunkt, Werkzeug, Ergebnis (`ok`, `error` oder `refused`), Dauer und dem Fehler oder den gesendeten Argumenten. Ein Aufruf wird abgelehnt, wenn das Werkzeug ausgeschaltet ist, wenn die Argumente nicht zu den Eingaben des Werkzeugs passen oder wenn der Lauf das Aufruflimit erreicht hat. Um neue Aufrufe zu sehen, schließen Sie das Panel und öffnen es erneut.

## Wie der Agent die Werkzeuge nutzt

- Die Werkzeuge funktionieren im Modus **AGENT** des KI-Assistenten und in geplanten Aufgaben unter **KI-Agenten** (AI Agents), für alle in Ihrem Unternehmen; eine Einstellung pro Person gibt es nicht. Der Modus **CHAT** nutzt sie nicht. Siehe [KI-Assistent und KI-Agenten](https://enydea.com/de/documentation/ai-assistant-and-agents.md).
- Claude oder ChatGPT, die über den Enydea-Connector verbunden sind, sehen diese Werkzeuge nicht. Sie erreichen sie nur, indem sie eine Aufgabe an Enydeas Agenten übergeben.
- Enydea prüft vor jedem Aufruf die Argumente anhand der Eingaben des Werkzeugs. Das Aufruflimit gilt pro Server und pro Lauf.
- Ergebnisse kommen als Daten zurück. In JSON-Ergebnissen entfernt Enydea leere Werte, kürzt lange Texte und fasst lange Listen zusammen. Der Agent erhält von jedem Ergebnis höchstens etwa 8.000 Zeichen und nur Text: Bilder werden weggelassen. Er ist angewiesen, Anweisungen in einem Ergebnis niemals zu befolgen.

### Bestätigungen

**Nach Bestätigung fragen** hält den Aufruf für Sie zurück. Der Agent kann ihn nicht selbst genehmigen. Im Modus **AGENT** zeigt seine Antwort eine Karte mit dem Werkzeug und den genauen Argumenten: **Bestätigen** führt den Aufruf wie angezeigt aus, **Überspringen** verwirft ihn. Eine geplante Aufgabe hält den Aufruf auf dieselbe Weise zurück, und die Karte erscheint, wenn Sie das nächste Mal **KI** öffnen. Ein zurückgehaltener Aufruf kann 3 Tage lang genehmigt werden. Setzen Sie ein Werkzeug auf **Deaktiviert**, wenn der Agent es nie verwenden darf.

## Sicherheit

- Nur öffentliche `https://`-Adressen werden akzeptiert. Adressen, die in private, lokale oder Cloud-interne Netzwerke führen, werden beim Speichern und erneut bei jeder Verbindung abgelehnt. Weiterleitungen werden nicht verfolgt. Ein Aufruf bricht nach 30 Sekunden ab, und eine Antwort über 2 MB lässt ihn fehlschlagen.
- Was der Agent als Argumente übergibt, wird an das andere System gesendet. Der Agent ist angewiesen, nur das zu übergeben, was die Aufgabe braucht, und niemals Anmeldedaten. Verbinden Sie Server, denen Sie vertrauen, und erlauben Sie nur die Werkzeuge, die Sie brauchen.
- Niemand kann das gespeicherte Token auslesen, auch Admins nicht.

## Grenzen

- Enydea behält die ersten 300 Werkzeuge eines Servers.

## Verwandte Seiten

- [Tutorial: einen MCP-Server mit dem Enydea-Agenten verbinden](https://enydea.com/de/documentation/tutorial-add-mcp-server-to-agent.md)
- [Marken-Kit](https://enydea.com/de/documentation/brand-kit.md)