DokumentErweiterungs-ökosystemMcp-integration

Mcp-integration

Statten Sie den Agenten im Workflow mit einem beliebigen MCP Server als Werkzeug aus, um seinen Handlungsspielraum zu erweitern.

MCP (Model Context Protocol) ist ein offenes Protokoll, das externe Tools auf einheitliche Weise für ein LLM bereitstellt. In Braidrun hängt MCP am Agent: Konfigurieren Sie für einen Agent einen oder mehrere MCP server, erscheinen die von diesen server bereitgestellten Tools genau wie die integrierten Tools in der Liste der von diesem Agent aufrufbaren Tools.

Funktionsweise

Die MCP-Konfiguration ist auf Agent-Ebene: Im Workflow-YAML ist mcp_servers jedes Agents eine Zuordnung „Name → Konfiguration“, an die sich mehrere server gleichzeitig hängen lassen. Vor der Schrittausführung verbindet sich die Laufzeit nacheinander mit diesen server und nimmt deren Tools in die Tool-Registry dieses Agents auf.

Schlägt die Verbindung zu einem MCP server fehl, protokolliert die Laufzeit eine Warnung und überspringt dessen Tools, ohne den gesamten Workflow abzubrechen — die übrigen server und die integrierten Tools bleiben wie gewohnt verfügbar. Stammt ein von einem Schritt benötigtes Tool von einem nicht verbundenen server, zeigt sich der Fehler im Ausführungslog dieses Schritts.

Einen lokalen stdio server anbinden

Die häufigste Form: Der MCP server ist ein lokaler Prozess, den die Laufzeit mit command + args startet und über Standard-Ein-/Ausgabe kommuniziert. Wird der Agent per preset deklariert, wird mcp_servers in overrides geschrieben:

yaml

agents:
  researcher:
    preset: universal
    overrides:
      mcp_servers:
        github:
          command: npx
          args: ["-y", "@modelcontextprotocol/server-github"]
          env:
            GITHUB_PERSONAL_ACCESS_TOKEN: "<your-token>"
          description: "读写 GitHub 仓库与 issue"

Im preset-Modus muss es in overrides stehen

Wenn ein Agent ein preset deklariert, führt die Laufzeit nur die preset-Standardwerte und die Felder in overrides zusammen; ein auf der obersten Ebene des Agents geschriebenes mcp_servers wird ignoriert.

Einen entfernten server verbinden

Ein MCP server kann auch ein Netzwerkdienst sein: Wird url angegeben, wird nicht mehr stdio verwendet; type bestimmt die Transportart (sse, websocket, http), und ohne Angabe von type wird sse angenommen.

yaml

agents:
  analyst:
    preset: universal
    overrides:
      mcp_servers:
        crm:
          url: "https://mcp.example.com/sse"
          type: sse
          timeout: 60000
        docs-search:
          url: "https://mcp.example.com/mcp"
          type: http
          enabled: true

Der von url bezeichnete Dienst muss aus der Laufzeitumgebung des Workflows erreichbar sein — geben Sie eine öffentlich erreichbare Adresse an, keine, die nur von Ihrem lokalen Rechner aus zugänglich ist.

Feldreferenz

Feld	Beschreibung
`command`	Startbefehl im stdio-Modus (Name oder Pfad der ausführbaren Datei); im stdio-Modus Pflichtfeld
`args`	Liste der Kommandozeilenargumente
`env`	An den stdio-Unterprozess übergebene Umgebungsvariablen; Zugangsdaten werden hierüber übergeben
`cwd`	Arbeitsverzeichnis des stdio-Unterprozesses; ohne Angabe wird der Laufzeit-Standard verwendet
`url`	Adresse des entfernten server; wird url angegeben, wird nicht mehr stdio verwendet
`type`	Transporttyp: stdio (Standard), sse, websocket, http; wirksam nur bei angegebener url, ohne Angabe wird sse angenommen
`timeout`	Timeout in Millisekunden, Standard 30000
`enabled`	Standard true; auf false gesetzt lässt sich ein server vorübergehend deaktivieren, ohne die Konfiguration zu löschen
`description`	Anmerkung, die Mitarbeitern hilft zu verstehen, wofür dieser server da ist

Hinweise zu Zugangsdaten und Netzwerk

Der stdio-Unterprozess erbt nicht alle Variablen der Laufzeitumgebung: Nur wenige Basisvariablen wie PATH, HOME, LANG sowie das, was Sie in env explizit angeben, werden übergeben. Ein vom MCP server benötigter API Key muss explizit in env geschrieben werden.
Die Werte von env werden im Klartext im Workflow-YAML gespeichert. Ersetzen Sie vor dem Teilen eines Workflows oder Veröffentlichen einer Vorlage die echten Schlüssel durch Platzhalter, damit die Nutzer ihre eigenen eintragen.
Für entfernte server wird eine HTTPS-Adresse empfohlen; eine fehlgeschlagene Verbindung wird wie oben beschrieben übersprungen, und Sie können zunächst im Ausführungslog prüfen, ob die Tools erfolgreich registriert wurden.
Je mehr Tools, desto größer der Entscheidungsraum des Agents. Hängen Sie nur die server an, die dieser Agent tatsächlich nutzt — Erfolgsrate und Geschwindigkeit werden dadurch besser.

Mcp-bereitstellung der Braidrun-Tools

Auch dieser Weg ist bidirektional: Die integrierten Tools von Braidrun selbst sind als stdio MCP server (namens braidrun-workflow) verpackt, sodass sich dasselbe Toolset über das MCP-Protokoll anderen MCP-Clients zur Wiederverwendung bereitstellen lässt.

Verhältnis zu Claude Code / Codex

Im Produkt kann der KI-Assistent Koog, Claude Code oder Codex als Laufzeit wählen und unterstützt die Anmeldung per Abonnement anstelle eines API Key. Zum Wechsel der Laufzeit siehe die Dokumentation des KI-Assistenten.