ใช้ ArchLens กับผู้ช่วย AI (MCP)

ArchLens มี remote MCP (Model Context Protocol) server เชื่อมผู้ช่วย AI ครั้งเดียว แล้วให้มันดู workspace อ่านไดอะแกรม และวาดไดอะแกรมใหม่ลง draft ให้คุณตรวจและ merge

Server

URL	`https://app.archlens.space/api/mcp`
Transport	streamable HTTP แบบ stateless (POST เท่านั้น ตอบเป็น JSON)
เข้าสู่ระบบ	OAuth 2.1 พร้อม dynamic client registration และ PKCE หรือ bearer token ส่วนตัว
ทำงานในนาม	คนที่เชื่อมต่อ ตามบทบาทในแต่ละ workspace (viewer เขียนไม่ได้)

ต้องมีบัญชี ArchLens: สมัครด้วย Google หรือ GitHub

เชื่อมผู้ช่วย AI

Claude (claude.ai และ Claude Desktop)

ที่ Settings › Connectors เพิ่ม custom connector แล้ววาง https://app.archlens.space/api/mcp Claude จะเปิด ArchLens ให้เข้าสู่ระบบและอนุมัติ custom connector อาจขึ้นกับแพ็กเกจของ Claude ดูศูนย์ช่วยเหลือของ Claude

Claude Code

claude mcp add --transport http archlens https://app.archlens.space/api/mcp

แล้วพิมพ์ /mcp ใน Claude Code เพื่อเข้าสู่ระบบ ถ้าใช้ token ส่วนตัว เพิ่ม --header "Authorization: Bearer alk_..."

ChatGPT

ถ้าแพ็กเกจ ChatGPT ของคุณมี custom connector (developer mode) ให้เพิ่ม connector ด้วย URL https://app.archlens.space/api/mcp และเลือกการยืนยันตัวตนแบบ OAuth แล้วอนุมัติใน ArchLens ชื่อเมนูเปลี่ยนตามเวอร์ชัน ดูขั้นตอนล่าสุดที่ศูนย์ช่วยเหลือของ OpenAI

Cursor

ใน ~/.cursor/mcp.json (หรือ .cursor/mcp.json ในโปรเจกต์):

{
  "mcpServers": {
    "archlens": { "url": "https://app.archlens.space/api/mcp" }
  }
}

VS Code

สั่ง MCP: Add Server เลือก HTTP แล้ววาง URL หรือเพิ่มในไฟล์ตั้งค่า MCP:

{
  "servers": {
    "archlens": { "type": "http", "url": "https://app.archlens.space/api/mcp" }
  }
}

client อื่นที่รองรับ remote MCP server แบบ streamable HTTP ใช้ได้เหมือนกัน

เข้าสู่ระบบ: OAuth หรือ token

OAuth (แนะนำ): client ที่รองรับใช้แค่ URL มันจะค้นหา authorization server ของ ArchLens ลงทะเบียนตัวเอง แล้วพาคุณไปอนุมัติที่ ArchLens access token มีอายุหนึ่งชั่วโมงและ client ต่ออายุเอง
Token ส่วนตัว: ใน ArchLens เปิด ตั้งค่า ⚙ › Profile › AI access tokens ตั้งชื่อแล้วสร้าง token จะแสดงครั้งเดียว ส่งเป็น Authorization: Bearer alk_... มีได้สูงสุด 10 อัน
เพิกถอน token หรือแอปที่เชื่อมไว้ได้จากส่วนเดียวกันทุกเมื่อ token ทำงานในนามคุณ เก็บเป็นความลับ

เครื่องมือ

เครื่องมือ	ทำอะไร
`list_workspaces`	workspace ของคุณ พร้อมบทบาท
`create_workspace`	สร้าง workspace ใหม่ว่าง ๆ (ตามขีดจำกัดของแพ็กเกจ)
`list_diagrams`	ไดอะแกรมของ workspace
`get_diagram`	ไดอะแกรมเป็นข้อความ Mermaid C4 หนึ่งบล็อกต่อระดับ
`list_elements`	วัตถุทั้งหมด: id ชื่อ ชนิด ตัวที่ครอบ ไอคอน และไดอะแกรมที่อยู่
`list_icons` / `set_icons`	โลโก้เทคโนโลยี และการใส่ให้วัตถุ
`merge_duplicates`	รวมวัตถุที่วาดซ้ำเป็นอันเดียว (ลอง dry run ก่อน และบันทึกเวอร์ชันก่อนเปลี่ยน workspace จริง)
`create_draft` / `discard_draft`	เปิดสำเนาแยกของ workspace เพื่อแก้ หรือทิ้ง
`import_structurizr`	สร้างไดอะแกรมใหม่จาก Structurizr DSL (หรือไฟล์ JSON ของ ArchLens) ใช้วัตถุที่มีอยู่ซ้ำ และคืนลิงก์
`delete_diagram`	ลบไดอะแกรม (เฉพาะ owner)
`clear_model`	ล้าง model ของ workspace ทั้ง object เส้น และ flow (เฉพาะ owner บันทึกเวอร์ชันก่อน)
`create_flow`	แพ็กเกจ Unlimited: เปลี่ยนสถานการณ์ที่คุณเล่าเป็น flow บนเส้นเชื่อมของไดอะแกรม
`explain_diagram`	แพ็กเกจ Unlimited: วัตถุ เส้นเชื่อม และ flow ทุกระดับเป็นข้อความให้ผู้ช่วยอธิบาย

ทำงานแบบตรวจก่อนเสมอ

ผู้ช่วยไม่จำเป็นต้องแตะไดอะแกรมจริงของคุณ server บอกให้มันทำงานแบบนี้:

list_workspaces เพื่อหา workspace
create_draft เพื่อเปิด draft
import_structurizr ลง draft นั้นด้วยโมเดลที่เขียนจากคำขอของคุณ
มันให้ลิงก์ คุณเปิด draft ใน ArchLens ดูความต่าง แล้ว merge หรือ discard

ตัวอย่างคำขอ:

"อ่าน repository นี้แล้ววาด C4 container diagram ลง workspace Platform ใน ArchLens เป็น draft"
"เปิดไดอะแกรม Checkout แล้วบอกว่า service ไหนคุยกับผู้ให้บริการชำระเงิน"
"ใส่ไอคอนเทคโนโลยีให้วัตถุในไดอะแกรม Shop"

เริ่มใช้ฟรีด้วย Google หรือ GitHubเชื่อมผู้ช่วย AI ได้ในสองนาที