Claude Desktop Integration

Goal: Connect Claude Desktop to your governed industrial data.

---

Prerequisites

• Claude Desktop installed (macOS or Windows)
• OpenIndustrial workspace with at least one warm query
• API key with read:queries and execute:queries scopes

---

Step 1: Get Your MCP Configuration

In OpenIndustrial:

1. Go to API → MCP
2. Click Generate Config
3. Copy the configuration JSON

Or ask Azi: "Generate MCP config for Claude Desktop"

---

Step 2: Configure Claude Desktop

macOS

1. Open ~/Library/Application Support/Claude/claude_desktop_config.json
2. Add your MCP server to the mcpServers section:

{
  "mcpServers": {
    "open-industrial": {
      "command": "npx",
      "args": [
        "-y",
        "@openindustrial/mcp-server",
        "--workspace", "YOUR_WORKSPACE_ID",
        "--token", "YOUR_API_TOKEN"
      ]
    }
  }
}

Windows

1. Open %APPDATA%\Claude\claude_desktop_config.json
2. Add the same configuration as above

---

Step 3: Restart Claude Desktop

1. Quit Claude Desktop completely
2. Reopen it
3. Look for the hammer icon (tools) in the chat interface
4. Your warm queries should appear as available tools

---

Step 4: Start Querying

Ask Claude questions about your data:

"What was the average temperature in the brewery last hour?"

Claude will:

1. See your temperature-avg query as a tool
2. Call it with appropriate parameters
3. Return results in natural language

---

Example Interactions

Simple Query

You: "What's the current status of all devices?"

Claude: Calls query_device_status tool

"Based on the data, you have 12 devices online: 8 temperature sensors, 3 pressure monitors, and 1 flow meter. All are reporting normally except sensor T-07 which shows elevated readings."

Analysis Query

You: "Compare this week's production to last week."

Claude: Calls query_production_metrics with date ranges

"Production is up 8% this week (2,340 units vs 2,165 last week). The increase is primarily from Line 2, which had 15% less downtime."

---

Troubleshooting

Issue	Solution
Tools not appearing	Restart Claude Desktop, check config syntax
Connection errors	Verify API token hasn't expired
Permission denied	Check token has required scopes
Slow responses	Normal for first query; subsequent queries faster

---

Security Considerations

• Use a dedicated token for Claude Desktop
• Set appropriate expiry (90 days recommended)
• Limit scopes to only what's needed
• Monitor usage in audit logs

---

Audit Trail

Every query Claude makes is logged:

{
  "client": "claude-desktop",
  "user": "mike@company.com",
  "query": "temperature-avg",
  "parameters": {"timeRange": "1h"},
  "timestamp": "2026-01-18T10:30:00Z"
}

---

Next Steps

If you want to...	Go to...
Connect VS Code Copilot	VS Code Copilot →
Build custom client	Custom Clients →
Manage API keys	Secrets →