MCP-Server

Was MCP-Server tun

Profi Model Context Protocol (MCP)-Server erlauben dir, deine KI-Agenten mit externen Tools und Datenquellen über einen offenen Standard zu erweitern. Füge MCP-Server im Agent-Editor hinzu, konfiguriere Authentifizierung und verwalte im Tab Tools im Profi, welche gefundenen Tools der Agent verwenden darf.

MCP ist ein offener Standard, um KI-Modelle mit externen Systemen zu verbinden. Mehr erfährst du auf modelcontextprotocol.io.

Wie es funktioniert

MCP-Server stellen Tools bereit, die dein KI-Agent während des Gesprächs aufrufen kann:

Du verbindest einen MCP-Server per URL
itellicoAI entdeckt automatisch die vom Server bereitgestellten Tools
Du aktivierst die Tools, die dein Agent verwenden darf
Während des Gesprächs ruft der Agent Tools nach Bedarf auf, um Fragen zu beantworten oder Aktionen auszuführen

Einen MCP-Server hinzufügen

MCP-Server fügst du direkt über den Tab Tools hinzu. So fügst du einen Server hinzu:

Auf Profi wechseln

Wenn du im Einfach bist, wechsle zuerst in den Profi.

MCP-Server-Dialog öffnen

Gehe im Agent-Editor zu Tools, klicke auf Hinzufügen und wähle dann MCP-Server.

Server konfigurieren

Füge einen Name und entweder eine direkte URL oder ein URL-Credential aus Secrets hinzu.

Bei Bedarf Credentials hinzufügen

Nutze optionale Headers und Query Parameters für Authentifizierung oder serverseitige Optionen.

Server speichern

Speichere die Verbindung, um sie dem aktuellen Agenten zuzuweisen.

Tools des Servers verwalten

Das Speichern einer Server-Verbindung macht nicht automatisch jedes gefundene Tool für den Agenten verfügbar. Du wählst selbst aus, auf welche Tools der Agent Zugriff hat.

Tools verwalten öffnen

Öffne in der MCP-Server-Zeile unter Tools die Option Tools verwalten.

Discovery aktualisieren, falls nötig

Tools werden automatisch erkannt. Nutze Aktualisieren, um die Erkennung nach Änderungen am Server erneut auszuführen.

Tools auswählen

Wähle ein oder mehrere gefundene Tools aus oder nutze Alle auswählen, wenn der Server absichtlich schmal gehalten ist.

Zugriff speichern

Speichere, um die explizite Allow-List für den aktuellen Agenten zu aktualisieren.

Bestehende MCP-Server-Zeilen sind im Einfach sichtbar, aber Hinzufügen und Bearbeiten erfordern den Profi.

Benutzerdefinierte Headers und Query Parameters konfigurieren

Benutzerdefinierte Headers

Verwende Headers für API-Key- oder Bearer-Token-Authentifizierung:

{
  "Authorization": "Bearer your-api-key",
  "X-API-Key": "your-key"
}

Füge Headers als Schlüssel-Wert-Paare im Konfigurationspanel hinzu.

Query-Parameter

Für Server, die URL-basierte Authentifizierung erfordern:

{
  "api_key": "your-key",
  "client_id": "your-client-id"
}

Speichere Credentials sicher. Trage API-Keys niemals in clientseitigem Code oder öffentlichen Repositories ein.

Automatische Tool-Discovery

Wenn du Tools verwalten für einen MCP-Server öffnest, fragt itellicoAI den Server ab und ruft Folgendes ab:

Tool-Namen – Bezeichner zum Aufrufen des Tools
Beschreibungen – Was das Tool tut (wird dem KI-Modell zur Entscheidungsfindung angezeigt)
Parameter-Schemas – Eingabeparameter mit Typen und Beschreibungen
Rückgabetypen – Erwartetes Antwortformat

Die Tool-Discovery läuft automatisch, wenn du die Tool-Einstellungen öffnest, und kann mit Aktualisieren erneut ausgeführt werden, um neu hinzugefügte Tools zu erfassen.

Einzelne Tools aktivieren und deaktivieren

Nach der Discovery entscheidest du, welche einzelnen Server-Tools für den aktuellen Agenten aktiviert werden. So bleibt der Tool-Zugriff eng gefasst und das Modell kann ihn besser nutzen. Best Practices für die Tool-Verwaltung:

Aktiviere nur, was du brauchst. Weniger Tools bedeuten bessere Tool-Auswahlentscheidungen seitens der KI.
Schreibe klare Beschreibungen. Wenn eine Tool-Beschreibung vom Server unklar ist, weiß die KI möglicherweise nicht, wann sie das Tool einsetzen soll.
Deaktiviere destruktive Tools (Löschen, Aktualisieren), sofern dein Anwendungsfall sie nicht ausdrücklich erfordert.
Führe die Discovery regelmäßig erneut aus, wenn der Server neue Tools hinzufügt.

Latenzerwartungen

Der aktuelle MCP-Flow bietet keine Timeout-Einstellungen in der Benutzeroberfläche. Behandle niedrige Latenz als Teil des MCP-Server-Designs. Best Practices:

Halte Tool-Antworten schnell genug für Live-Gespräche
Caching für aufwendige Abfragen wo möglich einsetzen
Lang laufende Workflows in synchronen MCP-Tools vermeiden
Vor dem Go-live unter realistischen Netzwerkbedingungen testen

MCP-Server testen

Teste deine MCP-Server-Verbindung und die Tools vor dem Deployment in der Produktion.

Verbindung prüfen

Bestätige nach dem Hinzufügen des Servers, dass unter Tools verwalten erkannte Tools für den Server angezeigt werden.

In einer Konversation testen

Starte Agent testen und führe ein browserbasiertes Gespräch, einen Telefonanruf oder eine Chat-Sitzung durch, die das MCP-Tool auslösen soll.

Fehlerszenarien testen

Prüfe, ob der Agent mit Tool-Fehlern sicher umgeht – zum Beispiel, wenn der MCP-Server nicht erreichbar ist oder einen Fehler zurückgibt.

Eigene MCP-Server bauen

Dein MCP-Server muss:

Einen HTTPS-Endpunkt bereitstellen – Sichere Verbindungen sind erforderlich
Das MCP-Protokoll implementieren – Standard-Tool-Discovery und -Aufruf
Strukturierte Antworten zurückgeben – JSON-formatierte Tool-Ergebnisse
Fehler sicher behandeln – Aussagekräftige Fehlermeldungen zurückgeben

Beispiel-Server

from mcp import Server

server = Server("my-custom-server")

@server.tool("get_customer")
async def get_customer(customer_id: str) -> dict:
    """Look up customer information by ID"""
    customer = await database.get_customer(customer_id)
    return {
        "name": customer.name,
        "email": customer.email,
        "status": customer.status
    }

Ausführliche Hinweise zur MCP-Server-Entwicklung findest du in der MCP-Dokumentation.

Fehlerbehebung

Verbindung fehlgeschlagen

Prüfe, ob die Server-URL korrekt und erreichbar ist
Stelle sicher, dass HTTPS korrekt konfiguriert ist
Prüfe, ob die Authentifizierungs-Credentials gültig sind
Teste den Endpunkt direkt mit cURL oder Postman

Tool-Discovery findet keine Tools

Prüfe, ob dein Server die MCP-Tool-Discovery implementiert
Sieh dir die Server-Logs auf Fehler an
Stelle sicher, dass der Server auf Anfragen antwortet
Führe die Discovery erneut aus, nachdem du Server-Probleme behoben hast

Agent ruft Tools nicht auf

Überprüfe Tool-Beschreibungen – sind sie klar genug für die KI?
Überprüfe den Agenten-Prompt – weiß der Agent, wann er Tools einsetzen soll?
Stelle sicher, dass die Tools aktiviert (nicht deaktiviert) sind
Reduziere die Gesamtzahl aktivierter Tools, wenn die KI schlecht auswählt

Langsame Tool-Antworten

Optimiere die Performance deines MCP-Servers
Erwäge Caching für häufig abgerufene Daten
Prüfe die Netzwerklatenz zwischen itellicoAI und deinem Server

Sicherheitshinweise

MCP-Server haben Zugang zu externen Systemen. Befolge die Security-Best-Practices:

Verwende minimale Zugriffsrechte für API-Credentials
Rotiere Authentifizierungsschlüssel regelmäßig
Überwache Tool-Aufruf-Logs auf ungewöhnliche Aktivitäten
Prüfe regelmäßig, welche Tools auf den einzelnen Agenten aktiviert sind

Netzwerksicherheit:

Alle Verbindungen müssen HTTPS verwenden
Erwäge IP-Allowlisting für deine MCP-Server
Verwende starke Authentifizierungsmethoden

Datensicherheit:

Stelle nur Daten bereit, die der Agent benötigt
Implementiere geeignete Zugriffskontrollen auf der Server-Seite
Protokolliere alle Tool-Aufrufe für Auditzwecke

Nächste Schritte

Benutzerdefinierte Aktion

Einfachere HTTP-Integrationen ohne MCP nutzen

Tools-Übersicht

Alle Tool-Typen erkunden

Websuche

Das integrierte Web-Search-Tool nutzen

Agenten testen

MCP-Tools in Konversationen testen

Erste Schritte

Erstellen

Testen

Deploy

Verwalten

Beispiele

Fehlerbehebung

Referenz

Account-Administration

Entwickler & Integrationen

Abrechnung & Nutzung

Partner-Netzwerk

Rechtliches

MCP-Server

Was MCP-Server tun

Wie es funktioniert

Einen MCP-Server hinzufügen

Tools des Servers verwalten

Benutzerdefinierte Headers und Query Parameters konfigurieren

Benutzerdefinierte Headers

Query-Parameter

Automatische Tool-Discovery

Einzelne Tools aktivieren und deaktivieren

Latenzerwartungen

MCP-Server testen

Eigene MCP-Server bauen

Beispiel-Server

Fehlerbehebung

Sicherheitshinweise

Nächste Schritte

Benutzerdefinierte Aktion

Tools-Übersicht

Websuche

Agenten testen

​Was MCP-Server tun

​Wie es funktioniert

​Einen MCP-Server hinzufügen

​Tools des Servers verwalten

​Benutzerdefinierte Headers und Query Parameters konfigurieren

​Benutzerdefinierte Headers

​Query-Parameter

​Automatische Tool-Discovery

​Einzelne Tools aktivieren und deaktivieren

​Latenzerwartungen

​MCP-Server testen

​Eigene MCP-Server bauen

​Beispiel-Server

​Fehlerbehebung

​Sicherheitshinweise

​Nächste Schritte

Benutzerdefinierte Aktion

Tools-Übersicht

Websuche

Agenten testen

Was MCP-Server tun

Wie es funktioniert

Einen MCP-Server hinzufügen

Tools des Servers verwalten

Benutzerdefinierte Headers und Query Parameters konfigurieren

Benutzerdefinierte Headers

Query-Parameter

Automatische Tool-Discovery

Einzelne Tools aktivieren und deaktivieren

Latenzerwartungen

MCP-Server testen

Eigene MCP-Server bauen

Beispiel-Server

Fehlerbehebung

Sicherheitshinweise

Nächste Schritte