Konfigurieren externer Tools mit MCP-Servern

Add, manage, and configure MCP servers for Cartographer, including custom servers, settings_v2.json, and MCP Apps.

MCP ist ein offenes Protokoll für die Verbindung von KI-Assistenten mit externen Datenquellen und Tools. Im Gegensatz zu Integration Service-Connectors können MCP-Server remote ( anderswo gehostet, Zugriff über HTTP) oder lokal (ein Programm, das auf Ihrer Maschine ausgeführt wird) sein.

Die meisten MCP-Server müssen nicht manuell konfiguriert werden – siehe MCP-Serverreferenz für den Orchestrator-gestützten Katalog und den Marketplace eines Drittanbieters, die beide einen Server mit einem Klick hinzufügen.

Hinzufügen eines benutzerdefinierten MCP-Servers

Fügen Sie einen Server, der nicht im Katalog oder Marketplace enthalten ist, manuell über Add-ons und Integrationen → MCP-Server hinzu.

Remote-MCP-Server

Remote-MCP-Server werden anderswo gehostet und über HTTP aufgerufen:

1. Wählen Sie MCP-Server hinzufügen → Remote.
2. Geben Sie die Serverdetails ein:
   • URL: Die Endpunktadresse (z. B. https://api.example.com/mcp)
   • Titel: ein gebräuchlicher Name (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.
2. Geben Sie die Serverdetails ein:
   • Titel: ein gebräuchlicher Name
   • Befehl: Die auszuführende ausführbare Datei (z. B. node, python, /path/to/server)
   • Argumente: Befehlszeilenargumente
   • Arbeitsverzeichnis: Hier wird der Befehl ausgeführt
   • Umgebungsvariablen: Schlüssel-Wert-Paare für den Prozess
3. Wählen Sie Speichern.
4. Schalten Sie zum Aktivieren auf Aktiviert um.

Beispielkonfigurationen

Dateisystem-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-access-token>"
    },
    "cwd": "/Users/username"
  }
}

Verwalten von MCP-Servern

Unter Add-ons und Integrationen → MCP-Server können Sie einen konfigurierten Server ein- oder ausschalten, seine Konfiguration bearbeiten oder entfernen. Wenn Sie einen Server deaktivieren, kann der Agent seine Tools nicht mehr verwenden, aber ein lokaler Serverprozess, der bereits ausgeführt wird, wird nicht gestoppt – möglicherweise müssen Sie diesen Prozess selbst stoppen.

Wie der Agent MCP-Tools erkennt

Wenn ein MCP-Server aktiviert ist, stellt der Agent eine Verbindung damit her, der Server meldet seine verfügbaren Tools und diese Tools werden im Gespräch verfügbar – keine manuelle Registrierung erforderlich. Sie können in natürlicher Sprache darauf verweisen, z. B.: „Verwenden Sie das Dateisystemtool, um meinen Dokumentenordner aufzulisten.“

MCP-Apps: Interaktive Inline-Schnittstellen

MCP Apps ist eine Erweiterung des Model Context Protocol, mit der ein Tool eine interaktive Oberfläche – ein Formular, ein Dashboard, ein Diagramm, eine Datentabelle – anstelle von nur Text zurückgeben kann. Wenn das Tool eines verbundenen MCP-Servers dies unterstützt, stellt Cartographer diese Schnittstelle inline in der Konversation in einem Sandbox-Framework dar: Die Schnittstelle kann die eigenen Tools des Servers aufrufen und Updates erhalten, aber nichts außerhalb ihres eigenen Frameworks aufrufen. Formulare werden mit sinnvollen Werten vorab ausgefüllt, sodass Sie nur das Wesentliche ändern, anstatt jedes Feld im Chat zu beschreiben.

Ob ein bestimmter MCP-Server dies bietet, hängt von diesem Server ab – nicht jeder Server implementiert die Erweiterung.

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

Advanced: connection management via settings_v2.json

Hauptbenutzer können MCP-Serververbindungen direkt in settings_v2.json verwalten – derselben mcpServers -Liste, die die Benutzeroberfläche liest und schreibt:

{
  "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 zufrieden sind – eine ungültige Syntax verhindert, dass die App geladen wird. Sichern Sie immer vor der Bearbeitung. Siehe Speicherorte der Einstellungsdatei.

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

Nächste Schritte

• MCP-Serverreferenz – Der Orchestrator-Katalog und der Marketplace eines Drittanbieters
• Herstellen einer Verbindung mit gängigen Geschäftsanwendungen – Für verwaltete SaaS-Integrationen
• Repeating work with Routines — Save workflows that use your connected tools
• Freigabe von Fähigkeiten mit Ihrem Team – Finden Sie vorgefertigte Fähigkeiten für Ihre verbundenen Dienste