Eigene MCP-Server

CoAgent kann um eigene MCP-Server erweitert werden. Tragen Sie projektspezifische Server in .coagent/mcp.json im Ordner der TwinCAT-Solution ein (siehe Kapitel Projekt-Workspace). Legen Sie die Datei bei Bedarf an. Sie wird für die geöffnete Solution geladen; Änderungen werden automatisch übernommen (Hot-Reload). Ein projektspezifischer Eintrag hat Vorrang vor einem globalen Eintrag mit demselben Servernamen.

Verwenden Sie gültiges JSON mit doppelten Anführungszeichen, ohne Kommentare oder abschließende Kommas. Windows-Pfade können mit / oder mit verdoppelten Rückwärtsschrägstrichen ( \\ ) angegeben werden.

Beispiel einer MCP-Server-Konfiguration:

{
  "mcpServers": {
    "mein-server": {
      "type": "stdio",
      "command": "C:/Pfad/zur/python.exe",
      "args": ["C:/Pfad/zum/server.py"],
      "env": {
        "MEINE_VARIABLE": "wert"
      }
    }
  }
}

Passen Sie den ausführbaren Programmpfad und den Skriptpfad an die lokale Installation an. Für einen entfernten Server über Streamable HTTP geben Sie stattdessen dessen MCP-Endpunkt an:

{
  "mcpServers": {
    "mein-http-server": {
      "type": "http",
      "url": "https://mcp.example.com/mcp"
    }
  }
}

Die URL ist ein Platzhalter. Ergänzen Sie gegebenenfalls die vom Server geforderten Authentifizierungsheader. Die folgende Tabelle beschreibt die Parameter für diese Verbindungstypen:

Parameter

Erforderlich

Bedeutung

type

Bei HTTP

"stdio" startet einen lokalen Prozess (Standard bei fehlender Angabe), "http" verwendet Streamable HTTP. Eine URL allein wählt den Verbindungstyp nicht aus.

command

Bei stdio

Ausführbare Datei zum Starten des Servers. Argumente werden separat angegeben.

args

Nein

Liste einzelner Argumente, z. B. der Skriptpfad.
Standard: leere Liste.

env

Nein

Zusätzliche Umgebungsvariablen für den stdio-Prozess als Schlüssel/Wert-Paare mit Zeichenketten.

cwd

Nein

Arbeitsverzeichnis für den stdio-Prozess. Verwenden Sie vorzugsweise einen absoluten Pfad.

url

Bei HTTP

Vollständige URL des MCP-Endpunkts, nicht einer Webseite oder eines älteren SSE-Endpunkts.

headers

Nein

HTTP-Header als Schlüssel/Wert-Paare mit Zeichenketten, etwa zur Authentifizierung.

timeout_in_seconds

Nein

Zeitlimit in Sekunden für den Verbindungsaufbau und Anfragen an den Server (Standard: 15). Die Kurzform timeout wird ebenfalls angenommen. Bei stdio-Servern gilt ein gesetzter Wert auch für Tool-Aufrufe, sofern tool_call_timeout_in_seconds nicht angegeben ist.

tool_call_timeout_in_seconds

Nein

Zeitlimit in Sekunden für einen Tool-Aufruf dieses Servers. Ohne Angabe gilt MCP Tool Call Timeout aus den allgemeinen Einstellungen.

mcp_config

Nein

Zusätzliche Optionen als Objekt: active_solution (true = der Server erhält beim Start den Ordner der geöffneten Solution als Argument --active_solution, nur stdio) und trust_annotations (true = die Read-only-Kennzeichnung der Tools dieses Servers wird für die Einstufung als Lese-Tool übernommen, Standard false).

Tool-Freigaben werden wie im Kapitel Tool-Freigaben beschrieben verwaltet. Wählen Sie die benötigten Tools zusätzlich für den Agenten aus.

Zum Erstellen eines MCP-Servers wird das Python-Paket mcp ( pip install mcp ) oder ein kompatibles SDK verwendet. Die Spezifikation ist unter https://modelcontextprotocol.io/ abrufbar.