Direktverbindungen

Als Markdown anzeigen

Eine Direktverbindung verbindet deine Agenten mit einem Server, den du betreibst: einem entfernten MCP-Server oder einer HTTP-API. Du gibst endue den Endpunkt und die nötigen Header, und die Agenten, denen du die Verbindung zuweist, können den Server aufrufen.

Wann du sie nutzt

Nutze eine Direktverbindung für einen Dienst, für den es im Katalog keinen Connector gibt: eine interne API, deinen eigenen MCP-Server, ein Tool, das dein Team gebaut hat. Steht der Dienst unter Verfügbare Connectors, nutze stattdessen diesen Connector. Seine Operationen sind bereits eingestuft, sodass nur Senden und Löschen vorher nachfragen.

MCP-Server oder HTTP-Server

	MCP-Server	HTTP-Server
Endpunkt	Der MCP-Endpunkt des Servers mit dem Transport Streamable HTTP	Eine Basis-URL
Was der Agent bekommt	Jedes Tool, das der Server auflistet, mit den Namen und Beschreibungen des Servers	Ein Anfrage-Tool, das GET, POST, PUT, PATCH oder DELETE an Pfade unter der Basis-URL sendet
Beschreibung	Optional. Hilft dir, den Server in der Liste wiederzuerkennen.	Pflichtfeld. Der Agent liest sie, um zu wissen, welche Pfade und Methoden er nutzen soll.

Direktverbindung hinzufügen

Öffne Ressourcen › Connectors in der linken Seitenleiste, wähle den Tab Direkt und dann Direktverbindung hinzufügen.
Wähle den Typ: MCP-Server oder HTTP-Server. Nach dem Speichern lässt er sich nicht mehr ändern.
Fülle die Felder aus.
- Name: wird in Listen und in der Unterhaltung angezeigt.
- Endpunkt-URL: eine https://-Adresse im öffentlichen Internet. Bei einem HTTP-Server ist das die Basis-URL, und der Agent erreicht nur Pfade darunter.
- Header: eine Zeile pro Header, den der Server braucht, etwa Authorization mit Bearer ….
- Beschreibung: Schreib bei einem HTTP-Server auf, was der Agent wissen muss: die Pfade, die Methoden und ein Beispiel. Zum Beispiel: GET items?q=Suchbegriff findet Einträge. POST items mit {"title": "…"} legt einen an.
Wähle „Verbindung prüfen“. Gespeichert wird dabei noch nichts.
- Bei einem MCP-Server siehst du den Namen des Servers, die Version des MCP-Protokolls, die angebotenen Tools und alle Tools, die der Agent nicht nutzen kann, jeweils mit Begründung.
- Bei einem HTTP-Server sendet endue eine GET-Anfrage an die Basis-URL oder, wenn du Zu prüfender Pfad ausgefüllt hast, an diesen Pfad darunter und zeigt den Statuscode und den Anfang der Antwort.
Wähle „Speichern“. Bei einem MCP-Server wird die Tool-Liste beim Speichern abgerufen. Ist der Server nicht erreichbar, wird nichts gespeichert.
Weise sie einem Agenten zu. Öffne im Agent Builder dieses Agenten Ressourcen › Connectors und wähle sie wie jede andere Verbindung. Sie trägt das Badge Direkt und zeigt ihren Host.

Header-Werte wie Tokens werden verschlüsselt gespeichert. Nach dem Speichern werden sie nicht mehr angezeigt, auch dir nicht, und sie gelangen nie zum Agenten oder in die Unterhaltung: endue fügt sie selbst jeder Anfrage hinzu, und der Agent kann keine eigenen Header ergänzen.

Wenn du eine Verbindung bearbeitest, lass einen Wert leer, um ihn zu behalten, oder gib einen neuen ein, um ihn zu ersetzen. Da gespeicherte Werte nicht an deinen Browser zurückgeschickt werden, musst du für Verbindung prüfen bei einer bestehenden Verbindung alle Header-Werte erneut eingeben.

Host, Content-Length, Connection und Header, die mit Proxy-, CF-, X-Forwarded- oder Mcp- beginnen, verwaltet die Verbindung selbst. Du kannst sie nicht setzen.

Freigaben

Jeder Aufruf einer Direktverbindung fragt standardmäßig nach deiner Freigabe. endue weiß nicht, was ein Tool auf deinem Server tut, und nimmt die Beschreibung, die der Server selbst zu einem Tool liefert, nicht als Grund, auf die Nachfrage zu verzichten.

Damit Aufrufe ohne Nachfrage laufen, wähle im Tab Direkt bei der Verbindung Bearbeiten und schalte Immer erlauben ein:

MCP-Server: pro Tool.
HTTP-Server: pro Methode, zum Beispiel GET.

Ausführungen, die niemand beobachtet, etwa bei Routinen und Kanälen, können nur nutzen, was du auf „Immer erlauben“ gesetzt hast. Andere Aufrufe werden in diesen Ausführungen abgelehnt.

Netzwerkregeln

endue ruft deinen Server aus der eigenen Infrastruktur auf, nicht von deinem Computer aus. Der Server muss aus dem Internet erreichbar sein:

Nur https://, auf Port 443 oder 8443.
Ein öffentlicher Domainname. IP-Adressen, localhost, Namen, die auf private Adressen auflösen, und die eigenen Adressen von endue werden abgelehnt. Ebenso eine URL mit Benutzername oder Passwort darin; Zugangsdaten gehören in einen Header.
Weiterleitungen werden nur zum selben Host verfolgt.
Jeder Aufruf hat 30 Sekunden Zeit. Eine HTTP-Antwort über 256 KB wird bei 256 KB abgeschnitten. Eine MCP-Antwort über 256 KB schlägt fehl. Ein Anfragetext über 256 KB wird nicht gesendet.

Die Anfragen kommen aus dem Netzwerk von Cloudflare. Hat dein Server eine Firewall oder eine Zulassungsliste, lass die IP-Bereiche von Cloudflare zu.

Eine Verbindung verwalten

Der Tab Direkt listet jede Verbindung mit Typ, Host, Anzahl der Tools, Status und den Agenten, die sie nutzen.

Erneut abrufen liest die Tool-Liste eines MCP-Servers neu ein. Tu das, nachdem du die Tools auf dem Server geändert hast. Die Liste wird auch neu abgerufen, wenn du Endpunkt oder Header änderst.
Fehler bedeutet, dass endue den Server beim letzten Versuch nicht erreichen konnte. Öffne die Verbindung, um den Grund zu sehen.
Löschen entfernt die gespeicherten Header-Werte und nimmt die Verbindung allen Agenten weg, die sie nutzen. Das lässt sich nicht rückgängig machen.

Einschränkungen

Bis zu 20 Direktverbindungen pro Konto.
MCP-Server müssen den Transport Streamable HTTP nutzen. Server, die den älteren Transport HTTP mit SSE nutzen oder eine OAuth-Anmeldung verlangen, werden nicht unterstützt.
Ein HTTP-Server gibt dem Agenten ein Anfrage-Tool und deine Beschreibung. endue liest kein OpenAPI-Dokument. Der Agent verarbeitet JSON- und Textantworten, keine Datei-Uploads oder gestreamten Antworten.
Server in einem privaten Netzwerk sind nicht erreichbar. Der Server braucht eine öffentliche HTTPS-Adresse.
Tools, deren Eingabeformat der Agent nicht nutzen kann, werden weggelassen und mit Begründung als nicht nutzbar aufgeführt.
Eine Direktverbindung gehört zu deinem Konto. Sie erscheint nicht im Katalog.

Siehe auch

Connectors im ÜberblickVerbindungen, Zuweisung und Connectors aus dem Katalog.

FreigabenWas du siehst, wenn ein Aufruf zuerst nachfragt.

Sicherheit und BerechtigungenWas ein Agent erreichen kann und wie Zugangsdaten aufbewahrt werden.