MCP-Server
Verbinden Sie externe Tools und Dienste mit AI SmartTalk über das Model Context Protocol (MCP). MCP ist ein offener Standard, der es Ihrem KI-Assistenten ermöglicht, über eine einheitliche Schnittstelle mit externen Systemen zu interagieren.
Übersicht
Die MCP-Server-Integration ermöglicht Ihnen:
- Mehrere MCP-Server gleichzeitig zu verbinden
- Externe Tools für Ihre KI während Gesprächen bereitzustellen
- Authentifizierung mit benutzerdefinierten HTTP-Headern (API-Schlüssel, Tokens usw.)
- Verbindungen zu testen, bevor Sie live gehen
- Funktionen zu erweitern ohne benutzerdefinierte Entwicklung
Was ist MCP? Das Model Context Protocol ist ein offener Standard (entwickelt von Anthropic), der es KI-Systemen ermöglicht, sicher mit externen Datenquellen und Tools zu verbinden. Erfahren Sie mehr unter modelcontextprotocol.io.
Voraussetzungen
Bevor Sie beginnen, stellen Sie sicher, dass Sie:
- Ein aktives AI SmartTalk-Konto haben
- Zugriff auf einen oder mehrere MCP-kompatible Server haben
- Die Server-URL für jeden MCP-Server haben
- Alle erforderlichen Authentifizierungsanmeldeinformationen (API-Schlüssel, Tokens)
Wie MCP funktioniert
- Der Benutzer stellt eine Frage, die externe Daten erfordert
- AI SmartTalk erkennt, dass es ein MCP-Tool benötigt
- Der entsprechende MCP-Server wird mit dem richtigen Tool aufgerufen
- Die Antwort wird zurückgegeben und die KI formuliert eine Antwort in natürlicher Sprache
AI SmartTalk unterstützt mehrere MCP-Server gleichzeitig. Tools von verschiedenen Servern werden automatisch namespaced, um Konflikte zu vermeiden.
Schritt-für-Schritt-Setup
Schritt 1: Zugriff auf die MCP-Integration
- Melden Sie sich bei Ihrem AI SmartTalk-Konto an
- Navigieren Sie zu Verwaltung → Meine Assistenten → [Ihr Assistentenname]
- Klicken Sie auf Connectoren in der linken Seitenleiste
- Suchen Sie MCP-Server und klicken Sie darauf
Schritt 2: Einen MCP-Server hinzufügen
Klicken Sie auf Server hinzufügen, um das Serverkonfigurationsformular zu öffnen. Füllen Sie die folgenden Felder aus:
| Feld | Erforderlich | Beschreibung |
|---|---|---|
| Servername | Ja | Ein freundlicher Name zur Identifizierung dieses Servers (z. B. "Unternehmens-CRM", "Internes Wiki") |
| Server-URL | Ja | Die MCP-Server-Endpunkt-URL (z. B. https://mcp.example.com) |
| HTTP-Header | Nein | Benutzerdefinierte Header für Authentifizierung oder andere Anforderungen |
AI SmartTalk fügt automatisch /mcp zu Ihrer URL hinzu, wenn sie nicht bereits damit endet. Zum Beispiel wird https://example.com zu https://example.com/mcp. Wenn Ihr Server einen anderen Endpunktpfad verwendet, fügen Sie ihn in der URL ein (z. B. https://example.com/api/mcp).
Schritt 3: Authentifizierungsheader hinzufügen (optional)
Wenn Ihr MCP-Server eine Authentifizierung erfordert, klicken Sie auf Header hinzufügen, um benutzerdefinierte HTTP-Header zu konfigurieren:
| Häufiger Header | Anwendungsfall |
|---|---|
Authorization | Bearer-Tokens (z. B. Bearer sk-xxx...) |
X-API-Key | API-Schlüssel-Authentifizierung |
X-Auth-Token | Benutzerdefinierte Token-Authentifizierung |
Für jeden Header geben Sie an:
- Schlüssel: Der Headername (aus häufigen Headern auswählen oder einen benutzerdefinierten eingeben)
- Wert: Der Headerwert (sensible Werte werden in der Benutzeroberfläche automatisch maskiert)
Sie können mehrere Header pro Server hinzufügen. Header, die "secret", "password", "token" oder "auth" im Schlüsselname enthalten, werden aus Sicherheitsgründen automatisch ausgeblendet.
Schritt 4: Die Verbindung testen
Bevor Sie speichern, klicken Sie auf Verbindung testen, um zu überprüfen, ob Ihr Server erreichbar ist:
- AI SmartTalk sendet eine JSON-RPC-Initialisierungsanfrage an Ihren Server
- Der Test überprüft mehrere Endpunkte in folgender Reihenfolge:
/mcp,/health, dann die Basis-URL - Die Ergebnisse zeigen den Verbindungsstatus, die Antwortzeit und Serverinformationen an
| Testergebnis | Bedeutung |
|---|---|
| Verbunden | Server hat erfolgreich mit dem MCP-Protokoll geantwortet |
| Authentifizierung fehlgeschlagen | Überprüfen Sie Ihren API-Schlüssel oder Token in den Headern |
| Server nicht gefunden | Überprüfen Sie, ob die URL korrekt ist |
| Verbindung abgelehnt | Server könnte ausgefallen sein oder Firewall blockiert den Zugriff |
| Zeitüberschreitung | Server hat zu lange für eine Antwort benötigt (10s Limit) |
| SSL-Fehler | Überprüfen Sie, ob der Server ein gültiges SSL-Zertifikat hat |
Schritt 5: Konfiguration speichern
- Klicken Sie auf Hinzufügen, um den Server zu Ihrer Liste hinzuzufügen
- Wiederholen Sie die Schritte 2-4, um bei Bedarf weitere MCP-Server hinzuzufügen
- Klicken Sie auf Integration speichern, um alle konfigurierten Server zu aktivieren
Unterstützung mehrerer Server
AI SmartTalk unterstützt die Verbindung von mehreren MCP-Servern gleichzeitig. Dies ermöglicht es Ihnen, Tools aus verschiedenen Quellen zu kombinieren:
Tool-Namensraum
Tools von jedem Server werden automatisch mit dem Servernamen vorangestellt, um Namenskonflikte zu vermeiden. Zum Beispiel:
company_crm__search_customersinternal_wiki__search_docsweather_api__get_forecast
Das bedeutet, dass Sie Server sicher verbinden können, die Tools mit demselben Namen bereitstellen.
Verwaltung mehrerer Server
Das Integrations-Dashboard zeigt alle konfigurierten Server mit:
- Servername und URL zur einfachen Identifizierung
- Headeranzahl-Badge, wenn benutzerdefinierte Header konfiguriert sind
- Statusanzeige (Konfiguriert / Unvollständig)
- Aktionsschaltflächen: Verbindung testen, Bearbeiten oder Löschen einzelner Server
Tool-Entdeckung
Sobald Ihre MCP-Server verbunden sind, entdeckt AI SmartTalk automatisch alle verfügbaren Tools, die von jedem Server bereitgestellt werden. Diese Tools stehen Ihrem KI-Assistenten sofort zur Verfügung.
Der KI-Assistent wird:
- Die Liste aller verfügbaren Tools von allen verbundenen Servern sehen
- Automatisch das richtige Tool basierend auf Benutzeranfragen auswählen
- Das Tool mit den entsprechenden Parametern aufrufen
- Die Antwort verarbeiten und eine Antwort in natürlicher Sprache bereitstellen
Sie müssen keine einzelnen Tools manuell konfigurieren oder aktivieren. Alle von einem verbundenen MCP-Server bereitgestellten Tools sind automatisch für Ihren KI-Assistenten verfügbar.
Anwendungsfälle
Kundenbeziehungsmanagement
Verbinden Sie Ihr CRM über MCP:
- "Kunden John Smith suchen"
- "Wie ist der Status des Kontos #12345?"
- "Wie viele offene Support-Tickets haben wir?"
Interne Tools
Zugriff auf Unternehmenssysteme:
- "Überprüfen Sie den Bestand für Produkt SKU-123"
- "Was steht für morgen auf dem Plan?"
- "Durchsuchen Sie unser internes Wiki nach Onboarding-Dokumenten"
Externe Datenquellen
Echtzeitdaten abrufen:
- "Wie ist das aktuelle Wetter in Paris?"
- "Holen Sie sich den aktuellen Aktienkurs für AAPL"
- "Überprüfen Sie den Flugstatus für UA123"
Entwicklungstools
Für technische Teams:
- "Wie ist der Status des neuesten Builds?"
- "Durchsuchen Sie unsere GitHub-Issues nach Authentifizierungsfehlern"
- "Überprüfen Sie den Zustand der Produktionsserver"
MCP-Serverbeispiele
Beliebte MCP-Server
| Server | Zweck | Link |
|---|---|---|
| Filesystem | Lokale Dateien lesen/schreiben | Eingebauter Referenzserver |
| PostgreSQL | Datenbanken abfragen | Community-Server |
| GitHub | Repo-Verwaltung | Community-Server |
| Slack | Messaging-Integration | Community-Server |
| Google Drive | Dateiverwaltung | Community-Server |
| Brave Search | Websuche | Community-Server |
Weitere Informationen: Besuchen Sie das MCP Server Registry für eine wachsende Liste von Community-MCP-Servern.
Selbstgehostete MCP-Server
Sie können benutzerdefinierte MCP-Server für folgende Zwecke erstellen:
- Proprietäre interne Systeme
- Benutzerdefinierte Geschäftslogik
- Sicherer oder privater Datenzugriff
Verwenden Sie ein beliebiges MCP SDK (TypeScript, Python), um Ihren eigenen Server zu erstellen.
Sicherheitsüberlegungen
Authentifizierung
Konfigurieren Sie die Authentifizierung über HTTP-Header in der Serverkonfiguration:
| Methode | Header-Beispiel |
|---|---|
| Bearer-Token | Authorization: Bearer sk-xxx... |
| API-Schlüssel | X-API-Key: your-api-key |
| Benutzerdefiniertes Token | X-Auth-Token: your-token |
Datenschutz
- MCP-Anfragen können Benutzerdaten aus Konversationen enthalten
- Stellen Sie sicher, dass Ihr MCP-Server Daten gemäß Ihren Datenschutzrichtlinien verarbeitet
- Berücksichtigen Sie Anforderungen an den Datenstandort
- AI SmartTalk maskiert sensible Header-Werte in der Benutzeroberfläche
Netzwerksicherheit
- Verwenden Sie HTTPS für alle MCP-Verbindungen
- Beschränken Sie den Zugriff auf den MCP-Server auf vertrauenswürdige IPs
- Implementieren Sie eine Ratenbegrenzung auf Ihrem MCP-Server
- Stellen Sie sicher, dass gültige SSL-Zertifikate vorhanden sind
Fehlersuche
Verbindungsprobleme
| Problem | Lösung |
|---|---|
| "Verbindung verweigert" | Überprüfen Sie die Server-URL und den Port. Stellen Sie sicher, dass der Server läuft |
| "Authentifizierung fehlgeschlagen" (401) | Überprüfen Sie Ihren API-Schlüssel oder Token in der Header-Konfiguration |
| "Verboten" (403) | Überprüfen Sie, ob Ihre Anmeldeinformationen die erforderlichen Berechtigungen haben |
| "Server nicht gefunden" (404) | Überprüfen Sie die URL. AI SmartTalk fügt automatisch /mcp hinzu |
| "Zeitüberschreitung" | Überprüfen Sie die Netzwerkverbindung und die Firewall-Regeln. Der Test hat eine Zeitüberschreitung von 10 Sekunden |
| "SSL-Fehler" | Stellen Sie sicher, dass Ihr MCP-Server ein gültiges SSL-Zertifikat hat |
| "Ratenbegrenzung" (429) | Zu viele Anfragen. Warten Sie und versuchen Sie es erneut oder erhöhen Sie die Serverlimits |
Tool-Probleme
| Problem | Lösung |
|---|---|
| Werkzeuge erscheinen nicht | Überprüfen Sie, ob der MCP-Server die Werkzeuge korrekt bereitstellt. Versuchen Sie, die Seite zu aktualisieren |
| Falsche Werkzeuge aufgerufen | Überprüfen Sie, ob die Servernamen beschreibend sind, um der KI zu helfen, die richtige Wahl zu treffen |
| Werkzeugaufruf schlägt fehl | Überprüfen Sie die Serverprotokolle auf Fehler. Stellen Sie sicher, dass das Werkzeug das erwartete Format zurückgibt |
Häufige Fehler
- Vergessen von
/mcp: AI SmartTalk fügt es automatisch hinzu, aber wenn Ihr Endpunkt anders ist, geben Sie den vollständigen Pfad an - Falsches Header-Format: Stellen Sie sicher, dass die Authentifizierungsheader mit dem übereinstimmen, was Ihr Server erwartet
- Doppelte Servernamen: Jeder Server muss einen eindeutigen Namen haben
Verwaltung von MCP-Servern
| Aktion | Wie |
|---|---|
| Server hinzufügen | Klicken Sie auf "Server hinzufügen", füllen Sie die Details aus, testen Sie und speichern Sie |
| Server bearbeiten | Klicken Sie auf das Bearbeitungssymbol auf der Serverkarte |
| Verbindung testen | Klicken Sie auf das Testsymbol auf der Serverkarte |
| Server löschen | Klicken Sie auf das Löschsymbol auf der Serverkarte |
| Änderungen speichern | Klicken Sie auf "Integration speichern", um alle Änderungen zu persistieren |
Best Practices
- Verwenden Sie beschreibende Servernamen: Hilft der KI zu verstehen, welchen Server sie abfragen soll (z. B. "Unternehmens-CRM" anstelle von "Server 1")
- Testen Sie vor dem Speichern: Testen Sie immer die Verbindungen, um Konfigurationsprobleme frühzeitig zu erkennen
- Beginnen Sie mit einem Server: Gewöhnen Sie sich an eine Integration, bevor Sie weitere hinzufügen
- Sichern Sie Ihre Anmeldeinformationen: Verwenden Sie dedizierte API-Schlüssel für AI SmartTalk, nicht persönliche Tokens
- Überwachen Sie Ihre Server: Verfolgen Sie, welche Werkzeuge aufgerufen werden und deren Leistung
- Halten Sie Server aktuell: Stellen Sie sicher, dass Ihre MCP-Server der neuesten Protokollspezifikation folgen