Konfigurieren externer Tools mit MCP-Servern

Hinzufügen, Verwalten und Konfigurieren von MCP-Servern für Delegate, einschließlich benutzerdefinierter Server, Settings_v2.json, und MCP-Apps.

MCP ist ein offenes Protokoll, über das KI-Assistenten mit externen Datenquellen und Tools verbunden werden können. Im Gegensatz zu Integration Service-Connectors können MCP-Server remote (an anderer Stelle gehostet und über HTTP aufgerufen) oder lokal (ein Programm, das auf Ihrem Computer ausgeführt wird) sein.

Die meisten MCP-Server müssen nicht manuell konfiguriert werden. Weitere Informationen finden Sie in der Referenz zu MCP-Servern. Dort werden der vom Orchestrator unterstützte Katalog und der Marketplace von Drittanbietern beschrieben, über die sich Server mit nur einem Klick hinzufügen lassen.

Hinzufügen eines benutzerdefinierten MCP-Servers

Wenn ein Server nicht im Katalog oder Marketplace aufgeführt ist, fügen Sie ihn manuell über „Add-ons und Integrationen“ → „MCP-Server“ hinzu.

Remote-MCP-Server

Remote-MCP-Server werden an anderer Stelle gehostet und über HTTP aufgerufen:

1. Wählen Sie „MCP-Server hinzufügen“ → „Remote“ aus.
2. Geben Sie die Serverdetails ein:
   • URL: die Endpunktadresse (z. B. https://api.example.com/mcp)
   • Titel: eine aussagekräftige Bezeichnung (z. B. „Unternehmens-API“)
   • Header (optional): Authentifizierungsheader, falls erforderlich
3. Wählen Sie Speichern.
4. Schalten Sie zum Aktivieren auf Aktiviert um.

Beispielkonfiguration:

{
  "type": "remote",
  "url": "https://internal-api.company.com/mcp",
  "enabled": true,
  "title": "Company Data API",
  "headers": {
    "Authorization": "<your-access-token>"
  }
}

Lokale MCP-Server

Lokale MCP-Server werden als Prozesse auf Ihrer Maschine ausgeführt:

1. Wählen Sie „MCP-Server hinzufügen“ → „Lokal“ aus.
2. Geben Sie die Serverdetails ein:
   • Titel: eine aussagekräftige Bezeichnung
   • Befehl: das auszuführende Programm (z. B. node, python, /path/to/server)
   • Argumente: Befehlszeilenargumente
   • Arbeitsverzeichnis: Verzeichnis, in dem der Befehl ausgeführt wird
   • Umgebungsvariablen: Schlüssel-Wert-Paare für den Prozess
3. Wählen Sie Speichern.
4. Schalten Sie zum Aktivieren auf Aktiviert um.

Beispielkonfigurationen

Filesystem-MCP-Server:

{
  "type": "local",
  "enabled": true,
  "serverId": "filesystem-mcp",
  "title": "Local Filesystem Access",
  "config": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/username/Documents"],
    "env": {},
    "cwd": "/Users/username"
  }
}

GitHub-MCP-Server:

{
  "type": "local",
  "enabled": true,
  "serverId": "github-mcp",
  "title": "GitHub Integration",
  "config": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-github"],
    "env": {
      "GITHUB_PERSONAL_ACCESS_TOKEN": "<your-github-token>"
    },
    "cwd": "/Users/username"
  }
}

Verwalten von MCP-Servern

Unter Add-ons und Integrationen → MCP-Server können Sie einen konfigurierten Server aktivieren oder deaktivieren, seine Konfiguration bearbeiten oder ihn entfernen. Durch das Deaktivieren eines Servers wird verhindert, dass der Agent dessen Tools verwendet. Ein bereits laufender lokaler Serverprozess wird dadurch jedoch nicht beendet – diesen müssen Sie gegebenenfalls selbst beenden.

Wie der Agent MCP-Tools erkennt

Wenn ein MCP-Server aktiviert ist, stellt der Agent eine Verbindung zu ihm her. Der Server meldet seine verfügbaren Tools, die daraufhin in der Konversation zur Verfügung stehen – eine manuelle Registrierung ist nicht erforderlich. Sie können in natürlicher Sprache auf diese Tools verweisen, z. B.: „Verwenden Sie das Dateisystem-Tool, um den Inhalt meines Ordners ‚Dokumente‘ aufzulisten.“

MCP Apps: Interaktive Inline-Schnittstellen

MCP-Apps ist eine Erweiterung des Model Context Protocol, mit der ein Tool statt ausschließlich Text eine interaktive Oberfläche zurückgeben kann – beispielsweise ein Formular, ein Dashboard, ein Diagramm oder eine Datentabelle. Wenn das Tool eines verbundenen MCP-Servers diese Funktion unterstützt, zeigt Delegate die Oberfläche direkt in der Konversation in einem isolierten Frame an. Die Oberfläche kann die eigenen Tools des Servers aufrufen und Aktualisierungen empfangen, hat jedoch keinen Zugriff auf Inhalte außerhalb dieses Frames. Die Formulare sind bereits mit sinnvollen Werten vorausgefüllt, sodass Sie nur die relevanten Angaben ändern müssen, anstatt jedes Feld im Chat zu beschreiben.

Ob ein bestimmter MCP-Server diese Funktion unterstützt, hängt vom jeweiligen Server ab – nicht jeder Server implementiert diese Erweiterung.

Administratoren können MCP-Server auf Richtlinienebene steuern – siehe MCP-Server in Governance mit Automation Ops.

Erweitert: Verbindungsverwaltung über Settings_v2.json

Erfahrene Benutzer können MCP-Serververbindungen direkt in settings_v2.json verwalten – in derselben mcpServers-Liste, auf die auch die Benutzeroberfläche lesend und schreibend zugreift:

{
  "mcpServers": [
    {
      "type": "remote",
      "url": "https://api.example.com/mcp",
      "enabled": true,
      "title": "Example API",
      "headers": {
        "Authorization": "<your-access-token>"
      }
    },
    {
      "type": "local",
      "enabled": true,
      "serverId": "my-local-server",
      "title": "Local Tools",
      "config": {
        "command": "python",
        "args": ["/path/to/server.py"],
        "env": { "API_KEY": "<your-api-key>" },
        "cwd": "/path/to/working/dir"
      }
    }
  ]
}

Bearbeiten Sie settings_v2.json nur, wenn Sie mit JSON vertraut sind – eine ungültige Syntax verhindert, dass die App geladen wird. Erstellen Sie vor jeder Bearbeitung immer eine Sicherungskopie. Siehe Speicherorte der Einstellungsdateien.

Sicherheitsüberlegungen und Datenflussinformationen für Verbindungen finden Sie unter Lokale Sicherheitskonfiguration.

Nächste Schritte

• Referenz zu MCP-Servern – Der Orchestrator-Katalog und Marketplace von Drittanbietern
• Herstellen einer Verbindung mit gängigen Geschäftsanwendungen – für verwaltete SaaS-Integrationen
• Wiederholen der Arbeit mit Routinen – Workflows speichern, die Ihre verbundenen Tools verwenden
• Teilen von Skills mit Ihrem Team – Finden Sie vorgefertigte Skills für Ihre verbundenen Dienste