Por que o MCP Muda Tudo
Os assistentes de IA clássicos (ChatGPT, Copilot) sofrem de um grande problema na automação industrial: alucinação contextual. Eles geram código SCL sintaticamente correto, mas usam variáveis que não existem, tipos de dados errados ou ignoram a configuração do seu hardware. Com o servidor MCP integrado do T-IA Connect, a IA pode ver seu projeto, ler suas tabelas de tags, inspecionar blocos existentes — e realmente criar ou modificar código no TIA Portal.
Pré-requisitos
- T-IA Connect instalado e em execução
- Um projeto TIA Portal aberto (V16–V21)
- Um cliente de IA compatível com MCP (Claude Desktop ou qualquer cliente MCP)
Configuração: Conecte sua IA ao TIA Portal
Adicione o T-IA Connect como servidor MCP no seu arquivo de configuração do Claude Desktop (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"
}
}
}
}O McpBridge.exe atua como uma ponte stdio-para-HTTP. Ele encaminha as solicitações de IA para o servidor de API do T-IA Connect que se comunica com o TIA Portal via Openness.
Exemplo 1: Verificar o Status do Projeto
A ferramenta mais simples — verifique a conexão com o TIA Portal e veja qual projeto está aberto.
{
"name": "get_project_status",
"arguments": {}
}{
"connected": true,
"projectName": "WaterTreatment_V19",
"projectPath": "C:\TIA_Projects\WaterTreatment_V19",
"tiaVersion": "V19",
"modified": false
}Exemplo 2: Abrir um Projeto
Abra um arquivo de projeto TIA Portal diretamente da IA. Você também pode procurar projetos disponíveis no disco com list_project_files.
{
"name": "open_project",
"arguments": {
"path": "C:\TIA_Projects\WaterTreatment_V19\WaterTreatment_V19.ap19"
}
}{
"success": true,
"projectName": "WaterTreatment_V19",
"version": "V19"
}Exemplo 3: Listar Dispositivos
Veja todos os PLCs, HMIs e outros dispositivos no projeto atual.
{
"name": "list_devices",
"arguments": {}
}[
{
"name": "PLC_1",
"type": "CPU 1516-3 PN/DP",
"category": "PLC"
},
{
"name": "HMI_1",
"type": "TP1500 Comfort",
"category": "HMI"
}
]Exemplo 4: Listar e Ler Blocos
Navegue por todos os blocos (FB, FC, DB, OB) em um PLC, depois leia o código completo e a interface de qualquer bloco.
// 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"
}
}// 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;"
}Exemplo 5: Criar um Bloco SCL
A ferramenta mais poderosa — crie um Function Block com código SCL, variáveis tipadas e uma definição completa de interface. A IA pode gerar este código a partir de uma descrição em linguagem natural dos seus requisitos.
{
"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;"
}
}{
"name": "FB_ValveControl",
"type": "FB",
"number": 2,
"created": true
}Exemplo 6: Gerenciar Tags
Liste tabelas de tags, navegue pelas variáveis e crie novas tags com endereços e tipos de dados adequados.
// 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"
}
}// 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
}Exemplo 7: Compilar
Acione a compilação de um dispositivo para validar o código gerado. Erros e avisos são retornados para que a IA possa corrigir problemas automaticamente.
{
"name": "compile_device",
"arguments": { "deviceName": "PLC_1" }
}{
"success": true,
"errors": [],
"warnings": [
"FB_ValveControl: Variable 'Timeout' declared but not used"
],
"warningCount": 1,
"errorCount": 0
}Exemplo 8: Pesquisar no Catálogo de Hardware
Pesquise no catálogo de hardware da Siemens e adicione dispositivos ao seu projeto — tudo através de linguagem natural.
// 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"
}
}// 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
}Exemplo 9: Telas HMI
Liste, crie e inspecione telas HMI WinCC. Recupere o design XML completo para análise.
// List screens
{ "name": "list_hmi_screens", "arguments": {
"deviceName": "HMI_1"
}
}
// Create a new screen
{ "name": "create_hmi_screen", "arguments": {
"deviceName": "HMI_1",
"screenName": "MotorOverview"
}
}// list_hmi_screens response
[
{ "name": "MainScreen", "type": "Screen" },
{ "name": "AlarmView", "type": "Screen" }
]
// create_hmi_screen response
{
"name": "MotorOverview",
"created": true
}Exemplo 10: Salvar, Arquivar e Fechar
Gerenciamento completo do ciclo de vida do projeto — salve seu trabalho, crie arquivos de backup e feche corretamente.
{ "name": "save_project", "arguments": {} }
{ "name": "archive_project", "arguments": {
"targetDirectory": "C:\TIA_Backups",
"archiveName": "WaterTreatment_backup_2026-03-11"
}
}
{ "name": "close_project", "arguments": {} }{ "saved": true }
{
"archivePath": "C:\TIA_Backups\WaterTreatment_backup_2026-03-11.zap19",
"size": "45.2 MB",
"created": true
}
{ "closed": true }Referência Completa de Ferramentas (31 Ferramentas)
Aqui está a lista completa de ferramentas MCP disponíveis no T-IA Connect, organizadas por categoria.
Gerenciamento de Projetos
| Tool | Description | Parameters |
|---|---|---|
| get_project_status | Get current project status | — |
| list_project_files | Scan disk for TIA projects | path? |
| open_project | Open a .ap* project file | path |
| create_project | Create an empty TIA project | path, name |
| close_project | Close the active project | — |
| save_project | Save the current project | — |
| archive_project | Create a .zap backup | targetDirectory, archiveName |
| retrieve_project | Restore from .zap backup | archivePath, targetDirectory |
Hardware e Rede
| Tool | Description | Parameters |
|---|---|---|
| list_devices | List all devices (PLC, HMI) | — |
| search_hardware_catalog | Search Siemens hardware catalog | query |
| add_device | Add a device to the project | deviceName, typeIdentifier |
| delete_device | Remove a device | deviceName |
| rename_device | Rename a device | currentName, newName |
| configure_network | Set IP / subnet / gateway | deviceName, ipAddress, subnetMask, gateway |
Programação
| Tool | Description | Parameters |
|---|---|---|
| list_blocks | List all blocks (FB, FC, DB, OB) | deviceName |
| get_block_details | Read block interface and code | deviceName, blockName |
| create_scl_block | Create SCL block with interface | deviceName, blockName, sclCode, blockType, interface |
| delete_block | Delete a block | deviceName, blockName |
| rename_block | Rename a block | deviceName, currentName, newName |
| compile_device | Compile device code | deviceName |
HMI (WinCC)
| Tool | Description | Parameters |
|---|---|---|
| list_hmi_screens | List WinCC screens | deviceName |
| create_hmi_screen | Create an HMI screen | deviceName, screenName |
| delete_hmi_screen | Delete an HMI screen | deviceName, screenName |
| get_hmi_screen_xml | Get screen XML design | deviceName, screenName |
Dados e Variáveis
| Tool | Description | Parameters |
|---|---|---|
| list_tag_tables | List tag tables | deviceName |
| create_tag_table | Create a tag table | deviceName, tableName |
| delete_tag_table | Delete a tag table | deviceName, tableName |
| list_tags | List variables in a table | deviceName, tableName |
| create_tag | Create a variable (I, Q, M) | deviceName, tableName, name, dataType, logicalAddress |
| delete_tag | Delete a variable | deviceName, tableName, tagName |
Diagnósticos do Sistema
| Tool | Description | Parameters |
|---|---|---|
| get_server_diagnostics | API & TIA Portal health check | — |
Bônus: Ferramentas FDS (Especificação de Design)
O T-IA Connect também inclui 5 ferramentas MCP adicionais para o módulo FDS (Especificação Funcional de Design). Veja o tutorial dedicado para detalhes.
Guia de Geração de Código SCL a partir de CSVIA + PLC = O Futuro da Engenharia
Com 31 ferramentas MCP, seu assistente de IA se torna um verdadeiro parceiro de engenharia — ele lê seu projeto, entende seu hardware e escreve código que realmente compila. Chega de variáveis alucinadas ou geração de código às cegas.
Comece com o T-IA Connect e transforme seu fluxo de trabalho no TIA Portal.