Handledningar

AI-kopilot: MCP-verktyg för TIA Portal

Låt AI-agenter se ditt projekt, känna till dina variabler och agera på din PLC — genom 31 specialbyggda verktyg.

T
T-IA Connect-teamet
15 min läsning
Uppdaterad 11 mar. 2026

Varför MCP förändrar allt

Klassiska AI-assistenter (ChatGPT, Copilot) lider av ett stort problem inom industriell automation: kontextuell hallucination. De genererar syntaktiskt korrekt SCL-kod, men använder variabler som inte finns, fel datatyper eller ignorerar din hårdvarukonfiguration. Med T-IA Connects inbyggda MCP-server kan AI:n se ditt projekt, läsa dina taggtabeller, inspektera befintliga block — och faktiskt skapa eller ändra kod i TIA Portal.

Förutsättningar

  • T-IA Connect installerat och igång
  • Ett öppet TIA Portal-projekt (V16–V21)
  • En MCP-kompatibel AI-klient (Claude Desktop eller valfri MCP-klient)

Installation: Anslut din AI till TIA Portal

Lägg till T-IA Connect som MCP-server i din Claude Desktop-konfigurationsfil (claude_desktop_config.json):

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"
      }
    }
  }
}

McpBridge.exe fungerar som en stdio-till-HTTP-brygga. Den vidarebefordrar AI-förfrågningar till T-IA Connects API-server som kommunicerar med TIA Portal via Openness.

Exempel 1: Kontrollera projektstatus

Det enklaste verktyget — verifiera anslutningen till TIA Portal och se vilket projekt som är öppet.

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
}

Exempel 2: Öppna ett projekt

Öppna en TIA Portal-projektfil direkt från AI:n. Du kan också söka efter tillgängliga projekt på disken med list_project_files.

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"
}

Exempel 3: Lista enheter

Se alla PLC:er, HMI:er och andra enheter i det aktuella projektet.

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"
  }
]

Exempel 4: Lista och läs block

Bläddra bland alla block (FB, FC, DB, OB) i en PLC och läs sedan hela koden och gränssnittet för valfritt block.

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;"
}

Exempel 5: Skapa ett SCL-block

Det mest kraftfulla verktyget — skapa ett funktionsblock med SCL-kod, typade variabler och en komplett gränssnittsdefinition. AI:n kan generera denna kod från en naturlig språkbeskrivning av dina krav.

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
}

Exempel 6: Hantera taggar

Lista taggtabeller, bläddra bland variabler och skapa nya taggar med korrekta adresser och datatyper.

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
}

Exempel 7: Kompilera

Utlös kompilering av en enhet för att validera den genererade koden. Fel och varningar returneras så att AI:n kan åtgärda problem automatiskt.

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
}

Exempel 8: Sök i hårdvarukatalogen

Sök i Siemens hårdvarukatalog och lägg till enheter i ditt projekt — allt genom naturligt språk.

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
}

Exempel 9: HMI-skärmar

Lista, skapa och inspektera WinCC HMI-skärmar. Hämta hela XML-designen för analys.

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
}

Exempel 10: Spara, arkivera och stäng

Komplett livscykelhantering av projekt — spara ditt arbete, skapa säkerhetskopior och stäng korrekt.

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 }

Komplett verktygsreferens (31 verktyg)

Här är den fullständiga listan över MCP-verktyg som finns tillgängliga i T-IA Connect, organiserade efter kategori.

Projekthantering

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

Hårdvara och nätverk

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

Programmering

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

Data och variabler

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

Systemdiagnostik

ToolDescriptionParameters
get_server_diagnosticsAPI & TIA Portal health check

Bonus: FDS-verktyg (Designspecifikation)

T-IA Connect innehåller också 5 ytterligare MCP-verktyg för FDS-modulen (Funktionell designspecifikation). Se den dedikerade handledningen för detaljer.

Guide för SCL-kodgenerering från CSV

AI + PLC = Framtidens ingenjörskonst

Med 31 MCP-verktyg blir din AI-assistent en riktig ingenjörspartner — den läser ditt projekt, förstår din hårdvara och skriver kod som faktiskt kompilerar. Inga mer hallucinerade variabler eller blind kodgenerering.

Kom igång med T-IA Connect och transformera ditt arbetsflöde i TIA Portal.