Navis Navis PLC Xinje Studio XD · XL · XDM · Native .XDP · Streamable HTTP MCP

NAVIS PLC XINJE · STREAMABLE HTTP MCP (FAST MODE: AUTO_SIMULATE=FALSE)

Hướng dẫn kết nối AI với Navis PLC Xinje

Lưu ý: Bạn chưa đăng nhập. Hãy Đăng nhập tài khoản Navis để hệ thống hiển thị sẵn mã kết nối MCP cá nhân gắn cố định với tài khoản của bạn (hoặc dùng endpoint công khai https://navisxinje.iotdaiviet.com/api/mcp/public cho tác vụ dịch/biên dịch ngoại tuyến).

Sao chép bộ thông tin dưới đây khi thêm MCP Server vào Gemini, ChatGPT, Claude, Antigravity, Codex để AI phân biệt chính xác PLC Xinje (.XDP) với PLC Delta (.DVP) và viết đúng tập lệnh:

Name (Tên hiển thị)

Navis PLC Xinje

Server URL (URL kết nối cá nhân)

https://navisxinje.iotdaiviet.com/mcp?code=<DANG_NHAP_DE_LAY_MA_CA_NHAN>

URL chứa mã kết nối cá nhân cố định theo tài khoản của bạn (giữ nguyên khi đăng nhập trên nhiều máy; chỉ đổi mới khi đổi mật khẩu). Riêng Gemini Web / Enterprise dùng URL đường dẫn sạch không dấu ? ở mục 1 bên dưới.

Description (optional) — Mô tả giúp các AI hiểu rõ tập lệnh & công cụ PLC Xinje

Lập trình, dịch/xuất file .XDP gốc (XDPPro 3.7), vẽ Ladder & điều khiển trực tiếp PLC Xinje XD/XL/XDM (XD3-16/24/32/48/60, XD5, XL3) qua cổng COM trình duyệt. Ngõ X/Y bát phân (0-7), cờ luôn ON: SM0 (không dùng M1000), xung đầu: SM2, lưu mất điện: HD/HM/FD, Timer 3 toán hạng (TMR T0 K50 K100). Gọi plc_push_to_ide_and_plc (auto_simulate=False) để đẩy tức thì, plc_upload_from_plc để đọc từ PLC thật; chỉ mô phỏng khi người dùng yêu cầu.

Mẹo: Dán đoạn này vào ô Description (optional) khi thêm MCP trên Gemini / ChatGPT / Claude sẽ giúp AI chọn đúng server khi dùng song song cả Navis PLC Xinje và Navis PLC Delta, viết chuẩn SM0 + TMR 3 toán hạng và đẩy code tức thì (<20ms).

1. Gemini trên web (gemini.google.com) & Gemini Enterprise

Mở gemini.google.com/apps (⚙ → Kỹ năng / Connected Apps → Add a custom app) hoặc Gemini Enterprise → Connected apps → Add MCP Server, đặt tên Navis PLC Xinje và dán URL đường dẫn sạch (không có dấu ?):

https://navisxinje.iotdaiviet.com/mcp/<DANG_NHAP_DE_LAY_MA_CA_NHAN>

Nếu biểu mẫu yêu cầu tách riêng Base URL và Header xác thực:

MCP Server URL: https://navisxinje.iotdaiviet.com/mcp
Header: Authorization: Bearer <DANG_NHAP_DE_LAY_MA_CA_NHAN>
(hoặc Header: X-API-Key: <DANG_NHAP_DE_LAY_MA_CA_NHAN>)

2. Google Antigravity

Trong bảng Agent của Antigravity, mở … → MCP Servers → Manage MCP Servers → View raw config và thêm mục navis-xinje vào mcpServers:

{
  "mcpServers": {
    "navis-xinje": {
      "serverUrl": "https://navisxinje.iotdaiviet.com/mcp?code=<DANG_NHAP_DE_LAY_MA_CA_NHAN>"
    }
  }
}

3. Google Gemini CLI & Gemini Code Assist (VS Code / JetBrains)

Gemini CLI (@google/gemini-cli):

gemini mcp add --transport http navis-xinje "https://navisxinje.iotdaiviet.com/mcp?code=<DANG_NHAP_DE_LAY_MA_CA_NHAN>"
gemini mcp list

Tệp cấu hình ~/.gemini/settings.json (dùng khóa httpUrl):

{
  "mcpServers": {
    "navis-xinje": {
      "httpUrl": "https://navisxinje.iotdaiviet.com/mcp?code=<DANG_NHAP_DE_LAY_MA_CA_NHAN>",
      "timeout": 30000
    }
  }
}

4. ChatGPT, Claude & OpenAI Codex CLI

ChatGPT Web / Desktop & Claude Connectors: Chọn Add custom MCP server / Custom connector, đặt tên Navis PLC Xinje, chọn No authentication và dán URL:

https://navisxinje.iotdaiviet.com/mcp?code=<DANG_NHAP_DE_LAY_MA_CA_NHAN>

Codex CLI:

codex mcp add navis-xinje --url "https://navisxinje.iotdaiviet.com/mcp?code=<DANG_NHAP_DE_LAY_MA_CA_NHAN>"
codex mcp list

5. Google GenAI Python SDK (google-genai + mcp)

import asyncio
from google import genai
from google.genai import types
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

MCP_URL = "https://navisxinje.iotdaiviet.com/mcp?code=<DANG_NHAP_DE_LAY_MA_CA_NHAN>"

async def main():
    client = genai.Client()
    async with streamablehttp_client(MCP_URL) as (r, w, _):
        async with ClientSession(r, w) as session:
            await session.initialize()
            resp = await client.aio.models.generate_content(
                model="gemini-2.5-flash",
                contents="Đọc workspace Xinje qua plc_get_workspace, viết mạch tự giữ X0 bật Y0, X1 tắt Y0 cho XD3-16 và đẩy lên IDE bằng plc_push_to_ide_and_plc.",
                config=types.GenerateContentConfig(tools=[session]),
            )
            print(resp.text)

asyncio.run(main())

6. Câu lệnh thử nghiệm nhanh cho PLC Xinje

Kiểm tra cú pháp & đẩy chương trình .XDP tức thì (không tự mô phỏng)

Dùng MCP Navis Xinje gọi plc_push_to_ide_and_plc cho CPU XD3-16 với mạch LED đuổi Y0 -> Y3 chu kỳ 0.5s dùng SM0 và TMR 3 toán hạng (K5 K100). Giữ auto_simulate=False để đẩy tức thì lên màn hình Web IDE.

Đọc ngược trạng thái & cấu hình từ PLC Xinje thật đang cắm cổng COM

Dùng MCP Navis Xinje gọi plc_upload_from_plc để đọc cấu hình CPU (Firmware, SD20..SD31), trạng thái X0..X7, Y0..Y7, thanh ghi D và chương trình từ PLC Xinje đang kết nối cổng COM trên trình duyệt.

Force trực tiếp ngõ ra Y trên PLC thật qua MCP

Dùng MCP Navis Xinje gọi plc_hardware_control với action="write_device", device="Y1", value=1 để bật ngõ ra Y1 trên PLC Xinje thật và xác nhận đèn Y1 sáng trên giao diện.