Enable AI-powered solution configuration through Model Context Protocol integration.

Enable AI-powered solution configuration through Model Context Protocol integration.

Version: 0.7
Last Updated: January 25, 2026
Connector Name: DesignerMCP
Interface: TCP/IP (stdio transport)

Overview

The AI MCP for Designer service enables AI models to interact with the FrameworX Designer application, providing intelligent assistance for solution configuration tasks. Instead of manually creating and configuring objects, you can describe what you need in natural language and let AI generate the configuration.

Note: This connector is for configuration-time operations (building solutions in Designer.exe). For querying live data from running solutions, see AI MCP for Runtime Connector.

Key Capabilities

• Navigate Designer UI — AI can observe and

• navigate the Designer interface
• Create Objects — Generate Tags, Displays, Alarms, Devices, and other solution objects
• Query Objects — Search and inspect existing solution configuration
• Validate Configuration — Pre-check configurations before creating objects
• Generate Displays — Create Canvas and Dashboard displays with proper FrameworX patterns

• Discover Protocols — Search available communication protocols and their configuration schemas

• Track Changes — Query audit trails, cross-references, and version control
• Access Documentation — Search docs and download example solutions

When to Use MCP for Designer

Prerequisites

Prerequisites

• FrameworX 10.1 Designer
• .NET 8.0 runtime
• Claude Desktop or compatible MCP client
• Network connectivity (if Designer runs on remote machine)

Configuration

Disable MCP for Designer

The MCP for Designer is Enabled by default. If you want to disable it:

1. Open FrameworX Designer
2. Navigate to Solutions → Settings
3. Uncheck Allow MCP For Designer

This configuration has the scope of that solution only.

Connecting Claude Desktop

Configure Claude Desktop to connect to the Designer MCP server:

1. Open Claude Desktop
2. Go to Settings → Developer → Edit Config
3. Open the "claude_desktop_config.json" file
4. Add the MCP for Designer configuration:

{
  "mcpServers": {
   
    "FrameworX-Designer": {

        "command": "c:<ProductPath>\\Dev\\Tatsoft2020_1\\FactoryStudio\\bin\\MCP\\DesignerMCP.exe",
MCP\\DesignerMCP.exe",
      "args": ["/port:3101"],
      "transport": "stdio"

     }
   }
}

1. Replace <ProductPath> with your FrameworX installation directory (use double backslashes)
2. Save and close the file
3. Restart Claude Desktop completely (close via Windows Task Manager)

Tip: You can run both MCP for Designer and MCP for Runtime simultaneously by including both configurations in your claude_desktop_config.json file.

Verifying Connection

1. Open Claude Desktop
2. Go to Settings → Developer
3. Verify "FrameworX-Designer" shows status "running"
4. Open a new chat and click Search and Tools — you should see the Designer tools listed

Available Tools

AI MCP for Designer provides

17 tools organized by category:

Solution Management (3 tools)

Object Operations (7 tools)

Object Operations

Designer Control (1 tool)

Protocol Schema

Protocol Groups

Protocols are organized into these groups:

Data Explorer

Supported Data Sources

Information & Navigation

Display JSON Formats

AI MCP for Designer uses simplified JSON formats for creating and modifying displays.

Canvas Display Format

Canvas displays use absolute pixel positioning:

{
  "Type": "DisplaysList",
  "Name": "TankOverview",
  "Width": 1366,
  "Height": 768,
  "DisplayMode": "Page",
  "Children": [
    {
      "Type": "Symbol",
      "SymbolName": "HMI/Tanks/TankWithLevel",
      "Left": 100,
      "Top": 50,
      "Width": 200,
      "Height": 300,
      "SymbolLabels": [
        { "Key": "Level", "Value": "@Tag.Tank1.Level" },
        { "Key": "Title", "Value": "Tank 1" }
      ]
    },
    {
      "Type": "TrendChart",
      "Left": 350,
      "Top": 50,
      "Width": 400,
      "Height": 300,
      "LinkedValue": "@Tag.Tank1.Level"
    }
  ]
}

Dashboard Display Format

Dashboard displays use grid-based positioning with resizable cells:

Available actions:

• navigate — Go to module, table, or object path
• get_state — Get current Designer view and selection (optional screenshot)
• get_runtime_status — Check if runtime is running
• get_startup_config — Get startup module settings
• start_runtime / stop_runtime — Control runtime execution
• set_execution_profile — Switch between Development and Production

Display Tools (1 tool)

Special queries:

• get_element_schema('Canvas') — Canvas display structure with layout info
• get_element_schema('Dashboard') — Dashboard grid and cell structure
• get_element_schema('WizardSymbol') — Industrial symbols: BLOWER, MOTOR, PUMP, TANK, VALVE

Protocol Tools (2 tools)

Search examples:

• list_protocols(search='siemens') → S7, S7Plus
• list_protocols(search='allen') → EtherNet/IP, DF1, ControlLogix
• list_protocols(search='modbus') → Modbus TCP, Modbus RTU
• list_protocols(search='opc') → OPC UA, OPC DA

Documentation Tools (2 tools)

Documentation labels: concept, tutorial, how-to, example, reference, connector, code, control

Track Changes (1 tool)

Available tables:

• RecentChanges — Audit trail of who changed what and when
• VersionControl — Table versions and modification dates
• CrossReference — Where an object is used (requires object_name)
• UseCount — Usage frequency per object

Table Types Reference

Objects are organized by module. Use these TableType names with object tools:

Syntax Reference

Tag Access Methods

Context-Specific Syntax

System Namespaces

Module Namespaces

Every configured object has runtime properties accessible via namespace:

• Alarm.Group.Critical.AckRequired, Alarm.Item.HighTemp.Active
• Device.Channel.Modbus1.Status, Device.Node.PLC1.Error
• Script.Task.Startup.LastRun, Display.MainPage.IsOpen

Use list_objects('Server') or list_objects('Alarm.Group') to explore.

MCP Category System

Objects created by AI automatically receive Category = "MCP" to track AI-created vs manually-created objects.

Update Permissions

How It Works

1. AI creates object → Category automatically set to "MCP"
2. User edits object in Designer → "MCP" removed from Category
3. AI tries to update → Limited to Description field only
4. To re-enable full AI updates → Manually add "MCP" to Category

Display JSON Formats

Canvas Display

Canvas displays use absolute pixel positioning with an Elements array:

{
  "Name": "TankOverview",
  "PanelType": "Canvas",
  "Size": "1366 x 728",
  "Elements": [
    {
      "Type": "TextBox",
      "Left": 100,
      "Top": 50,
      "Width": 120,
      "Height": 28,
      "LinkedValue": "@Tag.Tank1.Level.Value"
    }{
  "Type": "DisplaysList",
  "Name": "MotorDashboard",
  "Width": 1366,
  "Height": 768,
  "DisplayMode": "Page",
  "DashboardDisplay": {
    "Columns": ["*", "*", "*"],
    "Rows": ["*", "*"]
  },
  "Cells": [
    {
      "Row": 0, "Col": 0,
      "Cell": { "HeaderLink": "Motor 1" },
      "Content": {
        "Type": "Symbol",
        "SymbolName": "HMI/Motors/MotorStatus",
        "SymbolLabels": [
          { "Key": "Value", "Value": "@Tag.Motor1.Status" }
        ]
      }
    },
    {
      "RowType": 1, "Col": 0, "ColSpan": 3Symbol",
      "CellWizardType": { "HeaderLink": "Trend" }TANK",
      "ContentLeft": {100,
        "TypeTop": "TrendChart"100,
        "LinkedValueWidth": "@Tag.Motor1.Speed"
      }
    }
  ]
}

Key Format Features

For complete format specifications, see:

• Canvas and Symbol JSON Reference
• Dashboard JSON Reference

Example Queries

Creating Objects

• "Create a new analog tag called Tank1_Level with engineering units in gallons, range 0-1000"
• "Create 10 temperature sensor tags named Sensor_T01 through Sensor_T10"
• "Add a high alarm at 85 and high-high alarm at 95 to all temperature tags"
• "Create a Modbus TCP channel for PLC at 192.168.1.10"

Querying Configuration

• "List all tags in the Boiler area"
• "Show me the alarm configuration for Tank1_Level"
• "What displays reference the tag Pump1_Status?"
• "Show me the schema for creating historian tags"

Creating Canvas Displays

• "Create a canvas display showing Tank1 with a level gauge and numeric readout"
• "Add a status indicator that turns red when Tank1_Level exceeds 900"
• "Create a P&ID style display with three tanks connected by pipes"

Creating Dashboard Displays

• "Create a 2×3 dashboard for monitoring six motors"
• "Make a dashboard with a navigation panel on the left (200px) and content area on the right"
• "Create a dashboard with AlarmViewer spanning the bottom row"

Modifying Displays

• "Export the MotorOverview display so I can see its structure"
• "Add a CircularGauge to the Motor 1 cell showing speed"
• "Change the TrendChart to show the last 48 hours instead of 24"

Protocol Schema Discovery

• "What communication protocols are available?"
• "List all protocols in the AutomationVendors group"
• "Show me the schema for the Modbus protocol"
• "What are the key fields needed for an OPC UA connection?"
• "What interfaces does the S7 protocol support?"

Data Explorer & Device Configuration

• "Connect to the MQTT broker at tcp://192.168.1.100:1883"
• "Open the Data Explorer for OPC UA server at opc.tcp://192.168.1.100:4840"
• "What node is currently selected in the Data Explorer?"
• "Create a TagProvider from the current Data Explorer selection called Plant1_Sensors"
• "Create a Device configuration from the selected MQTT topic"
• "Browse the PLC at 192.168.1.50 and show available tags"

Learning & Discovery

• "What object types are available in FrameworX?"
• "Show me the required fields for creating an alarm item"
• "What symbols are available for motor status?"
• "List the parameters for the HMI/Labels/ShortLabel symbol"

How AI Context Works

When you open or create a solution, the AI automatically receives context about the FrameworX object model, including:

• Available object types and their relationships
• JSON formats for creating objects and displays
• Dependencies between objects (e.g., AlarmItem requires Tag + AlarmGroup)
• Pre-defined objects available in every solution
• Runtime namespace syntax for referencing objects
• Symbol library structure and common symbols

This context enables the AI to generate valid configuration without you needing to explain the FrameworX data model. For detailed information beyond what's in the context, the AI can use the search_docs tool to query the FrameworX documentation.

Display Context

For display operations, the AI also receives:

• Available control types and their properties
• Symbol library categories and naming conventions
• Dashboard grid constraints (≤4×4 for simple format)
• Dynamic behavior options (color change, visibility, etc.)
• Theme property mappings

Protocol Context

For device configuration, the AI can discover:

• Available protocols organized by group (AutomationVendors, FactoryFloor, ITCloud, etc.)
• Protocol-specific schemas for ProtocolOptions, PrimaryStation, and Address fields
• Key fields that must be configured (marked with * suffix)
• Valid value ranges, enumerations, and default values
• Interface options (Serial, TCPIP, Custom)

Data Explorer Context

When using Data Explorer tools, the AI receives:

• Connection status and current data source type
• Selected node path and available children
• Pre-built "recipes" for creating TagProviders or Devices from the selection
• Protocol-specific connection string formats

Best Practices

Review Before Committing

AI-generated configuration should always be reviewed before saving:

• Verify object names and hierarchy placement
• Check property values and units
• Validate alarm configurations
• Test display layouts and bindings
• Preview dashboards at different screen sizes

Use Version Control

• Save solution backups before bulk AI operations
• Use FrameworX solution versioning features
• Consider Git integration for exported JSON files

Effective Prompting

For best results when working with AI MCP for Designer:

Display Creation Tips

Device Configuration Tips

Start Small

• Test with single objects before bulk operations
• Verify AI understands your naming conventions
• Build complexity gradually
• Create simple displays before complex dashboards
• Test device connections before creating TagProviders

Troubleshooting

Designer MCP Server not starting

• Verify .NET 8.0 runtime is installed
• Check that Designer is running
• Confirm MCP is enabled in Designer settings
• Check firewall settings for the configured port

Claude doesn't see Designer tools

• Ensure claude_desktop_config.json path is correct (use double backslashes)
• Restart Claude completely (close via Task Manager)
• Verify Designer MCP shows "running" in Claude settings

AI creates objects in wrong location

• Specify full path in your request (e.g., "in the Boiler/Tanks folder")
• Ask AI to show the solution structure first
• Provide explicit parent object references

Display not rendering correctly

• Check that all referenced tags exist
• Verify symbol paths are correct (use search_symbols to find)
• For dashboards, ensure grid dimensions ≤4×4 for simple format
• Check for missing SymbolLabels on symbols

Dashboard cells not positioned correctly

• Verify Row/Col values are 0-based
• Check ColSpan/RowSpan don't exceed grid bounds
• Export existing dashboard to see expected format

Changes not appearing in Designer

• Refresh the Designer view (F5)
• Check if object was created in a different location
• Verify the operation completed successfully in Claude's response
• For displays, close and reopen the display editor

Protocol not found

• Use list_protocols to see available protocols
• Check spelling (protocol names are case-sensitive)
• Some protocols may not be installed — check FrameworX license

Data Explorer connection failed

• Verify the connection URL format matches the source type
• Check network connectivity to the data source
• Verify credentials if authentication is required
• For OPC UA, ensure the server is running and accessible
• For MQTT, check broker is accepting connections on the specified port

Data Explorer shows no selection

• Browse the tree in Data Explorer and select a node
• Call get_data_explorer_state after selecting to get updated recipes
• Some nodes may not support TagProvider or Device creation

Related Documentation

JSON Format References

• Canvas and Symbol JSON Reference — Complete Canvas/Symbol format specification
• Dashboard JSON Reference — Dashboard format specification
• XAML-JSON Translation Specification — How JSON maps to XAML

Protocol Schema Reference

• Protocol Schema Specification — JSON schema format for protocol fields
• Devices Module Reference — Channel, Node, Point configuration
• UNS Module Reference — TagProvider configuration

AI MCP for Runtime

For querying live data from running solutions:

• AI MCP for Runtime Connector — Query tags, alarms, and historian
• AI MCP for Runtime Tutorial — Step-by-step guide

Quick Start Tutorials

• AI MCP for Designer Tutorial — Create your first objects with AI
• Creating Displays with AI — Display generation walkthrough
• Connecting Data Sources with AI — Using Data Explorer tools

Example Implementation

• SolarPanels MCP Demo — Full solution with MCP integration

Technology Information

• AI-Ready by Design — Platform architecture for AI integration

Reference Information

• Display XAML Reference — XAML patterns for displays
• TControl XAML Inventory — Complete control reference
• Scripts Module Reference — For creating custom MCP tools

Change Log

65,
      "Height": 65
    }
  ]
}

Dashboard Display

Dashboard displays use grid-based positioning with Cells array:

{
  "Name": "MotorDashboard",
  "PanelType": "Dashboard",
  "Size": "1366 x 728",
  "DashboardDisplay": {
    "Columns": ["*", "*"],
    "Rows": ["*", "*"]
  },
  "Cells": [
    {
      "Row": 0,
      "Col": 0,
      "Cell": { "HeaderLink": "Motor 1" },
      "Content": {
        "Type": "TextBox",
        "LinkedValue": "@Tag.Motor1.Speed.Value"
      }
    }
  ]
}

Wizard Symbols

Pre-built industrial symbols with default appearance:

• Types: BLOWER, MOTOR, PUMP, TANK, VALVE
• Usage: { "Type": "Symbol", "WizardType": "VALVE", "Left": 100, "Top": 200 }
• User customizes appearance in Designer after creation

Common Workflows

Creating Tags

"Create a Double tag called TankLevel in the Tanks folder with range 0-100"

Setting Up Device Communication

"I need to connect to a Siemens S7-1500 PLC at IP 192.168.1.10"

AI will: Search protocols → Present options → Create Channel → Create Node → Help map Points

Creating Displays

"Create a dashboard with 4 cells showing TankLevel, TankTemp, PumpStatus, and AlarmCount"

Configuring Alarms

"Create high and low alarms for TankLevel: High at 90 (Critical), Low at 10 (Warning)"

Finding Where Objects Are Used

"Where is tag Tank1Level used in the solution?"

AI will use: get_track_changes('CrossReference', object_name='Tag.Tank1Level')

Best Practices

Be Specific

Instead of "Create some tags", say:

"Create these tags in the Production folder: MixerSpeed (Double, 0-1000 RPM), MixerRunning (Digital), BatchCount (Integer)"

Validate Before Bulk Operations

"Validate this configuration before creating 50 tags"

Review Changes

"Show me the recent changes" or "Navigate to the Tags tab"

Use Documentation

"Search the documentation for alarm configuration options"

Troubleshooting

Designer MCP Server not starting

• Verify .NET 8.0 runtime is installed
• Check that Designer is running
• Confirm MCP is enabled in Designer settings
• Check firewall settings for the configured port

Claude doesn't see Designer tools

• Ensure claude_desktop_config.json path is correct (use double backslashes)
• Restart Claude completely (close via Task Manager)
• Verify Designer MCP shows "running" in Claude settings

"Update blocked" message

• The object doesn't have MCP in its Category
• User edited the object in Designer, removing MCP
• AI can only update the Description field
• To enable full updates: add "MCP" to Category in Designer

Changes not appearing in Designer

• Refresh the Designer view (F5)
• For displays, close and reopen the display editor
• Verify the operation completed successfully in Claude's response

Related Documentation

• AI MCP for Runtime Connector — Query live tags, alarms, and historian
• AI-Ready by Design — Technical architecture for AI integration
• Devices Module Reference — Channel, Node, Point configuration
• Displays Module Reference — Canvas and Dashboard formats

In this section...