Was sind benutzerdefinierte MCP-Server?
Benutzerdefinierte MCP-Server ermöglichen es Ihnen, die Integrationsfähigkeiten von Manus über vorgefertigte Konnektoren hinaus zu erweitern. Wenn Ihr Unternehmen interne Tools, proprietäre APIs oder spezialisierte Dienste verwendet, die nicht von Standard-MCP-Konnektoren abgedeckt werden, können Sie einen benutzerdefinierten Server erstellen, der Manus mit diesen Systemen verbindet. Ein benutzerdefinierter MCP-Server fungiert als Brücke zwischen Manus und Ihrer internen Infrastruktur und ermöglicht die gleichen nahtlosen Multi-App-Workflows, die Sie mit vorgefertigten Konnektoren erhalten – jedoch zugeschnitten auf Ihre spezifischen Tools und Anforderungen.Warum benutzerdefinierte MCP-Server erstellen?
Interne Systeme
Viele Organisationen verlassen sich auf selbst entwickelte Tools, interne Datenbanken oder proprietäre Software. Benutzerdefinierte MCP-Server ermöglichen es Manus, sich in diese Systeme zu integrieren und interne Daten in Ihre AI-Workflows einzubringen. Beispiele:- Internes CRM oder Kundendatenbank
- Proprietäre Projektmanagement-Tools
- Benutzerdefinierte Analyseplattformen
- Altsysteme mit APIs
Spezialisierte Dienste
Einige Dienste von Drittanbietern verfügen nicht über vorgefertigte MCP-Konnektoren. Wenn Sie ein spezialisiertes Tool oder einen Nischendienst verwenden, können Sie einen benutzerdefinierten Server erstellen, um ihn mit Manus zu verbinden. Beispiele:- Branchenspezifische Software
- Regionale Dienste, die nicht von Standard-Konnektoren abgedeckt werden
- Aufkommende Plattformen ohne offizielle Integrationen
Benutzerdefinierte Geschäftslogik
Benutzerdefinierte MCP-Server können geschäftsspezifische Logik, Datentransformationen oder Validierungsregeln implementieren, die über einfache API-Aufrufe hinausgehen. Dadurch können Sie Organisationsrichtlinien und Workflows innerhalb der Manus-Integrationen durchsetzen. Beispiele:- Genehmigungs-Workflows vor Datenaktualisierungen
- Datenvalidierung anhand interner Standards
- Benutzerdefinierte Authentifizierungs- oder Sicherheitsanforderungen
- Mehrstufige Prozesse, die für Ihre Organisation spezifisch sind
Wie benutzerdefinierte MCP-Server funktionieren
Ein benutzerdefinierter MCP-Server ist ein leichtgewichtiger Dienst, der die Spezifikation des Model Context Protocol implementiert. Er stellt Endpunkte bereit, die Manus aufrufen kann, um Daten zu lesen, Aktionen durchzuführen oder benutzerdefinierte Logik innerhalb Ihrer Systeme auszuführen.Architektur
Ihr internes System ↔Benutzerdefinierter MCP-Server ↔Manus Der MCP-Server sitzt zwischen Manus und Ihren internen Systemen, übersetzt Manus-Anfragen in Aktionen innerhalb Ihrer Tools und gibt die Ergebnisse in einem Format zurück, das Manus versteht.Protokoll
Benutzerdefinierte MCP-Server implementieren ein standardisiertes Protokoll, das Folgendes definiert:- Tools: Aktionen, die Manus ausführen kann (z. B. „get_customer_data“, „update_project_status“)
- Ressourcen: Daten, die Manus lesen kann (z. B. Dokumente, Datensätze, Dateien)
- Prompts: Vordefinierte Vorlagen für gängige Operationen
Erstellen eines benutzerdefinierten MCP-Servers
Voraussetzungen
- API-Zugriff auf das System, das Sie integrieren möchten
- Entwicklungsumgebung (Node.js, Python oder jede Sprache, die einen Webserver ausführen kann)
- Verständnis der MCP-Spezifikation (verfügbar in der Manus-Dokumentation)
Grundlegende Implementierung
Ein minimaler benutzerdefinierter MCP-Server umfasst:- Server-Endpunkt: Ein Webdienst, der auf MCP-Protokollanfragen reagiert
- Tool-Definitionen: Beschreibungen der Aktionen, die Manus ausführen kann
- Authentifizierung: Sichere Handhabung von Anmeldeinformationen und API-Schlüsseln
- Anfrage-Handler: Logik, die Aktionen ausführt und Ergebnisse zurückgibt
Beispiel: Interne CRM-Integration
Hier ist ein konzeptionelles Beispiel für einen benutzerdefinierten MCP-Server für ein internes CRM: Exponierte Tools:get_customer_info(customer_id): Kundendetails abrufenupdate_customer_notes(customer_id, notes): Notizen zum Kundendatensatz hinzufügensearch_customers(query): Kundendatenbank durchsuchencreate_follow_up_task(customer_id, task_description, due_date): Aufgabe erstellen
- “Kundeninformationen für Kunden-ID 12345 abrufen”
- “Kunden im Raum San Francisco suchen”
- “Notizen für Kunde 67890 mit unserem letzten Gespräch aktualisieren”
Verbinden eines benutzerdefinierten MCP-Servers
Schritt 1: Stellen Sie Ihren Server bereit
Hosten Sie Ihren benutzerdefinierten MCP-Server auf einer Infrastruktur, die Sie kontrollieren. Stellen Sie sicher, dass er über HTTPS zugänglich ist und angemessene Sicherheitsmaßnahmen getroffen wurden.Schritt 2: Zu Manus hinzufügen
Navigieren Sie in Manus zuEinstellungen → Integrationen → Benutzerdefinierte MCP-Server und klicken Sie aufServer hinzufügen.Schritt 3: Serverdetails angeben
Geben Sie die folgenden Informationen ein:- Servername: Ein beschreibender Name (z. B. “Internes CRM”, “Analyseplattform”)
- Server-URL: Der HTTPS-Endpunkt, auf dem Ihr MCP-Server gehostet wird
- Authentifizierung: API-Schlüssel, Bearer-Token oder andere Anmeldeinformationen erforderlich
Schritt 4: Verbindung testen
Manus überprüft, ob es mit Ihrem Server kommunizieren und die Liste der verfügbaren Tools abrufen kann.Schritt 5: Starten Sie die Verwendung
Nach der Verbindung werden Ihre benutzerdefinierten Tools in den verfügbaren Integrationen von Manus angezeigt. Verweisen Sie in Prompt wie auf vorgefertigte Verbindungsstücke auf sie.Sicherheitsaspekte
Authentifizierung
Benutzerdefinierte MCP-Server sollten eine robuste Authentifizierung implementieren:- Verwenden Sie API-Schlüssel, OAuth-Tokens oder andere sichere Methoden
- Geben Sie Anmeldeinformationen niemals in URLs oder Protokollen preis
- Anmeldeinformationen regelmäßig rotieren
Autorisierung
Implementieren Sie ordnungsgemäße Autorisierungsprüfungen:- Überprüfen Sie, ob der anfragende Benutzer die Berechtigung zum Zugriff auf Daten hat
- Wenden Sie gegebenenfalls die rollenbasierte Zugriffskontrolle (RBAC) an
- Protokollieren Sie alle Zugriffsversuche zu Prüfzwecken
Datenübertragung
- Verwenden Sie HTTPS für die gesamte Kommunikation
- Verschlüsseln Sie sensible Daten im Ruhezustand und während der Übertragung
- Implementieren Sie Ratenbegrenzung, um Missbrauch zu verhindern
Netzwerksicherheit
- Stellen Sie MCP-Server innerhalb Ihres sicheren Netzwerkperimeters bereit
- Verwenden Sie Firewalls und Zugriffskontrollen, um einzuschränken, wer den Server erreichen kann
- Ziehen Sie VPN- oder private Netzwerkverbindungen für hochsensible Integrationen in Betracht
Best Practices
Tool-Design
Halten Sie Tools fokussiert: Jedes Tool sollte eine klare Aktion ausführen. Erstellen Sie anstelle eines einzelnen “manage_customer”-Tools separate Tools für “get_customer”, “update_customer” und “delete_customer”. Bieten Sie klare Beschreibungen: Manus verwendet Tool-Beschreibungen, um zu verstehen, wann welches Tool verwendet werden soll. Schreiben Sie klare, spezifische Beschreibungen, die erklären, was das Tool tut und wann es angemessen ist. Fehler elegant behandeln: Geben Sie aussagekräftige Fehlermeldungen zurück, die Manus (und Benutzern) helfen zu verstehen, was schief gelaufen ist und wie es behoben werden kann.Leistung
Antwortzeiten optimieren: Manus wartet auf Antworten des MCP-Servers. Halten Sie Vorgänge schnell, indem Sie Daten zwischenspeichern, effiziente Abfragen verwenden und unnötige Verarbeitung vermeiden. Timeouts implementieren: Legen Sie angemessene Timeouts für API-Aufrufe fest, um zu verhindern, dass Manus unbegrenzt wartet, wenn Ihr internes System langsam oder nicht reagiert. Verwenden Sie asynchrone Vorgänge für lange Aufgaben: Wenn ein Vorgang länger als ein paar Sekunden dauert, sollten Sie in Betracht ziehen, sofort mit einer Aufgaben-ID zurückzukehren und ein separates Tool zur Statusprüfung bereitzustellen.Überwachung
Alle Anfragen protokollieren: Verfolgen Sie, was Manus anfordert und wie Ihr Server antwortet. Dies hilft beim Debuggen und beim Verständnis von Nutzungsmustern. Leistung überwachen: Verfolgen Sie Antwortzeiten, Fehlerraten und Nutzungsvolumen, um Probleme zu erkennen, bevor sie sich auf Benutzer auswirken. Benachrichtigungen einrichten: Lassen Sie sich benachrichtigen, wenn Ihr MCP-Server nicht mehr reagiert oder anfängt, Fehler zurückzugeben.Anwendungsbeispiele
Interne Wissensdatenbank
Szenario: Ihre Organisation verfügt über ein internes Wiki oder eine Wissensdatenbank mit Unternehmensrichtlinien, Verfahren und Dokumentation. Benutzerdefinierter MCP Server: Bietet Tools zum Durchsuchen der Wissensdatenbank, zum Abrufen spezifischer Artikel und zum Finden verwandter Dokumente. Manus Workflow: “Suchen Sie in unserer internen Wissensdatenbank nach der Spesenabrechnungsrichtlinie und fassen Sie die wichtigsten Punkte zusammen.”Benutzerdefinierte Analyseplattform
Szenario: Sie haben eine proprietäre Analyseplattform, die Geschäftsmetriken verfolgt, die in Standard-Tools nicht verfügbar sind. Benutzerdefinierter MCP Server: Stellt Tools zum Abfragen von Metriken, Generieren von Berichten und Abrufen historischer Daten bereit. Manus Workflow: “Rufen Sie unsere Daten zu den Kundengewinnungskosten für Q4 ab und erstellen Sie eine Trendanalyse im Vergleich zu Q3.”Integration von Altsystemen
Szenario: Ihre Organisation stützt sich auf ein Altsystem, das keine modernen APIs oder Integrationen besitzt. Benutzerdefinierter MCP Server: Fungiert als Wrapper um das Altsystem und übersetzt moderne API-Aufrufe in das Format, das das Altsystem versteht. Manus Workflow: “Prüfen Sie die Lagerbestände im Altsystem für Produkt-SKU 98765 und erstellen Sie eine Nachbestellanforderung, wenn der Bestand unter 100 Einheiten liegt.”Mehrstufige Genehmigungs-Workflows
Szenario: Ihre Organisation benötigt Genehmigungs-Workflows für bestimmte Aktionen (z. B. Budgetanfragen, Datenzugriff). Benutzerdefinierter MCP Server: Implementiert Tools, die Genehmigungsanfragen erstellen, den Genehmigungsstatus prüfen und genehmigte Aktionen ausführen. Manus Workflow: “Erstellen Sie eine Budgetanfrage über 50.000 US-Dollar für die Marketingkampagne und benachrichtigen Sie das Finanzteam zur Genehmigung.”Häufig gestellte Fragen
Muss ich Entwickler sein, um benutzerdefinierte MCP-Server zu erstellen?
Muss ich Entwickler sein, um benutzerdefinierte MCP-Server zu erstellen?
Das Erstellen benutzerdefinierter MCP-Server erfordert Entwicklungsfähigkeiten. Die MCP-Spezifikation ist jedoch unkompliziert, und es stehen Beispielimplementierungen zur Verfügung, die Ihnen den Einstieg erleichtern.
Kann ich bestehende APIs verwenden, ohne einen benutzerdefinierten Server zu erstellen?
Kann ich bestehende APIs verwenden, ohne einen benutzerdefinierten Server zu erstellen?
Wenn ein Dienst über eine gut dokumentierte REST-API verfügt, können Sie möglicherweise die allgemeinen API-Aufruffunktionen von Manus ohne einen benutzerdefinierten MCP-Server nutzen. Ein benutzerdefinierter Server bietet jedoch eine bessere Integration, klarere Tool-Definitionen und zuverlässigere Workflows.
Gibt es Leistungsanforderungen?
Gibt es Leistungsanforderungen?
Benutzerdefinierte MCP-Server sollten für die meisten Vorgänge innerhalb weniger Sekunden reagieren. Längere Vorgänge sollten asynchrone Muster verwenden. Manus bricht Anfragen ab, die zu lange dauern.
Wie pflege ich benutzerdefinierte MCP-Server?
Wie pflege ich benutzerdefinierte MCP-Server?
Behandeln Sie benutzerdefinierte MCP-Server wie jeden anderen internen Dienst: Versionskontrolle, automatisierte Tests, Überwachung und regelmäßige Updates. Halten Sie den Server synchron mit Änderungen an den APIs Ihrer internen Systeme.