Tutoriels

Copilote IA : Outils MCP pour TIA Portal

Laissez les agents IA voir votre projet, connaître vos variables et agir sur votre automate — grâce à 31 outils dédiés.

T
Équipe T-IA Connect
15 min de lecture
Mis à jour le 11 mars 2026

Pourquoi le MCP change tout

Les assistants IA classiques (ChatGPT, Copilot) souffrent d'un problème majeur en automatisme industriel : l'hallucination contextuelle. Ils génèrent du code SCL syntaxiquement correct, mais utilisent des variables inexistantes, des types de données incorrects, ou ignorent la configuration matérielle. Avec le serveur MCP intégré de T-IA Connect, l'IA peut voir votre projet, lire vos tables de variables, inspecter les blocs existants — et réellement créer ou modifier du code dans TIA Portal.

Prérequis

  • T-IA Connect installé et en cours d'exécution
  • Un projet TIA Portal ouvert (V16–V21)
  • Un client IA compatible MCP (Claude Desktop ou tout client MCP)

Configuration : Connecter votre IA à TIA Portal

Ajoutez T-IA Connect comme serveur MCP dans le fichier de configuration de Claude Desktop (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 fait le pont entre stdio et HTTP. Il transmet les requêtes IA au serveur API T-IA Connect qui communique avec TIA Portal via Openness.

Exemple 1 : Vérifier l'état du projet

L'outil le plus simple — vérifier la connexion à TIA Portal et voir quel projet est ouvert.

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
}

Exemple 2 : Ouvrir un projet

Ouvrez un fichier projet TIA Portal directement depuis l'IA. Vous pouvez aussi scanner les projets disponibles sur le disque avec 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"
}

Exemple 3 : Lister les automates

Voir tous les automates (PLC), IHM et autres appareils dans le projet en cours.

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

Exemple 4 : Lister et lire les blocs

Parcourir tous les blocs (FB, FC, DB, OB) d'un automate, puis lire le code complet et l'interface de n'importe quel bloc.

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

Exemple 5 : Créer un bloc SCL

L'outil le plus puissant — créer un Function Block avec du code SCL, des variables typées et une définition d'interface complète. L'IA peut générer ce code à partir d'une description en langage naturel de vos besoins.

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
}

Exemple 6 : Gérer les variables

Lister les tables de tags, parcourir les variables et créer de nouveaux tags avec les bonnes adresses et types de données.

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
}

Exemple 7 : Compiler

Lancer la compilation d'un automate pour valider le code généré. Les erreurs et avertissements sont retournés pour que l'IA puisse corriger automatiquement.

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
}

Exemple 8 : Rechercher dans le catalogue matériel

Chercher dans le catalogue matériel Siemens et ajouter des appareils au projet — le tout en langage naturel.

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
}

Exemple 9 : Écrans IHM

Lister, créer et inspecter les écrans WinCC. Récupérer le XML complet du design pour analyse.

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
}

Exemple 10 : Sauvegarder, archiver et fermer

Gestion complète du cycle de vie du projet — sauvegarder votre travail, créer des archives de backup et fermer proprement.

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 }

Référence complète (31 outils)

Voici la liste exhaustive des outils MCP disponibles dans T-IA Connect, organisés par catégorie.

Gestion de projet

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

Matériel & Réseau

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

Programmation

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

IHM (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

Données & Variables

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

Diagnostic système

ToolDescriptionParameters
get_server_diagnosticsAPI & TIA Portal health check

Bonus : Outils FDS (Design Spec)

T-IA Connect inclut également 5 outils MCP supplémentaires pour le module FDS (Functional Design Specification). Consultez le tutoriel dédié pour plus de détails.

Guide CSV vers code SCL

IA + Automate = L'avenir de l'ingénierie

Avec 31 outils MCP, votre assistant IA devient un véritable partenaire d'ingénierie — il lit votre projet, comprend votre matériel et écrit du code qui compile réellement. Fini les variables hallucinées et la génération de code à l'aveugle.

Démarrez avec T-IA Connect et transformez votre flux de travail TIA Portal.