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 |
|---|---|---|
| Bei HTTP | "stdio" startet einen lokalen Prozess (Standard bei fehlender Angabe), "http" verwendet Streamable HTTP. Eine URL allein wählt den Verbindungstyp nicht aus. |
| Bei stdio | Ausführbare Datei zum Starten des Servers. Argumente werden separat angegeben. |
| Nein | Liste einzelner Argumente, z. B. der Skriptpfad. |
| Nein | Zusätzliche Umgebungsvariablen für den stdio-Prozess als Schlüssel/Wert-Paare mit Zeichenketten. |
| Nein | Arbeitsverzeichnis für den stdio-Prozess. Verwenden Sie vorzugsweise einen absoluten Pfad. |
| Bei HTTP | Vollständige URL des MCP-Endpunkts, nicht einer Webseite oder eines älteren SSE-Endpunkts. |
| Nein | HTTP-Header als Schlüssel/Wert-Paare mit Zeichenketten, etwa zur Authentifizierung. |
| Nein | Zeitlimit in Sekunden für den Verbindungsaufbau und Anfragen an den Server (Standard: 15). Die Kurzform |
| Nein | Zeitlimit in Sekunden für einen Tool-Aufruf dieses Servers. Ohne Angabe gilt MCP Tool Call Timeout aus den allgemeinen Einstellungen. |
| Nein | Zusätzliche Optionen als Objekt: |
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.