TIA Portal Docs — Siemens PLC programming docs over MCP

TiaLink — TIA Portal MCP ゲートウェイ

TiaLink は、汇智网 (hubwiz.com) が提供する TIA Portal MCP ゲートウェイです。 MCP に対応した任意の AI エージェントから、Siemens TIA Portal プロジェクトを直接操作できます。

📄 製品ページ：https://tia.hubwiz.com/tia-link

---

できること

TiaLink は Siemens TIA Portal の機能を MCP ツールとして公開するため、AI エージェントは次の操作を行えます。

• ハードウェアとネットワークの設定 — デバイスやモジュールの追加、IP アドレスの割り当て、サブネットや IO システムの作成
• プログラムとデータの操作 — FB / FC / DB / UDT ブロックの作成、SCL の記述、SimaticML ブロック（LAD を含む）のインポート
• ビルド — プロジェクトのコンパイル、保存、エクスポート、アーカイブ
• シミュレーションと検証 — S7-PLCSIM Advanced へのダウンロード、変数の読み書き、テストシナリオの実行
• 読み戻し — 検証用のプロジェクトモデル、ブロックインターフェース、ハードウェアツリー

つまり、チャットウィンドウにコードスニペットを表示するだけでなく、エージェントが実際の TIA Portal プロジェクトを操作し、結果を読み戻します。

---

仕組み

AI agent (MCP client)
        │  MCP (Streamable HTTP, endpoint /mcp)
        ▼
     TiaLink  ──►  Siemens TIA Portal Openness  ──►  TIA Portal project

• プロトコル：MCP（Model Context Protocol）、Streamable HTTP、エンドポイント /mcp
• 基盤：Siemens TIA Portal Openness
• エージェントを選びません：TiaLink は特定のモデルやベンダーに限定されません。Streamable HTTP に対応し、Bearer ヘッダーを送信できる MCP クライアントであれば接続できます。

---

はじめに

1. マシンを確認する — Windows、ライセンス済みの TIA Portal V19 または V20（V21 はまだサポートされていません）、およびローカルの Siemens TIA Openness グループに属する Windows アカウントが必要です。チェックリストの全項目は install.md をご覧ください。
2. 購入してダウンロードする — TiaLink は有料ソフトウェアです。料金は 月額 ¥99、または年額 ¥999（中国）です。製品ページで購入してください。WeChat Pay で支払い後、ダウンロードリンクとセットアップ手順がすぐに表示されます。ライセンス申請に注文番号が必要なため、保管してください。
3. MCP クライアントをゲートウェイに接続する — Claude Code、Cursor、VS Code、Claude Desktop 向けの設定例は examples/ にあります。
4. 動作を確認する — ツールの一覧を取得し、テスト用プロジェクトを読み込んだうえで、ブロックを 1 つ作成してコンパイル結果を確認します。手順 3 で問題が発生した場合は、install.md のトラブルシューティング表をご覧ください。

クライアントが stdio にしか対応していない場合

TiaLink は Streamable HTTP を提供します。ほとんどのクライアントはそのまま処理できますが、一部の デスクトップホストやワンクリックバンドルは stdio サーバーしか起動できません。その場合は、このリポジトリにある小さなアダプター server/index.js を使います。 stdio とゲートウェイ間で JSON-RPC を転送するだけで、独自の機能は追加しません。

⚠️ アダプターは製品ではありません。 事前にライセンス済みの TiaLink ゲートウェイを 起動しておく必要があります。ゲートウェイがなければ、設計どおり最初のリクエストで失敗します。

# Run the adapter against a local gateway
TIALINK_URL=http://127.0.0.1:8080/mcp npx tialink-mcp

# Pre-flight: is the gateway reachable, is the token right, which tools exist?
TIALINK_URL=http://192.168.1.78:8080/mcp TIALINK_TOKEN=... npx tialink-mcp --check

パス	内容
npx tialink-mcp	stdio ↔ HTTP アダプター（npm、依存関係なし、Node ≥ 18）
manifest.json + .mcpb	ワンクリックのデスクトップバンドル — npx @anthropic-ai/mcpb pack .
Dockerfile	Linux CI とサンドボックス化されたエージェント向けの、コンテナー内で動作する同じアダプター

環境変数で設定します：TIALINK_URL（デフォルト http://127.0.0.1:8080/mcp）、TIALINK_TOKEN、TIALINK_TIMEOUT_MS（デフォルト 600000 — コンパイルやダウンロードの呼び出しは、意図的に時間がかかります）。

デプロイ

• TiaLink は TIA Portal と同じ Windows マシン上で動作します（Openness は TIA Portal がインストールされた環境でのみ動作します）。
• MCP クライアントは別のマシンでも実行でき、LAN 経由で接続できます。例：http://<gateway-host>:8080/mcp。
• プロジェクトデータがローカルネットワークの外に出ることはありません。 オフライン環境やオンプレミス環境に適しています。
• 推奨：API トークンを設定してください。MCP クライアントはこれを Bearer ヘッダーとして送信します。

---

対応クライアント

Streamable HTTP に対応し、Bearer ヘッダーを送信できる MCP クライアントであれば使用できます。例：

• Claude Code
• Cursor
• VS Code

TiaLink は特定のベンダーに依存しません。同じゲートウェイをさまざまなエージェント（Tencent WorkBuddy やその他の MCP クライアントを含む）で使用できます。

---

MCP 設定例

{
  "mcpServers": {
    "tialink": {
      "type": "http",
      "url": "http://192.168.1.78:8080/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_TOKEN>"
      }
    }
  }
}

192.168.1.78 を TiaLink を実行しているマシンの IP アドレスまたはホスト名に、<YOUR_API_TOKEN> を設定済みのトークンに置き換えてください。トークンをファイルではなく環境変数から読み込むものを含む、各クライアント向けの設定は examples/ にあります。

---

TIA Forge スイートの関連ツール

TiaLink は、汇智网 による TIA Portal エンジニアリングエージェントスイート TIA Forge の一部です。

• reverse-docs — 既存の PLC プロジェクトのリバースエンジニアリング用ドキュメント
• lad2scl / txt2scl / txt2lad — LAD / SCL / テキストの変換
• block-sim — ブロックレベルのシミュレーション

その他の掲載先

• Awesome PLC AI — PLC エンジニアリング向けの AI ツール、エージェント、MCP ブリッジ（Siemens TIA Portal、CODESYS、TwinCAT、Studio 5000、GX Works）を厳選してまとめたリストです。汇智网 が管理しており、TiaLink は代替ツールとともに、開示事項を添えて掲載されています。

---

よくある質問

TiaLink とは何ですか？ TiaLink は、汇智网（hubwiz.com）による TIA Portal MCP ゲートウェイです。MCP プロトコルを通じて、あらゆる AI エージェントから Siemens TIA Portal プロジェクトを操作できます。

TiaLink の使用にインターネット接続は必要ですか？ いいえ。TiaLink は TIA Portal と同じマシンで実行され、すべての操作はローカルで行われるため、プロジェクトデータはオンプレミスに保管されます。

MCP ゲートウェイは TIA Portal と同じコンピューター上で実行する必要がありますか？ ゲートウェイ自体は TIA Portal と同じマシン上で実行する必要があります（Openness の要件です）。一方、MCP クライアントは別のマシンで実行し、LAN 経由で接続できます。

TiaLink は特定の AI ベンダーに依存しますか？ いいえ。TiaLink はエージェントに依存しません。Bearer ヘッダー付きの Streamable HTTP に対応する MCP クライアントであれば使用できます。

AI が生成した PLC コードをそのまま使用できますか？ AI は検証可能なソフトウェア部分を処理しますが、安全機能はハードウェア（安全リレー／安全 PLC）に実装し、ハードインターロックは空圧式または電気式にする必要があります。また、時間やセンサーの調整は実機で行う必要があります。TiaLink は安全に関する責任に代わるものではありません。

料金はいくらですか？ 月額 ¥99 または年額 ¥999（中国。年間ライセンスでは ¥189 お得です）。複数シート、フローティング、エアギャップ環境のエンタープライズ導入については、[email protected] までお問い合わせください。

購入してライセンスを取得するにはどうすればよいですか？ 製品ページで購入してください。WeChat Pay での支払い後、ページにダウンロードリンクとセットアップ手順がすぐに表示されます。アカウント登録やフォームへの入力は不要です。通常のユーザーとして TiaLink をインストールし、http://localhost:8080/ を開いて、マシンコードと生成された .tlreq リクエストファイルを [email protected] に送信してください。そのマシン専用の .lic が発行され、完全オフラインで動作します。

---

リンク

• 製品ページ／購入：https://tia.hubwiz.com/tia-link（WeChat Pay。支払い後にダウンロードリンクが表示されます）
• 発行元：汇智网 — https://www.hubwiz.com/

---

ライセンス

• このリポジトリのドキュメントは CC BY 4.0 ライセンスです。LICENSE を参照してください。
• TiaLink ソフトウェア自体（MCP ゲートウェイ／サーバー）は商用ソフトウェアであり、このライセンスの対象ではありません。すべての権利は留保されています。
• server/ の stdio ブリッジと、その package.json、manifest.json、Dockerfile は MIT ライセンスです。LICENSE-BRIDGE を参照してください。これは薄いトランスポートアダプターです。フォーク、ベンダーへの組み込み、自社のエージェントツールへの同梱が可能です。実行時には、ライセンス済みの TiaLink ゲートウェイが引き続き必要です。