Zum Hauptinhalt springen

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 SystemBenutzerdefinierter MCP-ServerManus 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:
  1. Server-Endpunkt: Ein Webdienst, der auf MCP-Protokollanfragen reagiert
  2. Tool-Definitionen: Beschreibungen der Aktionen, die Manus ausführen kann
  3. Authentifizierung: Sichere Handhabung von Anmeldeinformationen und API-Schlüsseln
  4. 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 abrufen
  • update_customer_notes(customer_id, notes): Notizen zum Kundendatensatz hinzufügen
  • search_customers(query): Kundendatenbank durchsuchen
  • create_follow_up_task(customer_id, task_description, due_date): Aufgabe erstellen
Authentifizierung: API-Schlüssel oder OAuth-Token für Ihr internes CRM Bereitstellung: Gehostet auf Ihrer Infrastruktur oder einer sicheren Cloud-Umgebung Nach der Bereitstellung verbinden Sie diesen benutzerdefinierten Server mit Manus, und er wird neben den vorgefertigten Konnektoren angezeigt. Sie können dann natürliche Sprachprompts verwenden wie:
  • “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

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.
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.
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.
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.