hsagicคู่มือเชื่อมต่อ MCP

ให้ผู้ช่วย AI ของคุณ
ค้นความรู้จาก HSAGIC

เชื่อมต่อครั้งแรก แล้วเรียกค้นเอกสารศุลกากรพร้อมอ่านหลักฐานต้นทางได้จากเครื่องมือที่คุณใช้ทำงาน

ที่อยู่ MCP สำหรับการเชื่อมต่อ

https://train.hsagic.i-axo.com/mcp
ชื่อเซิร์ฟเวอร์
hsagic
Transport
Streamable HTTP
เข้าสู่ระบบ
OAuth ด้วยบัญชี HSAGIC
สิทธิ์ที่ขอ
knowledge:read

เตรียมบัญชี HSAGIC ของคุณ

ขออีเมล รหัสผ่าน และสิทธิ์อ่านเอกสารจากผู้ดูแลก่อนเริ่ม ใช้บัญชีนี้ในหน้าเข้าสู่ระบบของ HSAGIC ที่เปิดระหว่างเชื่อมต่อ ไม่ต้องใส่รหัสผ่านหรือ API key ลงใน config การเชื่อมต่อ MCP นี้ต้องใช้อินเทอร์เน็ตเพื่อเข้าถึงเซิร์ฟเวอร์

ตั้งค่า Codex CLI

สำหรับผู้ใช้ Terminal ที่ติดตั้ง Codex CLI แล้ว

  1. เพิ่มเซิร์ฟเวอร์ HSAGIC

    รันใน Terminal ของเครื่องที่จะใช้งาน หากมี hsagic อยู่แล้ว ให้ข้ามไปล็อกอิน

    Terminal
    codex mcp add hsagic --url https://train.hsagic.i-axo.com/mcp
  2. เข้าสู่ระบบผ่านเบราว์เซอร์

    Terminal
    codex mcp login hsagic

    เปิดลิงก์ที่ได้ กรอกบัญชี HSAGIC แล้วเลือก “เข้าสู่ระบบและอนุญาต” รอข้อความสำเร็จใน Terminal

  3. ตรวจการเชื่อมต่อ

    เปิด Codex ใหม่ พิมพ์ /mcp แล้วตรวจว่า hsagic ขึ้น connected และพบเครื่องมือ 2 รายการด้านล่าง

ตั้งค่าผ่านไฟล์ config.toml แทนคำสั่ง add

เพิ่มส่วนนี้ใน ~/.codex/config.toml เพียงครั้งเดียว แล้วรันคำสั่งล็อกอินด้านบน

config.toml
[mcp_servers.hsagic]
url = "https://train.hsagic.i-axo.com/mcp"

อ้างอิง OpenAI Docs: MCP สำหรับ Codex และ Desktop

ตั้งค่า ChatGPT Desktop

สำหรับแอปที่มีเมนู MCP servers และใช้ Codex host ในเครื่อง

  1. เปิด Settings → MCP servers

    เลือก Add server แล้วกรอกค่าต่อไปนี้

    Name
    hsagic
    Transport
    Streamable HTTP
    URL
    https://train.hsagic.i-axo.com/mcp
    Authentication
    OAuth
  2. Save แล้วเลือก Restart

    เลือก Authenticate ที่ HSAGIC จากนั้นเข้าสู่ระบบในหน้าเว็บที่เปิดขึ้น

  3. กลับมาที่บทสนทนา

    พิมพ์ /mcp เพื่อตรวจว่าเชื่อมต่อแล้ว จากนั้นลองคำขอด้านล่าง

หากตั้งค่า Codex CLI บน host เดียวกันแล้ว แอปใช้ config ร่วมกันได้ ไม่ต้องเพิ่มซ้ำ หากไม่มีเมนู MCP servers ให้ใช้ วิธีเชื่อมผ่าน ChatGPT บนเว็บ และตรวจเวอร์ชันแอปกับผู้ดูแล

ขั้นตอน Desktop อ้างอิง OpenAI Docs ยังไม่ได้ยืนยันกับแอป Desktop ทุกเวอร์ชัน

ChatGPT บนเว็บ

สำหรับการเชื่อมแบบ custom app ในบัญชีที่เปิด Developer mode ได้

  1. เปิด Developer mode

    ที่ chatgpt.com ไป Settings → Security and login → Developer mode เมนูอาจต่างกันตามเวอร์ชันและนโยบาย workspace

  2. เพิ่ม MCP ใน Plugins

    กดปุ่มเพิ่ม ตั้งชื่อ hsagic ใส่ URL ด้านบน เลือก OAuth หากมีตัวเลือกการลงทะเบียนให้ใช้ DCR ซึ่ง HSAGIC รองรับ ไม่ต้องกรอก client secret เอง

  3. เชื่อมบัญชีและเลือกใช้ในแชต

    เข้าสู่ระบบ HSAGIC แล้วเลือก app นี้จากเมนูเครื่องมือของบทสนทนา หากไม่พบสิทธิ์สร้าง app ให้ติดต่อผู้ดูแล workspace

อ้างอิง OpenAI Docs: Developer mode และ การเชื่อมและทดสอบ MCP การทดสอบบนบัญชี ChatGPT จริงยังต้องยืนยันแยกจากการทดสอบเซิร์ฟเวอร์

ลองค้นหลักฐานชิ้นแรก

ส่งข้อความนี้หลังเชื่อมต่อ เพื่อให้ผู้ช่วยเรียก HSAGIC โดยตรง

ตัวอย่างข้อความ
ใช้ hsagic ค้นเอกสารเกี่ยวกับ “ม้า” แล้วอ่านหน้าหลักฐานที่เกี่ยวข้อง พร้อมบอกชื่อเอกสาร เลขหน้า และข้อจำกัดของข้อความสกัด หากหลักฐานไม่พอ อย่าเดาพิกัด

search_knowledge

ค้นข้อความในคลังเอกสารที่บัญชีของคุณมีสิทธิ์อ่าน

read_evidence_page

อ่านหน้าหลักฐานตามแหล่งข้อมูลและ hash ที่ได้จากผลค้นหา

ขณะนี้ MCP ใช้ค้นและอ่านหลักฐานเท่านั้น ยังไม่ใช่ระบบวินิจฉัยพิกัดหรือยืนยันอัตราภาษี ควรตรวจเอกสารต้นฉบับและวันที่มีผลบังคับใช้ก่อนนำไปใช้จริง

เมื่อเชื่อมต่อไม่ได้

ขึ้น authentication required หรือ 0 tools

รัน codex mcp login hsagic หรือเลือก Authenticate ใน Desktop ให้ล็อกอินสำเร็จก่อน แล้วเปิด session ใหม่

ขึ้น Invalid origin หรือคำขอหมดอายุ

ปิดหน้าล็อกอินเดิม แล้วเริ่มล็อกอินใหม่จาก Codex หรือ ChatGPT อย่านำลิงก์เก่ากลับมาใช้ หากยังเกิดซ้ำ แจ้งผู้ดูแลพร้อมเวลาที่เกิดปัญหา

เชื่อมได้แต่ค้นไม่พบเอกสาร

ลองคำค้นอื่น หรือติดต่อผู้ดูแลเพื่อตรวจสิทธิ์อ่านแหล่งข้อมูล การล็อกอินสำเร็จไม่ได้ให้สิทธิ์อ่านเอกสารทุกชุดโดยอัตโนมัติ

เคยใช้ได้ แต่ต้องล็อกอินใหม่

บริการนี้ออก token อายุไม่เกิน 1 ชั่วโมงและยังไม่มี refresh token ให้ล็อกอินใหม่เมื่อหมดอายุ สิทธิ์อ่านเอกสารมีวันหมดอายุแยกต่างหากซึ่งผู้ดูแลเป็นผู้กำหนด

รัน Codex ผ่าน SSH แล้ว callback เข้าไม่ถึง

ขั้นตอน CLI นี้เหมาะกับ Terminal และเบราว์เซอร์บนเครื่องเดียวกัน หากใช้เครื่อง remote ให้แจ้งผู้ดูแลเพื่อจัดการ callback ของเครื่องนั้น ไม่ควรเปลี่ยน URL MCP หรือใช้ callback จากคำขออื่น

มีการเพิ่มหรืออัปเดตข้อมูล ต้องตั้งค่าใหม่ไหม

URL เดิมอ่านข้อมูลที่บริการเผยแพร่และบัญชีมีสิทธิ์เข้าถึง หากเพิ่มชุดข้อมูลใหม่ ผู้ดูแลอาจต้องให้สิทธิ์เพิ่ม หากรายชื่อเครื่องมือเปลี่ยน ให้ Restart หรือ Refresh การเชื่อมต่อแล้วเริ่มบทสนทนาใหม่