Atlan

ทางการ

MCP Server อย่างเป็นทางการจาก Atlan ที่ช่วยให้คุณนำพลังของเมทาดาทามาสู่เครื่องมือ AI ของคุณ

GitHub

คุณทำอะไรได้บ้างด้วย Atlan MCP?

ค้นหาสินทรัพย์ — ค้นหาสินทรัพย์ข้อมูลโดยใช้เงื่อนไขด้วย search_assets
ดึงข้อมูลสินทรัพย์ผ่าน DSL — ดึงสินทรัพย์โดยใช้คำค้นหาภาษาเฉพาะโดเมนด้วย get_assets_by_dsl
สำรวจสายข้อมูล — ติดตามความสัมพันธ์ต้นทางและปลายทางของสินทรัพย์ด้วย traverse_lineage
อัปเดตเมทาดาทาของสินทรัพย์ — แก้ไขคำอธิบายของผู้ใช้และสถานะใบรับรองบนสินทรัพย์ผ่าน update_assets
จัดการพจนานุกรมธุรกิจ — สร้างพจนานุกรม หมวดหมู่ และคำศัพท์โดยใช้ create_glossaries, create_glossary_categories และ create_glossary_terms
ควบคุมกฎคุณภาพข้อมูล — สร้าง อัปเดต กำหนดเวลา และลบกฎคุณภาพข้อมูลด้วย create_dq_rules, update_dq_rules, schedule_dq_rules และ delete_dq_rules

เอกสาร

Atlan MCP Server

[!WARNING] เซิร์ฟเวอร์ MCP ภายในเครื่องนี้ถูกยกเลิกการใช้งานแล้ว ให้ใช้ Atlan MCP แบบโฮสต์ที่ mcp.atlan.com/mcp แทน

เส้นทางการติดตั้งภายในเครื่อง (Docker, uv หรือ pip install atlan-mcp-server) อยู่ในโหมดบำรุงรักษาเท่านั้น — ไม่มีฟีเจอร์ใหม่ ไม่รับประกันการสนับสนุน ปลายทางแบบโฮสต์เป็นวิธีที่แนะนำในการผสานรวม Atlan กับ Claude Desktop, Cursor, Codex, Databricks UC และไคลเอนต์ MCP อื่นๆ ดู ภาพรวม Atlan MCP สำหรับการตั้งค่า

เซิร์ฟเวอร์ Atlan Model Context Protocol ช่วยให้เอเจนต์ AI ของคุณโต้ตอบกับบริการของ Atlan ได้

เริ่มต้นอย่างรวดเร็ว

สร้างคีย์ Atlan API โดยทำตาม เอกสาร
เลือกหนึ่งในแนวทางต่อไปนี้ตามความต้องการของคุณ:
- ติดตั้งผ่าน Docker - ใช้คอนเทนเนอร์ Docker (แนะนำ)
- ติดตั้งผ่าน uv - ใช้ตัวจัดการแพ็คเกจ UV

[!NOTE] ตรวจสอบให้แน่ใจว่าได้แทนที่ <YOUR_API_KEY>, <YOUR_INSTANCE> และ <YOUR_AGENT_ID> ด้วยคีย์ Atlan API, URL อินสแตนซ์ และ ID เอเจนต์ (ไม่บังคับ) จริงของคุณในไฟล์การกำหนดค่าตามลำดับ

ติดตั้งผ่าน Docker

ข้อกำหนดเบื้องต้น:

ทำตาม คู่มือการติดตั้ง Docker อย่างเป็นทางการสำหรับระบบปฏิบัติการของคุณ
ตรวจสอบว่า Docker กำลังทำงาน:
```
docker --version
```

เพิ่มไปยัง Claude Desktop

ไปที่ Claude > Settings > Developer > Edit Config > claude_desktop_config.json และเพิ่ม:

{
  "mcpServers": {
    "atlan": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ATLAN_API_KEY=<YOUR_API_KEY>",
        "-e",
        "ATLAN_BASE_URL=https://<YOUR_INSTANCE>.atlan.com",
        "-e",
        "ATLAN_AGENT_ID=<YOUR_AGENT_ID>",
        "ghcr.io/atlanhq/atlan-mcp-server:latest"
      ]
    }
  }
}

เพิ่มไปยัง Cursor

เปิด Cursor > Settings > Tools & Integrations > New MCP Server เพื่อรวมสิ่งต่อไปนี้:

{
  "mcpServers": {
    "atlan": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ATLAN_API_KEY=<YOUR_API_KEY>",
        "-e",
        "ATLAN_BASE_URL=https://<YOUR_INSTANCE>.atlan.com",
        "-e",
        "ATLAN_AGENT_ID=<YOUR_AGENT_ID>",
        "ghcr.io/atlanhq/atlan-mcp-server:latest"
      ]
    }
  }
}

ติดตั้งผ่าน uv

ข้อกำหนดเบื้องต้น:

ติดตั้ง uv:

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows (PowerShell)
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

# Alternative: if you already have Python/pip
pip install uv

ตรวจสอบการติดตั้ง:
```
uv --version
```

[!NOTE] ด้วย uv, uvx จะดึงเวอร์ชันล่าสุดโดยอัตโนมัติทุกครั้งที่คุณรัน เพื่อพฤติกรรมที่คาดการณ์ได้มากขึ้น ให้พิจารณาใช้ตัวเลือก Docker

เพิ่มไปยัง Claude Desktop

ไปที่ Claude > Settings > Developer > Edit Config > claude_desktop_config.json เพื่อรวมสิ่งต่อไปนี้:

{
  "mcpServers": {
    "atlan": {
      "command": "uvx",
      "args": ["atlan-mcp-server"],
      "env": {
        "ATLAN_API_KEY": "<YOUR_API_KEY>",
        "ATLAN_BASE_URL": "https://<YOUR_INSTANCE>.atlan.com",
        "ATLAN_AGENT_ID": "<YOUR_AGENT_ID>"
      }
    }
  }
}

เพิ่มไปยัง Cursor

เปิด Cursor > Settings > Tools & Integrations > New MCP Server เพื่อรวมสิ่งต่อไปนี้:

{
  "mcpServers": {
    "atlan": {
      "command": "uvx",
      "args": ["atlan-mcp-server"],
      "env": {
        "ATLAN_API_KEY": "<YOUR_API_KEY>",
        "ATLAN_BASE_URL": "https://<YOUR_INSTANCE>.atlan.com",
        "ATLAN_AGENT_ID": "<YOUR_AGENT_ID>"
      }
    }
  }
}

เครื่องมือที่พร้อมใช้งาน

เครื่องมือ	คำอธิบาย
`search_assets`	ค้นหาสินทรัพย์ตามเงื่อนไข
`get_assets_by_dsl`	ดึงข้อมูลสินทรัพย์โดยใช้คิวรี DSL
`traverse_lineage`	ดึงข้อมูลสายเลือดสำหรับสินทรัพย์
`update_assets`	อัปเดตแอตทริบิวต์สินทรัพย์ (คำอธิบายผู้ใช้และสถานะใบรับรอง)
`create_glossaries`	สร้างอภิธานศัพท์
`create_glossary_categories`	สร้างหมวดหมู่อภิธานศัพท์
`create_glossary_terms`	สร้างคำศัพท์อภิธานศัพท์
`create_dq_rules`	สร้างกฎคุณภาพข้อมูลบนสินทรัพย์ Table, View, MaterialisedView หรือ SnowflakeDynamicTable (ระดับคอลัมน์, ระดับตาราง, SQL แบบกำหนดเอง)
`update_dq_rules`	อัปเดตกฎคุณภาพข้อมูลที่มีอยู่ (เกณฑ์, ลำดับความสำคัญ, เงื่อนไข ฯลฯ)
`schedule_dq_rules`	กำหนดเวลาการดำเนินการกฎคุณภาพข้อมูลสำหรับสินทรัพย์โดยใช้นิพจน์ cron
`delete_dq_rules`	ลบกฎคุณภาพข้อมูลหนึ่งหรือหลายรายการด้วย GUID
`query_asset`	ดำเนินการคิวรี SQL บนสินทรัพย์ตาราง/วิว

การควบคุมการเข้าถึงเครื่องมือ

Atlan MCP Server มีมิดเดิลแวร์จำกัดเครื่องมือที่กำหนดค่าได้ ซึ่งช่วยให้คุณควบคุมได้ว่าเครื่องมือใดที่พร้อมใช้งานสำหรับผู้ใช้ สิ่งนี้มีประโยชน์สำหรับการควบคุมการเข้าถึงตามบทบาทหรือการจำกัดการดำเนินการบางอย่างในสภาพแวดล้อมเฉพาะ

การจำกัดเครื่องมือ

คุณสามารถจำกัดการเข้าถึงเครื่องมือเฉพาะได้โดยใช้ตัวแปรสภาพแวดล้อม RESTRICTED_TOOLS ระบุรายชื่อเครื่องมือที่ควรถูกบล็อกโดยคั่นด้วยเครื่องหมายจุลภาค:

การกำหนดค่า Docker

{
  "mcpServers": {
    "atlan": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ATLAN_API_KEY=<YOUR_API_KEY>",
        "-e",
        "ATLAN_BASE_URL=https://<YOUR_INSTANCE>.atlan.com",
        "-e",
        "ATLAN_AGENT_ID=<YOUR_AGENT_ID>",
        "-e",
        "RESTRICTED_TOOLS=get_assets_by_dsl_tool,update_assets_tool",
        "ghcr.io/atlanhq/atlan-mcp-server:latest"
      ]
    }
  }
}

การกำหนดค่า uv

{
  "mcpServers": {
    "atlan": {
      "command": "uvx",
      "args": ["atlan-mcp-server"],
      "env": {
        "ATLAN_API_KEY": "<YOUR_API_KEY>",
        "ATLAN_BASE_URL": "https://<YOUR_INSTANCE>.atlan.com",
        "ATLAN_AGENT_ID": "<YOUR_AGENT_ID>",
        "RESTRICTED_TOOLS": "get_assets_by_dsl_tool,update_assets_tool"
      }
    }
  }
}

ชื่อเครื่องมือที่พร้อมใช้งานสำหรับการจำกัด

คุณสามารถจำกัดเครื่องมือใดๆ ต่อไปนี้:

search_assets_tool - ฟังก์ชันการค้นหาสินทรัพย์
get_assets_by_dsl_tool - การดำเนินการคิวรี DSL
traverse_lineage_tool - การสำรวจสายเลือด
update_assets_tool - การอัปเดตสินทรัพย์ (คำอธิบาย, ใบรับรอง)
create_glossaries - การสร้างอภิธานศัพท์
create_glossary_categories - การสร้างหมวดหมู่
create_glossary_terms - การสร้างคำศัพท์
create_dq_rules_tool - การสร้างกฎคุณภาพข้อมูล
update_dq_rules_tool - การอัปเดตกฎคุณภาพข้อมูล
schedule_dq_rules_tool - การกำหนดเวลากฎคุณภาพข้อมูล
delete_dq_rules_tool - การลบกฎคุณภาพข้อมูล

กรณีการใช้งานทั่วไป

การเข้าถึงแบบอ่านอย่างเดียว

จำกัดการดำเนินการเขียนทั้งหมด:

RESTRICTED_TOOLS=update_assets_tool,create_glossaries,create_glossary_categories,create_glossary_terms,create_dq_rules_tool,update_dq_rules_tool,schedule_dq_rules_tool,delete_dq_rules_tool

ปิดใช้งานคิวรี DSL

ด้วยเหตุผลด้านความปลอดภัยหรือประสิทธิภาพ:

RESTRICTED_TOOLS=get_assets_by_dsl_tool

การเข้าถึงขั้นต่ำ

อนุญาตเฉพาะการค้นหาพื้นฐาน:

RESTRICTED_TOOLS=get_assets_by_dsl_tool,update_assets_tool,traverse_lineage_tool,create_glossaries,create_glossary_categories,create_glossary_terms,create_dq_rules_tool,update_dq_rules_tool,schedule_dq_rules_tool,delete_dq_rules_tool

วิธีการทำงาน

เมื่อเครื่องมือถูกจำกัด:

ซ่อนจากรายการ: เครื่องมือที่ถูกจำกัดจะไม่ปรากฏเมื่อไคลเอนต์ร้องขอเครื่องมือที่พร้อมใช้งาน
บล็อกการดำเนินการ: หากมีใครพยายามดำเนินการเครื่องมือที่ถูกจำกัด พวกเขาจะได้รับข้อความแสดงข้อผิดพลาดที่ชัดเจน
บันทึก: การตัดสินใจเข้าถึงทั้งหมดจะถูกบันทึกเพื่อการตรวจสอบและการดีบัก

ไม่มีการจำกัด (ค่าเริ่มต้น)

หากคุณไม่ได้ตั้งค่าตัวแปรสภาพแวดล้อม RESTRICTED_TOOLS เครื่องมือทั้งหมดจะพร้อมใช้งานตามค่าเริ่มต้น

โหมดการขนส่ง

Atlan MCP Server รองรับโหมดการขนส่งสามโหมด แต่ละโหมดปรับให้เหมาะสมสำหรับสถานการณ์การปรับใช้ที่แตกต่างกัน สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับโหมดการขนส่ง MCP ดู เอกสาร MCP อย่างเป็นทางการ

โหมดการขนส่ง	กรณีการใช้งาน	ประโยชน์	เมื่อใดควรใช้
stdio (ค่าเริ่มต้น)	การพัฒนาในเครื่อง, การผสานรวม IDE	การสื่อสารโดยตรงที่เรียบง่าย	Claude Desktop, Cursor IDE
SSE (Server-Sent Events)	การปรับใช้ระยะไกล, เว็บเบราว์เซอร์	การสตรีมแบบเรียลไทม์, เข้ากันได้กับเว็บ	การปรับใช้บนคลาวด์, ไคลเอนต์เว็บ
streamable-http	การเชื่อมต่อระยะไกลแบบ HTTP	HTTP มาตรฐาน, เป็นมิตรกับโหลดบาลานเซอร์	Kubernetes, การปรับใช้แบบคอนเทนเนอร์

สำหรับคำแนะนำการปรับใช้ที่ครอบคลุม ตัวอย่างการกำหนดค่า และแนวทางปฏิบัติที่ดีที่สุดสำหรับการใช้งานจริง ดู คู่มือการปรับใช้ ของเรา

การปรับใช้สำหรับการใช้งานจริง

โฮสต์อิมเมจคอนเทนเนอร์ Atlan MCP บนคลาวด์/แพลตฟอร์มที่คุณเลือก
ตรวจสอบให้แน่ใจว่าคุณได้เพิ่มตัวแปรสภาพแวดล้อมที่จำเป็นทั้งหมด
เลือกโหมดการขนส่งที่เหมาะสมสำหรับสถานการณ์การปรับใช้ของคุณ แนะนำให้ใช้ SSE Transport สำหรับการใช้งานจริง (-e MCP_TRANSPORT=sse)
สำหรับสถานการณ์และการกำหนดค่าการปรับใช้โดยละเอียด โปรดดู คู่มือการปรับใช้

การกำหนดค่า MCP ระยะไกล

ขณะนี้เรายังไม่มีเซิร์ฟเวอร์ MCP ระยะไกลสำหรับ Atlan ที่พร้อมใช้งานทั่วไป

คุณสามารถใช้เครื่องมือพร็อกซีภายในเครื่อง mcp-remote เพื่อเชื่อมต่อกับเซิร์ฟเวอร์ MCP ระยะไกลของคุณ

สิ่งนี้ช่วยให้คุณทดสอบว่าการโต้ตอบกับเซิร์ฟเวอร์ MCP ระยะไกลของคุณจะเป็นอย่างไรกับไคลเอนต์ MCP ในโลกแห่งความเป็นจริง

{
  "mcpServers": {
    "math": {
      "command": "npx",
      "args": ["mcp-remote", "https://hosted-domain"]
    }
  }
}

พัฒนาในเครื่อง

ต้องการพัฒนาในเครื่อง? ดูคู่มือ การสร้างในเครื่อง ของเราสำหรับคำแนะนำทีละขั้นตอน!

ต้องการความช่วยเหลือ?

ติดต่อ support@atlan.com สำหรับคำถามหรือข้อเสนอแนะใดๆ
คุณยังสามารถสร้าง GitHub issue ได้โดยตรง แล้วเราจะตอบกลับให้คุณ

คำถามที่พบบ่อย

ฉันจำเป็นต้องติดตั้ง Python หรือไม่?

คำตอบสั้นๆ: ขึ้นอยู่กับวิธีการติดตั้งของคุณ

Docker (แนะนำ): ไม่จำเป็นต้องติดตั้ง Python บนเครื่องโฮสต์ของคุณ คอนเทนเนอร์รวมทุกอย่างที่จำเป็นไว้แล้ว
uv: จำเป็นต้องมีรันไทม์ Python แต่ uv จะดาวน์โหลดและจัดการ Python 3.11+ ให้คุณโดยอัตโนมัติหากยังไม่มี

รายละเอียดทางเทคนิค: เซิร์ฟเวอร์ Atlan MCP ถูกนำไปใช้เป็นแอปพลิเคชัน Python ตัว Model Context Protocol เองไม่ขึ้นอยู่กับภาษา แต่การนำไปใช้ปัจจุบันของเราต้องการ Python 3.11+ เพื่อทำงาน

การแก้ไขปัญหา

หาก Claude Desktop แสดงข้อผิดพลาดคล้ายกับ spawn uv ENOENT {"context":"connection","stack":"Error: spawn uv ENOENT\n at ChildProcess._handle.onexit เป็นไปได้สูงว่าเป็นปัญหา นี้ ที่ Claude ไม่สามารถหา uv ได้ วิธีแก้ไข:
- ตรวจสอบให้แน่ใจว่าได้ติดตั้ง uv และพร้อมใช้งานใน PATH ของคุณ
- รัน which uv เพื่อตรวจสอบเส้นทางการติดตั้ง
- อัปเดตการกำหนดค่าของ Claude ให้ชี้ไปยังเส้นทาง uv ที่แน่นอนโดยรัน whereis uv และใช้เส้นทางนั้น