Atlassian MCP Server

npx add-mcp 'https://mcp.atlassian.com/v1/mcp/authv2'

Atlassian MCP Server

เซิร์ฟเวอร์ Model Context Protocol (MCP) อย่างเป็นทางการสำหรับ Atlassian: บริดจ์ที่โฮสต์บนคลาวด์ซึ่งช่วยให้เครื่องมือ AI ของคุณเข้าถึงข้อมูล Jira, Confluence, Jira Service Management, Bitbucket, Compass, Loom และแพลตฟอร์ม Atlassian ในวงกว้างได้อย่างปลอดภัยและแบบเรียลไทม์ — ขับเคลื่อนโดย Teamwork Graph ของคุณ

เริ่มต้นใช้งาน · เครื่องมือที่รองรับ · ความปลอดภัยและการดูแลระบบ · ชุมชน

---

Atlassian MCP Server อย่างเป็นทางการ คือบริดจ์บนคลาวด์ระหว่างไซต์ Atlassian Cloud ของคุณกับเครื่องมือภายนอกที่เข้ากันได้ เมื่อกำหนดค่าแล้ว จะช่วยให้เครื่องมือเหล่านั้นโต้ตอบกับ Jira, Confluence, Jira Service Management, Bitbucket, Compass, Loom และข้อมูลแพลตฟอร์ม Atlassian (Projects, Goals, Teams, Focus, Talent และ Teamwork Graph) ได้แบบเรียลไทม์ การตรวจสอบสิทธิ์ใช้ OAuth 2.1 หรือ API tokens ดังนั้นทุกการดำเนินการจึงเคารพการควบคุมการเข้าถึงที่มีอยู่ของผู้ใช้

ด้วย Atlassian MCP Server คุณสามารถ:

• สรุปและค้นหา Jira, Jira Service Management, Confluence, Bitbucket, Projects, Goals และอื่นๆ ได้โดยไม่ต้องสลับเครื่องมือ
• ดึงข้อมูลและตรวจสอบ การบันทึกวิดีโอและการประชุมจาก Loom
• สร้างและอัปเดต รายการงานหรือเพจตามคำสั่งภาษาธรรมชาติ
• ทำให้งานซ้ำซ้อนเป็นอัตโนมัติ เช่น การสร้างรายการงานจากบันทึกการประชุมหรือสเปก

เชื่อมต่อครั้งเดียว จากนั้นอธิบายสิ่งที่คุณต้องการ — ไม่ต้องสลับแท็บและไม่ต้องคัดลอกวาง AI ของคุณจะเลือกและดำเนินการที่ถูกต้องให้

สร้างขึ้นสำหรับนักพัฒนา ผู้สร้างเนื้อหา และทีมโปรเจกต์ที่ทำงานใน IDE หรือเครื่องมือ AI และต้องการใช้ข้อมูล Atlassian โดยไม่ต้องสลับบริบทอยู่ตลอดเวลา

[!IMPORTANT] v2 เป็นเวอร์ชันที่แนะนำในขณะนี้ การตั้งค่าใหม่ควรใช้ https://mcp.atlassian.com/v2/mcp ซึ่งเปิดเผยเครื่องมือและผลิตภัณฑ์มากขึ้น การเชื่อมต่อ v1 ที่มีอยู่จะเริ่มเปิดเผยและใช้เครื่องมือ v2 โดยอัตโนมัติ ไคลเอนต์ที่เข้ากันไม่ได้อาจต้องล้าง cached client IDs หรือข้อมูลรับรอง .well-known เพื่อให้ยังคงตรวจสอบสิทธิ์ได้ สำหรับขั้นตอนการตั้งค่า ดู เริ่มต้นใช้งานกับ Atlassian MCP Server

การตั้งค่าแบบคลิกเดียว

เลือกไคลเอนต์ AI ของคุณด้านล่างเพื่อติดตั้ง Atlassian MCP Server อย่างเป็นทางการ แต่ละปุ่มใช้ลิงก์การติดตั้งแบบเนทีฟของไคลเอนต์ของคุณ ดังนั้นคุณไม่จำเป็นต้องแก้ไขไฟล์ JSON config ด้วยตนเอง

เพิ่มไปยัง Cursor อ้างอิงอีสชู่และบันทึกงานในโค้ดเบสของคุณ

เพิ่มไปยัง VS Code ค้นหาและสร้างอีสชู่ Jira ผ่าน GitHub Copilot

เพิ่มไปยัง ChatGPT ค้นหา สรุป และสร้างได้โดยตรงจาก ChatGPT

เพิ่มไปยัง Claude นำ Jira และ Confluence เข้าสู่เวิร์กโฟลว์ Claude

ให้เอเจนต์ของคุณจัดการการตั้งค่า

เอเจนต์เขียนโค้ด AI ส่วนใหญ่สามารถติดตั้ง ตรวจสอบสิทธิ์ และกำหนดค่าเซิร์ฟเวอร์ได้ด้วยตัวเอง คัดลอกและวางพรอมต์นี้ลงในเอเจนต์ของคุณ:

Set up Atlassian MCP for this agent using the official setup guide at
https://support.atlassian.com/atlassian-rovo-mcp-server/docs/getting-started-with-the-atlassian-remote-mcp-server/
and the MCP server URL https://mcp.atlassian.com/v2/mcp. Then start the Atlassian MCP
authentication flow so I can sign in.

หรือเพิ่มเซิร์ฟเวอร์ด้วยตนเองด้วยคำสั่งของไคลเอนต์ของคุณเอง:

ไคลเอนต์	คำสั่งหรือการกำหนดค่า
Claude Code	claude mcp add --transport http atlassian https://mcp.atlassian.com/v2/mcp จากนั้นรัน /mcp ในเซสชันเพื่อตรวจสอบสิทธิ์
Codex	codex mcp add atlassian --url https://mcp.atlassian.com/v2/mcp
Claude Desktop	การตั้งค่า → ส่วนขยาย → เรียกดูส่วนขยาย → ปลั๊กอิน จากนั้นค้นหา Atlassian
Codex Desktop	ปลั๊กอิน หรือ ตัวเชื่อมต่อ จากนั้นติดตั้ง Atlassian Rovo
VS Code / GitHub Copilot	มุมมองส่วนขยาย → ค้นหา @mcp Atlassian → ติดตั้ง
Cursor	ปลั๊กอิน Atlassian สำหรับ Cursor พร้อม MCP → เพิ่มไปยัง Cursor
Windsurf	Cascade → MCP servers → Add Server → Add custom server โดยตั้งค่า serverUrl เป็น https://mcp.atlassian.com/v2/mcp
ไคลเอนต์ MCP อื่นๆ	ใช้ URL เซิร์ฟเวอร์ https://mcp.atlassian.com/v2/mcp

สารบัญ

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

---

ไคลเอนต์ที่รองรับ

Atlassian MCP Server ทำงานร่วมกับรายการไคลเอนต์ที่เข้ากันได้กับ MCP ที่เพิ่มขึ้นเรื่อยๆ:

ไคลเอนต์	เอกสารอ้างอิงการตั้งค่า
OpenAI ChatGPT	คู่มือ Connectors / MCP
OpenAI Codex (CLI และ Desktop)	เอกสาร MCP ของ Codex
Claude (Claude.ai, Desktop และ Code)	เอกสาร MCP ของ Claude
Cursor	Atlassian บน Cursor marketplace
Visual Studio Code (GitHub Copilot)	เอกสาร MCP ของ VS Code
GitHub Copilot CLI	เกี่ยวกับ Copilot CLI
Google Gemini CLI	เอกสาร MCP ของ Gemini CLI
Windsurf	เอกสาร MCP ของ Windsurf
Docker	Docker MCP Catalog และ Toolkit
Kiro และไคลเอนต์ Agent Plugins อื่นๆ	เอกสาร Kiro Powers
Amazon Quick Suite	คู่มือการผสานรวม MCP

Atlassian MCP Server ยังรองรับ ไคลเอนต์ที่เข้ากันได้กับ MCP ในเครื่อง ที่สามารถรันบน localhost และเชื่อมต่อกับเซิร์ฟเวอร์ผ่านพร็อกซี mcp-remote ซึ่งช่วยให้การผสานรวมแบบกำหนดเองหรือของบุคคลที่สามที่ปฏิบัติตามข้อกำหนด MCP ทำงานได้

[!TIP] สำหรับรายการไคลเอนต์ที่รองรับที่เป็นปัจจุบันและเป็นทางการ พร้อมขั้นตอนการตั้งค่าแบบทีละขั้นตอน ดู เริ่มต้นใช้งานกับ Atlassian MCP Server คุณยังสามารถอ้างอิงเอกสาร MCP ของไคลเอนต์ของคุณเองหรือผู้ช่วยในตัวได้

---

การแพ็กเกจปลั๊กอินและความเข้ากันได้

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

รูปแบบ	Manifest และการกำหนดค่า	คอมโพเนนต์ที่ใช้ร่วมกัน
Agent Plugins v1	plugin.json และ mcp.json	skills/
ปลั๊กอิน Claude Code	.claude-plugin/plugin.json และ .claude-plugin/marketplace.json	.mcp.json และ skills/
ปลั๊กอิน Cursor	.cursor-plugin/plugin.json	.mcp.json และ skills/
ส่วนขยาย Gemini	gemini-extension.json	การกำหนดค่า MCP server ฝังอยู่ใน manifest
MCP Registry	server.json	เมตาดาต้าเซิร์ฟเวอร์ระยะไกล

สกิลใน skills/ กำหนดเป้าหมายที่ endpoint /v2/mcp และเป็นสิ่งที่ปลั๊กอินที่แพ็กเกจทั้งหมดติดตั้ง รุ่นก่อนหน้าถูกเก็บถาวรใน skills/v1/ สำหรับผู้ที่ยังใช้ endpoint v1 อยู่ ไม่ได้ติดตั้งโดยปลั๊กอินใดๆ และตั้งค่าด้วยตนเอง ดู skills/README.md สำหรับความแตกต่าง

ทั้ง mcp.json และ .mcp.json ตั้งใจไว้เช่นนั้น Agent Plugins ต้องการชื่อไฟล์ root mcp.json และคำศัพท์การขนส่งแบบพกพา ไคลเอนต์ที่มีอยู่ยังคงใช้ .mcp.json และคำศัพท์การกำหนดค่าแบบเนทีฟของตน รักษาการตั้งค่า endpoint ให้สอดคล้องกันเมื่อแก้ไขไฟล์ใดไฟล์หนึ่ง

แพ็กเกจ root สามารถนำเข้าได้โดยไคลเอนต์ที่ใช้ Agent Plugins รวมถึง Kiro Powers Manifest เฉพาะไคลเอนต์ยังคงพร้อมใช้งานและไม่ได้ถูกแทนที่ด้วยแพ็กเกจแบบพกพา

---

ผลิตภัณฑ์และเครื่องมือที่รองรับ

เครื่องมือถูกจัดระเบียบตามผลิตภัณฑ์และวัตถุประสงค์ (อ่าน เขียน ค้นหา ลบ หรือจัดการ) ผู้ดูแลระบบองค์กรให้หรือเพิกถอนการเข้าถึงในระดับกลุ่มสิทธิ์ และแต่ละเครื่องมือจะสืบทอดการเข้าถึงของกลุ่มหลัก

ผลิตภัณฑ์	กลุ่มสิทธิ์	OAuth 2.1	API token
Jira	read_jira · write_jira · search_jira	✅	✅
Jira (เปิดใช้งานโดยผู้ดูแลระบบ)	delete_jira · manage_jira	✅	✅
Confluence	read_confluence · write_confluence · search_confluence	✅	✅
Bitbucket Cloud	read_bitbucket · write_bitbucket	✅	✅
Jira Service Management	read_jsm · write_jsm	—	✅ (เท่านั้น)
แพลตฟอร์ม Atlassian	read_teamwork_graph · write_teamwork_graph · search_atlassian	✅	✅
Loom	read_loom · write_loom	✅	✅
Goals	read_goals · write_goals	✅	✅
Projects	read_projects · write_projects	✅	✅
Teams	read_teams · write_teams	✅	✅
Focus	read_focus · write_focus	✅	✅
Talent	read_talent · write_talent	✅	✅
Compass	read_compass · write_compass	✅ (เท่านั้น)	—

เงื่อนไขเฉพาะผลิตภัณฑ์:

• delete_jira และ manage_jira ถูก ปิดใช้งานตามค่าเริ่มต้น และต้องเปิดใช้งานโดยผู้ดูแลระบบก่อนจึงจะใช้งานได้
• เครื่องมือ Bitbucket Cloud จะพร้อมใช้งานก็ต่อเมื่อ Bitbucket workspace ของคุณเชื่อมโยงกับองค์กรแล้วเท่านั้น Workspace ที่ไม่ได้เชื่อมโยงกับองค์กรจะไม่สามารถเลือกได้เมื่อทำการตรวจสอบสิทธิ์
• เครื่องมือ Jira Service Management รองรับการตรวจสอบสิทธิ์ผ่าน API token เท่านั้น และจะพร้อมใช้งานก็ต่อเมื่อผู้ดูแลระบบองค์กรเปิดใช้งานการตรวจสอบสิทธิ์ผ่าน API token แล้ว
• เครื่องมือ Loom จะพร้อมใช้งานสำหรับ Loom workspace ที่เชื่อมโยงกับ Atlassian site เท่านั้น
• เครื่องมือ Teamwork Graph สามารถดึงข้อมูลจากบริการของบุคคลที่สามที่เชื่อมต่อกับ Jira เช่น pull requests, builds และ deployments ที่เชื่อมโยงไว้ สำหรับ GitHub for Atlassian การเข้าถึงแบบเต็มรูปแบบ หมายความว่าเครื่องมือจะดึงข้อมูล GitHub ตามสิทธิ์ของผู้ใช้ใน GitHub ในขณะที่ การเข้าถึงแบบจำกัด หมายความว่าเครื่องมือจะดึงข้อมูลตามสิทธิ์ของผู้ใช้ใน Jira ตัวเชื่อมต่อ Azure DevOps, GitLab, Jenkins และ Spinnaker เป็นไปตามรูปแบบการเข้าถึงแบบจำกัด

[!NOTE] สำหรับข้อมูลอ้างอิงเครื่องมือที่สมบูรณ์และเป็นปัจจุบัน รวมถึงขอบเขตที่จำเป็นสำหรับแต่ละกลุ่มสิทธิ์ โปรดดู เครื่องมือที่รองรับ

---

วิธีที่เซิร์ฟเวอร์เปิดเผยเครื่องมือ

แทนที่จะส่งคำจำกัดความของเครื่องมือทั้งหมดไปยัง AI client ในเวลาที่เชื่อมต่อ Atlassian MCP Server จะเปิดเผยชุดเครื่องมือที่ใช้งานบ่อยที่สุดจำนวนเล็กน้อย และให้ client ค้นพบส่วนที่เหลือได้ตามต้องการ เครื่องมือที่ทำเครื่องหมายเป็น Primary จะมองเห็นได้โดยตรงกับ agents

สิ่งนี้มีประโยชน์สองประการ:

• Context ของ client ของคุณจะว่างสำหรับงานที่ทำอยู่ แทนที่จะเต็มไปด้วยคำจำกัดความของเครื่องมือ
• เครื่องมือใหม่จะพร้อมใช้งานโดยไม่ต้องให้ client เชื่อมต่อใหม่

MCP gateways

หากคุณใช้ MCP gateway หรือต้องการให้มีเครื่องมือทั้งหมดพร้อมใช้งานล่วงหน้าแทนที่จะใช้วิธีการค้นหาและดำเนินการ ให้ใช้การแทนที่ tools=all เพื่อเปิดเผยเครื่องมือทั้งหมดเป็นรายการเครื่องมือแบบแบนแบบแบ่งหน้า:

https://mcp.atlassian.com/v2/mcp?tools=all

---

ก่อนเริ่มต้น

ตรวจสอบว่าสภาพแวดล้อมของคุณตรงตามข้อกำหนดเหล่านี้ก่อนตั้งค่าเซิร์ฟเวอร์

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

ข้อกำหนดขึ้นอยู่กับวิธีที่คุณเชื่อมต่อ:

สำหรับ client ที่รองรับ

• Atlassian Cloud site ที่มีผลิตภัณฑ์อย่างน้อยหนึ่งรายการจาก Jira, Confluence, Jira Service Management, Bitbucket หรือ Compass
• การเข้าถึง client ที่เลือก
• เบราว์เซอร์ที่ทันสมัยเพื่อทำขั้นตอนการอนุญาต OAuth 2.1 ให้สมบูรณ์ หรือข้อมูลประจำตัว API token สำหรับการตรวจสอบสิทธิ์แบบ headless

หากผู้ดูแลระบบองค์กรของคุณปิดใช้งานการตรวจสอบสิทธิ์ผ่าน API token MCP clients จะไม่สามารถเชื่อมต่อด้วย token ได้ และจำเป็นต้องใช้ OAuth 2.1 แทน

สำหรับ IDEs หรือ client ในเครื่อง (การตั้งค่าบนเดสก์ท็อป)

• Atlassian Cloud site ที่มีผลิตภัณฑ์ที่รองรับอย่างน้อยหนึ่งรายการ
• IDE ที่รองรับ (เช่น Claude Desktop, VS Code หรือ Cursor) หรือ client ที่เข้ากันได้กับ MCP แบบกำหนดเอง
• ติดตั้ง Node.js v18+ เพื่อเรียกใช้ MCP proxy ในเครื่อง (mcp-remote)
• เบราว์เซอร์ที่ทันสมัยสำหรับการเข้าสู่ระบบ OAuth หรือข้อมูลประจำตัว API token สำหรับการตรวจสอบสิทธิ์แบบ headless

---

ข้อมูลและความปลอดภัย

เซิร์ฟเวอร์บังคับใช้การควบคุมความปลอดภัยหลายประการ:

• การรับส่งข้อมูลทั้งหมดถูกเข้ารหัสระหว่างการส่งผ่าน HTTPS (TLS 1.2 หรือใหม่กว่า) ตาม แนวปฏิบัติด้านความปลอดภัยของ Atlassian
• การตรวจสอบสิทธิ์ OAuth 2.1 และ API token ให้การควบคุมการเข้าถึงที่ปลอดภัย
• การเข้าถึงข้อมูลเคารพสิทธิ์ของผู้ใช้ในทุกผลิตภัณฑ์ Atlassian ที่เชื่อมต่อ รวมถึง Jira, Confluence, Jira Service Management, Bitbucket, Compass และ Loom
• หากองค์กรของคุณใช้ IP allowlisting สำหรับผลิตภัณฑ์ Atlassian Cloud การเรียกใช้เครื่องมือผ่าน Atlassian MCP Server จะปฏิบัติตามกฎ IP เหล่านั้นด้วย

สำหรับภาพรวมเชิงลึกเพิ่มเติมเกี่ยวกับโมเดลความปลอดภัยและการควบคุมของผู้ดูแลระบบ โปรดดู:

• ทำความเข้าใจ Atlassian MCP Server
• ควบคุมการตั้งค่า Atlassian MCP Server

---

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

สถาปัตยกรรมและการสื่อสาร

1. client ที่รองรับเชื่อมต่อกับ endpoint ของเซิร์ฟเวอร์ endpoint ที่แนะนำสำหรับ client ทั้งหมดคือ:

   https://mcp.atlassian.com/v2/mcp
   

   endpoint v1 (https://mcp.atlassian.com/v1/mcp/authv2 และ https://mcp.atlassian.com/v1/mcp) ยังคงรองรับ และการเชื่อมต่อ v1 ที่มีอยู่จะเริ่มเปิดเผยและใช้เครื่องมือ v2 โดยอัตโนมัติ

2. ขึ้นอยู่กับการตั้งค่าของคุณ ขั้นตอน OAuth 2.1 ที่ปลอดภัยผ่านเบราว์เซอร์จะถูกเรียกใช้ หรือใช้การตรวจสอบสิทธิ์ผ่าน API token

3. เมื่อได้รับอนุญาตแล้ว client จะสตรีมข้อมูลตามบริบทและรับการตอบสนองแบบเรียลไทม์จากผลิตภัณฑ์ Atlassian ที่เชื่อมต่อของคุณ

[!WARNING] หลังจากวันที่ 30 มิถุนายน 2026 endpoint Server-Sent Events แบบเดิม (https://mcp.atlassian.com/v1/sse) จะไม่ได้รับการสนับสนุนอีกต่อไป อัปเดต client แบบกำหนดเองใดๆ ที่กำหนดค่าให้ใช้ /sse เพื่อให้ชี้ไปที่ /mcp — โดยควรเป็น https://mcp.atlassian.com/v2/mcp

[!NOTE] client ที่ไม่สามารถทำการตรวจสอบสิทธิ์ให้สมบูรณ์หลังจากการย้ายไปยังเครื่องมือ v2 อาจจำเป็นต้องล้าง cache ของ client IDs หรือข้อมูลประจำตัว .well-known

การจัดการสิทธิ์

การเข้าถึงจะได้รับเฉพาะข้อมูลที่ผู้ใช้มีสิทธิ์ดูอยู่แล้วใน Atlassian Cloud การดำเนินการทั้งหมดเคารพบทบาทระดับโปรเจกต์หรือพื้นที่ที่มีอยู่ การตรวจสอบสิทธิ์ OAuth และ API token ต่างก็ให้เกียรติขอบเขตที่กำหนดค่าไว้และสิทธิ์ของ Atlassian

การตรวจสอบสิทธิ์ผ่าน API token (headless)

การตรวจสอบสิทธิ์ผ่าน API token พร้อมใช้งานสำหรับการตั้งค่า client แบบ headless แบบบริการ หรือแบบไม่โต้ตอบ (เช่น ระบบแบ็กเอนด์หรือระบบอัตโนมัติ) และยัง จำเป็น สำหรับเครื่องมือ Jira Service Management

มีสองกลไกที่รองรับ:

กลไก	Header
Personal API token (Basic auth)	Authorization: Basic <base64(email:api_token)>
Service account API key (Bearer token)	Authorization: Bearer <api_key>

• ต้องเปิดใช้งานโดยผู้ดูแลระบบ: ผู้ดูแลระบบองค์กรต้องเปิดใช้งานการตรวจสอบสิทธิ์ผ่าน API token สำหรับ Atlassian MCP Server (Atlassian Administration → Rovo → Rovo MCP server → Authentication)
• ต้องใช้ token ที่มีขอบเขต: สร้าง personal API token หรือขอ service account API key จากผู้ดูแลระบบของคุณ โดยมีขอบเขตที่จำเป็นสำหรับเครื่องมือและข้อมูลที่คุณต้องการเข้าถึง
• คู่มือการกำหนดค่า: กำหนดค่าการตรวจสอบสิทธิ์ผ่าน API token
• เอกสารอ้างอิงการตั้งค่าสำหรับผู้ดูแลระบบ: ควบคุมการตั้งค่า Atlassian MCP Server: กำหนดค่าการตรวจสอบสิทธิ์

---

เวิร์กโฟลว์ตัวอย่าง

เมื่อเชื่อมต่อแล้ว คุณสามารถรันงานเช่นนี้จาก client ของคุณได้

เวิร์กโฟลว์ Jira

• ค้นหา: "ค้นหาบั๊กที่เปิดอยู่ทั้งหมดใน Project Alpha"
• สร้าง/อัปเดต: "สร้างเรื่องที่มีชื่อว่า 'Redesign onboarding'"
• สร้างจำนวนมาก: "สร้าง Jira issues ห้ารายการจากบันทึกเหล่านี้"

เวิร์กโฟลว์ Confluence

• สรุป: "สรุปหน้า Q2 planning"
• สร้าง: "สร้างหน้าที่มีชื่อว่า 'Team Goals Q3'"
• นำทาง: "ฉันเข้าถึงพื้นที่ใดบ้าง"

เวิร์กโฟลว์ Compass

• สร้าง: "สร้าง service component ตาม repository ปัจจุบัน"
• สร้างจำนวนมาก: "นำเข้า components และ custom fields จาก CSV/JSON นี้"
• สอบถาม: "อะไรที่ขึ้นอยู่กับบริการ api-gateway"

เวิร์กโฟลว์ Loom

• ดึงข้อมูล: "ค้นหาการบันทึก Loom ของการรีวิวการออกแบบเมื่อสัปดาห์ที่แล้ว"
• สรุป: "สรุปวิดีโอแนะนำ Loom นี้และแสดงรายการ action items"

เวิร์กโฟลว์ Projects และ Goals

• สถานะ: "สถานะปัจจุบันของโปรเจกต์ Checkout Revamp คืออะไร"
• สรุปรวม: "เป้าหมายใดบ้างที่เสี่ยงในไตรมาสนี้ และเพราะเหตุใด"

งานรวม

• เชื่อมโยงเนื้อหา: "เชื่อมโยง Jira work items สามรายการนี้กับหน้า 'Release Plan'"
• ค้นหาเอกสาร: "ดึงหน้าเอกสาร Confluence ที่เชื่อมโยงกับ Compass component นี้"
• ขับเคลื่อนงานไปข้างหน้า: "ย้าย PROJ-456 ไปที่ 'In Review' และเพิ่มความคิดเห็นว่า PR พร้อมแล้ว"

[!NOTE] ความสามารถจริงอาจแตกต่างกันไปขึ้นอยู่กับระดับสิทธิ์ของคุณและแพลตฟอร์ม client

---

เคล็ดลับและเทคนิค

ตั้งค่า CloudId, Jira project และ Confluence space เริ่มต้น

อัปเดต AGENTS.md ของคุณด้วย Markdown ด้านล่างเพื่อลดการเรียกใช้เครื่องมือค้นหา ประหยัดเวลาและ tokens และตั้งค่าผลการค้นหาสูงสุด

## Atlassian MCP

When connected to atlassian-rovo-mcp:
- **MUST** use Jira project key = YOURPROJ
- **MUST** use Confluence spaceId = "123456"
- **MUST** use cloudId = "https://yoursite.atlassian.net" (do NOT call getAccessibleAtlassianResources)
- **MUST** use `maxResults: 10` or `limit: 10` for ALL Jira JQL and Confluence CQL search operations.

ใช้ skills

หากคุณใช้ client บนเดสก์ท็อปเช่น Claude คุณสามารถสร้างหรือใช้ skills ซ้ำสำหรับงานที่ทำซ้ำได้ ดู Atlassian MCP skills เริ่มต้น

สำหรับ Cursor skills เป็นส่วนหนึ่งของปลั๊กอิน marketplace

---

หมายเหตุสำหรับผู้ดูแลระบบ: การจัดการการเข้าถึง

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

• ทำความเข้าใจ Atlassian MCP Server
• ควบคุมการตั้งค่า Atlassian MCP Server
• จัดการ Atlassian MCP Server
• ตรวจสอบกิจกรรม Atlassian MCP Server

จัดการ ตรวจสอบ และเพิกถอนการเข้าถึง

• การควบคุมของผู้ดูแลระบบ: ผู้ดูแลระบบ site และองค์กรสามารถจัดการ ตรวจสอบ หรือเพิกถอนการเข้าถึงของแอป MCP ได้จาก จัดการแอป Marketplace และแอปของบุคคลที่สามขององค์กรของคุณ
• การควบคุมโดเมน: ใช้หน้าการตั้งค่า Rovo MCP server ใน Atlassian Administration เพื่อควบคุมว่าเครื่องมือ AI ภายนอกและโดเมนใดบ้างที่ได้รับอนุญาตให้เชื่อมต่อ โดยค่าเริ่มต้น โดเมนที่ Atlassian รองรับจะได้รับอนุญาต คุณสามารถเพิ่มโดเมนที่เชื่อถือได้หรือบล็อกโดเมนที่รองรับได้ การควบคุมโดเมนใช้กับการเชื่อมต่อ OAuth 2.1 สำหรับรายละเอียด โปรดดู โดเมน Atlassian MCP server ที่พร้อมใช้งาน
• การควบคุม IP: หากองค์กรของคุณใช้ IP allowlisting สำหรับแอป Atlassian Cloud คำขอที่ทำผ่าน Atlassian MCP Server ต้องมาจากที่อยู่ IP ที่ได้รับอนุญาตโดย IP allowlist ขององค์กรของคุณสำหรับแอปที่เกี่ยวข้อง สำหรับรายละเอียดการกำหนดค่า โปรดดู ระบุที่อยู่ IP สำหรับการเข้าถึงผลิตภัณฑ์ การจำกัด IP ของ Bitbucket Cloud ถูกกำหนดค่าแยกต่างหากโดยผู้ดูแลระบบ workspace ภายใต้ Workspace settings → Access controls ดู ควบคุมการเข้าถึงเนื้อหาส่วนตัวใน workspace
• การควบคุมผู้ใช้ปลายทาง: ผู้ใช้แต่ละรายสามารถเพิกถอนการอนุญาตแอปของตนเองได้จากการตั้งค่าโปรไฟล์
• บันทึกการตรวจสอบ: ทุกครั้งที่มีการใช้เครื่องมือผ่าน Atlassian MCP Server เหตุการณ์จะถูกบันทึกในบันทึกการตรวจสอบขององค์กรของคุณ ผู้ดูแลระบบสามารถตรวจสอบได้ใน Atlassian Administration ภายใต้ Insights → Audit log (กรองสำหรับ Rovo MCP User Actions หรือค้นหา MCP) สำหรับข้อมูลเพิ่มเติม โปรดดู ตรวจสอบกิจกรรม Atlassian MCP server

การแก้ไขปัญหาทั่วไป

• "คุณไม่มีสิทธิ์เชื่อมต่อจากที่อยู่ IP นี้ โปรดขอให้ผู้ดูแลระบบของคุณให้การเข้าถึง" โดยปกติแล้วสิ่งนี้บ่งชี้ว่าเปิดใช้งาน IP allowlisting และที่อยู่ IP ต้นทางของคำขอไม่ได้รับอนุญาตให้เข้าถึงแอปที่เกี่ยวข้องผ่าน Atlassian MCP Server ขอให้ผู้ดูแลระบบ site องค์กร หรือ Bitbucket workspace ของคุณตรวจสอบ IP allowlist ที่เกี่ยวข้อง

  AI clients ที่โฮสต์สามารถส่งคำขอจากที่อยู่ IP ขาออกของผู้ให้บริการ AI แทนเครือข่ายองค์กรหรือ VPN ของผู้ใช้ การอยู่ใน VPN ที่ได้รับอนุญาตอาจไม่เพียงพอ ขอให้ผู้ดูแลระบบของคุณตรวจสอบช่วง IP ขาออกที่เผยแพร่ของผู้ให้บริการและอนุมัติการเข้าถึงที่จำเป็น สำหรับตัวเชื่อมต่อที่โฮสต์โดย OpenAI โปรดดู คำแนะนำ IP egress ของ OpenAI การเชื่อมต่อ MCP ในเครื่องสามารถใช้ที่อยู่ IP ขาออกของเครือข่ายท้องถิ่นได้ ดู วิธีที่ IP allowlisting ทำงานกับ Atlassian MCP

• การเข้าสู่ระบบ OAuth สำเร็จ แต่การเรียกใช้เครื่องมือส่งคืน 403 การเข้าสู่ระบบที่สำเร็จไม่ได้รับประกันว่าการเรียกใช้เครื่องมือจะผ่านการจำกัด IP 403 ยังสามารถบ่งชี้ถึงขอบเขตไม่เพียงพอ สิทธิ์แอป หรือนโยบายการเข้าถึงอื่นๆ ยืนยันเหตุผลการปฏิเสธก่อนเปลี่ยน IP allowlist

---

ความปลอดภัย

Model Context Protocol (MCP) ช่วยให้ AI agents เชื่อมต่อกับเครื่องมือและข้อมูล Atlassian โดยใช้สิทธิ์ของบัญชีของคุณ ซึ่งสร้างเวิร์กโฟลว์ที่มีประสิทธิภาพ แต่ก็มีความเสี่ยงเชิงโครงสร้างเช่นกัน MCP client หรือเซิร์ฟเวอร์ใดๆ ที่คุณเปิดใช้งาน (เช่น ปลั๊กอิน IDE แอปเดสก์ท็อป MCP servers ที่โฮสต์ หรือการผสานรวมแบบ "คลิกเดียว") อาจทำให้ AI agent ดำเนินการในนามของคุณได้

Large language models (LLMs) มีความเสี่ยงต่อ prompt injection และการโจมตีที่เกี่ยวข้อง (เช่น indirect prompt injection และ tool poisoning) การโจมตีเหล่านี้สามารถสั่งให้ agent ขโมยข้อมูลหรือทำการเปลี่ยนแปลงที่ไม่ตั้งใจโดยไม่มีการร้องขออย่างชัดเจน เพื่อลดความเสี่ยง ให้ใช้เฉพาะ MCP ไคลเอนต์และเซิร์ฟเวอร์ที่เชื่อถือได้ ตรวจสอบอย่างรอบคอบว่าเครื่องมือและข้อมูลใดที่เอเจนต์แต่ละตัวเข้าถึงได้ และใช้หลักการสิทธิ์น้อยที่สุด (โทเค็นที่จำกัดขอบเขต การเข้าถึงโปรเจกต์/เวิร์กสเปซขั้นต่ำ) สำหรับการดำเนินการที่มีผลกระทบสูงหรือทำลายล้าง ต้องให้มนุษย์ยืนยันและตรวจสอบบันทึกการตรวจสอบสำหรับกิจกรรมที่ผิดปกติ เราขอแนะนำอย่างยิ่งให้ตรวจสอบคำแนะนำของ Atlassian เกี่ยวกับความเสี่ยงของ MCP ที่ MCP Clients: Understanding the potential security risks

---

การสนับสนุนและข้อเสนอแนะ

เราใช้ข้อเสนอแนะของคุณเพื่อปรับปรุง Atlassian MCP Server หากคุณพบข้อบกพร่องหรือข้อจำกัด หรือมีข้อเสนอแนะ:

• เยี่ยมชม Atlassian Support Portal เพื่อรายงานปัญหาและคำขอคุณสมบัติ
• แบ่งปันประสบการณ์และคำถามของคุณบน Atlassian Community และคำถามที่เกี่ยวข้องกับนักพัฒนาบน Atlassian Developer Community
• ไปที่ Ecosystem Developer Portal หากคุณกำลังสร้างแอปและพบข้อบกพร่องหรือปัญหา หรือมีข้อเสนอแนะ

---

ข้อจำกัดความรับผิดชอบ

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

เรียนรู้เพิ่มเติม: MCP Clients: Understanding the potential security risks