Tutorials

KI-Copilot: MCP-Tools für TIA Portal

Lassen Sie KI-Agenten Ihr Projekt einsehen, Ihre Variablen kennen und auf Ihre SPS einwirken — mit 31 spezialisierten Tools.

T
T-IA Connect Team
15 Min. Lesezeit
Aktualisiert am 11. März 2026

Warum MCP alles verändert

Klassische KI-Assistenten (ChatGPT, Copilot) leiden unter einem gravierenden Problem in der industriellen Automatisierung: kontextuelle Halluzination. Sie generieren syntaktisch korrekten SCL-Code, verwenden aber Variablen, die nicht existieren, falsche Datentypen oder ignorieren Ihre Hardwarekonfiguration. Mit dem integrierten MCP-Server von T-IA Connect kann die KI Ihr Projekt einsehen, Ihre Variablentabellen lesen, vorhandene Bausteine inspizieren — und tatsächlich Code in TIA Portal erstellen oder ändern.

Voraussetzungen

  • T-IA Connect installiert und aktiv
  • Ein geöffnetes TIA Portal Projekt (V16–V21)
  • Ein MCP-kompatibler KI-Client (Claude Desktop oder ein beliebiger MCP-Client)

Einrichtung: Ihre KI mit TIA Portal verbinden

Fügen Sie T-IA Connect als MCP-Server in Ihrer Claude Desktop Konfigurationsdatei (claude_desktop_config.json) hinzu:

claude_desktop_config.json
{
  "mcpServers": {
    "tia-connect": {
      "command": "C:\\Program Files\\FeelAutomCorp\\TiaConnect\\TiaPortalApi.McpBridge.exe",
      "args": [],
      "env": {
        "TIA_CONNECT_URL": "http://localhost:9000",
        "TIA_CONNECT_API_KEY": "your-api-key"
      }
    }
  }
}

Die McpBridge.exe fungiert als stdio-zu-HTTP-Brücke. Sie leitet KI-Anfragen an den T-IA Connect API-Server weiter, der über Openness mit TIA Portal kommuniziert.

Beispiel 1: Projektstatus prüfen

Das einfachste Tool — prüfen Sie die Verbindung zum TIA Portal und sehen Sie, welches Projekt geöffnet ist.

MCP Tool: get_project_status
{
  "name": "get_project_status",
  "arguments": {}
}
Response
{
  "connected": true,
  "projectName": "WaterTreatment_V19",
  "projectPath": "C:\TIA_Projects\WaterTreatment_V19",
  "tiaVersion": "V19",
  "modified": false
}

Beispiel 2: Ein Projekt öffnen

Öffnen Sie eine TIA Portal Projektdatei direkt über die KI. Sie können auch verfügbare Projekte auf der Festplatte mit list_project_files scannen.

MCP Tool: open_project
{
  "name": "open_project",
  "arguments": {
    "path": "C:\TIA_Projects\WaterTreatment_V19\WaterTreatment_V19.ap19"
  }
}
Response
{
  "success": true,
  "projectName": "WaterTreatment_V19",
  "version": "V19"
}

Beispiel 3: Geräte auflisten

Sehen Sie alle SPSen, HMIs und andere Geräte im aktuellen Projekt.

MCP Tool: list_devices
{
  "name": "list_devices",
  "arguments": {}
}
Response
[
  {
    "name": "PLC_1",
    "type": "CPU 1516-3 PN/DP",
    "category": "PLC"
  },
  {
    "name": "HMI_1",
    "type": "TP1500 Comfort",
    "category": "HMI"
  }
]

Beispiel 4: Bausteine auflisten & lesen

Durchsuchen Sie alle Bausteine (FB, FC, DB, OB) einer SPS und lesen Sie dann den vollständigen Code und die Schnittstelle eines beliebigen Bausteins.

MCP Tool: list_blocks → get_block_details
// Step 1: List all blocks
{ "name": "list_blocks", "arguments": { "deviceName": "PLC_1" } }

// Step 2: Read a specific block
{ "name": "get_block_details", "arguments": {
    "deviceName": "PLC_1",
    "blockName": "FB_MotorControl"
  }
}
Response
// list_blocks response
[
  { "name": "Main [OB1]", "type": "OB", "language": "LAD", "number": 1 },
  { "name": "FB_MotorControl", "type": "FB", "language": "SCL", "number": 1 },
  { "name": "DB_Config", "type": "DB", "language": "DB", "number": 1 }
]

// get_block_details response
{
  "name": "FB_MotorControl",
  "type": "FB",
  "language": "SCL",
  "interface": {
    "input": [
      { "name": "Start", "type": "Bool" },
      { "name": "Stop", "type": "Bool" },
      { "name": "SpeedSetpoint", "type": "Real" }
    ],
    "output": [
      { "name": "Running", "type": "Bool" },
      { "name": "Speed", "type": "Real" }
    ]
  },
  "code": "#Running := #Start AND NOT #Stop;\nIF #Running THEN\n  #Speed := #SpeedSetpoint;\nEND_IF;"
}

Beispiel 5: Einen SCL-Baustein erstellen

Das leistungsstärkste Tool — erstellen Sie einen Funktionsbaustein mit SCL-Code, typisierten Variablen und einer vollständigen Schnittstellendefinition. Die KI kann diesen Code aus einer natürlichsprachlichen Beschreibung Ihrer Anforderungen generieren.

MCP Tool: create_scl_block
{
  "name": "create_scl_block",
  "arguments": {
    "deviceName": "PLC_1",
    "blockName": "FB_ValveControl",
    "blockType": "FB",
    "interface": {
      "input": [
        { "name": "Open", "type": "Bool" },
        { "name": "Close", "type": "Bool" },
        { "name": "Timeout", "type": "Time", "defaultValue": "T#5s" }
      ],
      "output": [
        { "name": "IsOpen", "type": "Bool" },
        { "name": "IsClosed", "type": "Bool" },
        { "name": "Error", "type": "Bool" }
      ]
    },
    "sclCode": "IF #Open AND NOT #Close THEN\n  #IsOpen := TRUE;\n  #IsClosed := FALSE;\nELSIF #Close THEN\n  #IsOpen := FALSE;\n  #IsClosed := TRUE;\nEND_IF;"
  }
}
Response
{
  "name": "FB_ValveControl",
  "type": "FB",
  "number": 2,
  "created": true
}

Beispiel 6: Variablen verwalten

Variablentabellen auflisten, Variablen durchsuchen und neue Tags mit korrekten Adressen und Datentypen erstellen.

MCP Tools: list_tags → create_tag
// List existing tags
{ "name": "list_tags", "arguments": {
    "deviceName": "PLC_1",
    "tableName": "Motors"
  }
}

// Create a new tag
{ "name": "create_tag", "arguments": {
    "deviceName": "PLC_1",
    "tableName": "Motors",
    "name": "Motor2_Start",
    "dataType": "Bool",
    "logicalAddress": "%I0.2"
  }
}
Response
// list_tags response
[
  { "name": "Motor1_Start", "dataType": "Bool", "address": "%I0.0" },
  { "name": "Motor1_Stop", "dataType": "Bool", "address": "%I0.1" },
  { "name": "Motor1_Running", "dataType": "Bool", "address": "%Q0.0" }
]

// create_tag response
{
  "name": "Motor2_Start",
  "dataType": "Bool",
  "address": "%I0.2",
  "created": true
}

Beispiel 7: Kompilieren

Lösen Sie die Kompilierung eines Geräts aus, um den generierten Code zu validieren. Fehler und Warnungen werden zurückgegeben, damit die KI Probleme automatisch beheben kann.

MCP Tool: compile_device
{
  "name": "compile_device",
  "arguments": { "deviceName": "PLC_1" }
}
Response
{
  "success": true,
  "errors": [],
  "warnings": [
    "FB_ValveControl: Variable 'Timeout' declared but not used"
  ],
  "warningCount": 1,
  "errorCount": 0
}

Beispiel 8: Hardwarekatalog durchsuchen

Durchsuchen Sie den Siemens-Hardwarekatalog und fügen Sie Geräte zu Ihrem Projekt hinzu — alles per natürlicher Sprache.

MCP Tools: search_hardware_catalog → add_device
// Search the catalog
{ "name": "search_hardware_catalog", "arguments": {
    "query": "CPU 1511"
  }
}

// Add the device
{ "name": "add_device", "arguments": {
    "deviceName": "PLC_2",
    "typeIdentifier": "OrderNumber:6ES7 511-1AK02-0AB0/V2.9"
  }
}
Response
// search_hardware_catalog response
[
  {
    "name": "CPU 1511C-1 PN",
    "typeIdentifier": "OrderNumber:6ES7 511-1CK01-0AB0/V2.9",
    "version": "V2.9"
  },
  {
    "name": "CPU 1511-1 PN",
    "typeIdentifier": "OrderNumber:6ES7 511-1AK02-0AB0/V2.9",
    "version": "V2.9"
  }
]

// add_device response
{
  "name": "PLC_2",
  "type": "CPU 1511-1 PN",
  "added": true
}

Beispiel 9: HMI-Bilder

WinCC-HMI-Bilder auflisten, erstellen und inspizieren. Das vollständige XML-Design zur Analyse abrufen.

MCP Tools: list_hmi_screens → create_hmi_screen
// List screens
{ "name": "list_hmi_screens", "arguments": {
    "deviceName": "HMI_1"
  }
}

// Create a new screen
{ "name": "create_hmi_screen", "arguments": {
    "deviceName": "HMI_1",
    "screenName": "MotorOverview"
  }
}
Response
// list_hmi_screens response
[
  { "name": "MainScreen", "type": "Screen" },
  { "name": "AlarmView", "type": "Screen" }
]

// create_hmi_screen response
{
  "name": "MotorOverview",
  "created": true
}

Beispiel 10: Speichern, Archivieren & Schließen

Vollständiges Projektlebenszyklusmanagement — speichern Sie Ihre Arbeit, erstellen Sie Sicherungsarchive und schließen Sie sauber ab.

MCP Tools: save → archive → close
{ "name": "save_project", "arguments": {} }

{ "name": "archive_project", "arguments": {
    "targetDirectory": "C:\TIA_Backups",
    "archiveName": "WaterTreatment_backup_2026-03-11"
  }
}

{ "name": "close_project", "arguments": {} }
Response
{ "saved": true }

{
  "archivePath": "C:\TIA_Backups\WaterTreatment_backup_2026-03-11.zap19",
  "size": "45.2 MB",
  "created": true
}

{ "closed": true }

Vollständige Tool-Referenz (31 Tools)

Hier finden Sie die vollständige Liste der MCP-Tools in T-IA Connect, nach Kategorien geordnet.

Projektverwaltung

ToolDescriptionParameters
get_project_statusGet current project status
list_project_filesScan disk for TIA projectspath?
open_projectOpen a .ap* project filepath
create_projectCreate an empty TIA projectpath, name
close_projectClose the active project
save_projectSave the current project
archive_projectCreate a .zap backuptargetDirectory, archiveName
retrieve_projectRestore from .zap backuparchivePath, targetDirectory

Hardware & Netzwerk

ToolDescriptionParameters
list_devicesList all devices (PLC, HMI)
search_hardware_catalogSearch Siemens hardware catalogquery
add_deviceAdd a device to the projectdeviceName, typeIdentifier
delete_deviceRemove a devicedeviceName
rename_deviceRename a devicecurrentName, newName
configure_networkSet IP / subnet / gatewaydeviceName, ipAddress, subnetMask, gateway

Programmierung

ToolDescriptionParameters
list_blocksList all blocks (FB, FC, DB, OB)deviceName
get_block_detailsRead block interface and codedeviceName, blockName
create_scl_blockCreate SCL block with interfacedeviceName, blockName, sclCode, blockType, interface
delete_blockDelete a blockdeviceName, blockName
rename_blockRename a blockdeviceName, currentName, newName
compile_deviceCompile device codedeviceName

HMI (WinCC)

ToolDescriptionParameters
list_hmi_screensList WinCC screensdeviceName
create_hmi_screenCreate an HMI screendeviceName, screenName
delete_hmi_screenDelete an HMI screendeviceName, screenName
get_hmi_screen_xmlGet screen XML designdeviceName, screenName

Daten & Variablen

ToolDescriptionParameters
list_tag_tablesList tag tablesdeviceName
create_tag_tableCreate a tag tabledeviceName, tableName
delete_tag_tableDelete a tag tabledeviceName, tableName
list_tagsList variables in a tabledeviceName, tableName
create_tagCreate a variable (I, Q, M)deviceName, tableName, name, dataType, logicalAddress
delete_tagDelete a variabledeviceName, tableName, tagName

Systemdiagnose

ToolDescriptionParameters
get_server_diagnosticsAPI & TIA Portal health check

Bonus: FDS-Tools (Design-Spezifikation)

T-IA Connect enthält außerdem 5 zusätzliche MCP-Tools für das FDS-Modul (Functional Design Specification). Weitere Details finden Sie im dedizierten Tutorial.

Anleitung zur SCL-Codegenerierung aus CSV

KI + SPS = Die Zukunft des Engineerings

Mit 31 MCP-Tools wird Ihr KI-Assistent zu einem echten Engineering-Partner — er liest Ihr Projekt, versteht Ihre Hardware und schreibt Code, der tatsächlich kompiliert. Keine halluzinierten Variablen oder blinde Codegenerierung mehr.

Starten Sie mit T-IA Connect und transformieren Sie Ihren TIA Portal Workflow.