MCP Server เป็นช่องทางมาตรฐานที่ช่วยให้ไคลเอนต์ AI เรียกใช้ความสามารถด้าน Observability ของ TrueWatch ได้ แทนที่จะให้วิศวกรเขียนคิวรี DQL ด้วยมือทุกครั้ง เปิดแดชบอร์ดทีละหน้า หรือสลับไปมาระหว่างหน้าจอมอนิเตอริ่ง ไคลเอนต์ AI สามารถร้องขอการเข้าถึงเครื่องมือแบบมีโครงสร้าง เช่น การค้นหามอนิเตอร์ การค้นหาล็อก การค้นหาแดชบอร์ด และการรันคิวรี DQL
MCP เพียงอย่างเดียวไม่ได้ทำให้เป็นเอเจนต์ปฏิบัติการระดับองค์กรที่พร้อมใช้งาน MCP แก้ปัญหาในชั้นอินเทอร์เฟซ นั่นคือไคลเอนต์ AI เข้าถึงเครื่องมือและข้อมูลที่ถูกต้องได้หรือไม่ ส่วนความพร้อมใช้งานจริงบนโปรดักชันยังขึ้นอยู่กับสิทธิ์การเข้าถึง ขั้นตอนการอนุมัติ ร่องรอยการตรวจสอบ (audit trail) การเก็บรักษาหลักฐาน และขอบเขตที่ชัดเจนว่าเอเจนต์ได้รับอนุญาตให้ทำอะไรบ้าง
คู่มือนี้อธิบายขั้นตอนการเชื่อมต่อ TrueWatch MCP Server กับไคลเอนต์ AI โดยใช้ Cherry Studio เป็นตัวอย่าง (ขั้นตอนเดียวกันใช้ได้กับ Claude Code, Cursor และไคลเอนต์อื่นที่รองรับ MCP)
MCP คืออะไร
Model Context Protocol (MCP) คือโปรโตคอลแบบเปิดสำหรับเชื่อมต่อแอปพลิเคชัน AI เข้ากับระบบภายนอก เอกสารทางการของ MCP อธิบายว่าเป็นวิธีมาตรฐานที่ช่วยให้แอปพลิเคชัน AI เข้าถึงแหล่งข้อมูล เครื่องมือ และเวิร์กโฟลว์ผ่านอินเทอร์เฟซร่วมกัน
ในทางปฏิบัติ MCP เปิดให้ใช้ความสามารถสี่ประเภท:
- Tools — ฟังก์ชันที่ไคลเอนต์ AI เรียกใช้ได้
- Resources — ข้อมูลหรือบริบทที่ไคลเอนต์อ่านได้
- Prompts — เวิร์กโฟลว์ที่ใช้เป็นแนวทางสำหรับงานที่ทำซ้ำได้
- Transports — ชั้นการสื่อสารระหว่างไคลเอนต์และเซิร์ฟเวอร์
สำหรับงาน Observability รูปแบบนี้สำคัญ เพราะคำถามบนโปรดักชันแทบไม่เคยอยู่ในข้อมูลฝึกสอนของโมเดล ผู้ช่วย AI จึงต้องเข้าถึงเทเลเมทรีล่าสุด ได้แก่ ล็อก เมทริก เทรซ การแจ้งเตือน แดชบอร์ด มอนิเตอร์ บริบทของเซอร์วิส และผลลัพธ์ของคิวรี
TrueWatch MCP Server มีอะไรให้บ้าง
MCP server คือคอมโพเนนต์ที่เปิดเผยเครื่องมือ ทรัพยากร และพรอมต์ของระบบผ่าน Model Context Protocol เพื่อให้ไคลเอนต์ AI ที่รองรับ MCP เรียกใช้ได้โดยตรง นี่คือความหมายของ "MCP server" ในทางปฏิบัติ
TrueWatch MCP Server เปิดให้ใช้ความสามารถที่เลือกไว้ของ TrueWatch ผ่านอินเทอร์เฟซที่รองรับ MCP ไคลเอนต์ AI ใดก็ตามที่เชื่อมต่อกับ MCP server และยืนยันตัวตนด้วย API key ได้ก็สามารถใช้งานได้ ขึ้นอยู่กับเครื่องมือและสิทธิ์ที่เปิดใช้ ไคลเอนต์ AI สามารถใช้ TrueWatch MCP Server เพื่อทำงานกับ:
- ข้อมูลมอนิเตอร์และการแจ้งเตือน
- การค้นหาล็อก
- การค้นหาแดชบอร์ด
- การรันคิวรี DQL
- การค้นหาข้อมูล Observability
- การเข้าถึงข้อมูลภายในขอบเขตเวิร์กสเปซ
ขอบเขตคือประเด็นสำคัญของการออกแบบ ทุกคำขอต้องผ่านการยืนยันตัวตนและผูกกับเวิร์กสเปซ การเชื่อมต่อ MCP ไม่ได้ให้ไคลเอนต์ AI เข้าถึงข้อมูลบนโปรดักชันได้อย่างไร้ข้อจำกัด การเข้าถึงถูกจำกัดตามสิทธิ์ของ API key
ก่อนเริ่มต้น
เตรียมสิ่งต่อไปนี้:
- ไคลเอนต์ AI ที่รองรับการเชื่อมต่อ MCP server (คู่มือนี้ใช้ Cherry Studio)
- API key ของ TrueWatch ที่จำกัดสิทธิ์ขั้นต่ำเท่าที่งานต้องการ
- Endpoint หรือ site key ของ TrueWatch ที่ถูกต้องสำหรับเวิร์กสเปซของคุณ
- การเข้าถึงเครือข่ายจากไคลเอนต์ MCP ไปยัง endpoint ของ TrueWatch MCP
- การตัดสินใจภายในองค์กรว่าไคลเอนต์ AI ได้รับอนุญาตให้เรียกใช้เครื่องมือใดบ้าง
สำหรับการใช้งานบนโปรดักชัน ให้เริ่มจากแบบอ่านอย่างเดียว ปล่อยให้ไคลเอนต์คิวรีและสรุปข้อมูล Observability ก่อน แล้วค่อยอนุญาตเวิร์กโฟลว์ที่มีผลข้างเคียง
เชื่อมต่อผ่าน Cherry Studio
บทความต้นฉบับใช้ Cherry Studio เป็นไคลเอนต์ MCP ตัวอย่าง หน้าจออาจเปลี่ยนแปลงได้ แต่ขั้นตอนการตั้งค่าโดยทั่วไปเหมือนกัน คือ ติดตั้งไคลเอนต์ สร้างการเชื่อมต่อ MCP server เพิ่ม URL และ header เปิดใช้งานเซิร์ฟเวอร์ และตรวจสอบว่าผู้ช่วย AI มองเห็นเครื่องมือ
1. ติดตั้ง Cherry Studio
ดาวน์โหลดและติดตั้งไคลเอนต์ Cherry Studio ที่รองรับ MCP สำหรับระบบปฏิบัติการของคุณ
2. เปิดการตั้งค่า MCP
เปิด Cherry Studio ไปที่การตั้งค่า เลือกส่วน MCP แล้วเพิ่ม MCP server ใหม่
หากบริการ MCP เริ่มทำงานไม่ได้ ให้ตรวจสอบว่าติดตั้งรันไทม์ภายในเครื่องที่จำเป็นแล้วหรือไม่ บันทึกการตั้งค่าต้นฉบับระบุว่า UV และ Bun อาจเป็นข้อกำหนดเบื้องต้น
3. สร้างรายการ MCP Server
ตั้งชื่อเซิร์ฟเวอร์ให้ชัดเจน เช่น TrueWatch MCP Server และเลือกประเภทการเชื่อมต่อที่เหมาะสม ในการตั้งค่าต้นฉบับ ประเภทที่เลือกคือ streamableHttp
4. กำหนดค่า URL และ Header
ใช้ URL ของ TrueWatch MCP Server ที่ระบุไว้ในเวิร์กสเปซหรือเอกสารของคุณ
https://docs.truewatch.com/owl/mcp-quickstart/เพิ่ม request header สำหรับการยืนยันตัวตนและการเลือก endpoint ชื่อ header ที่ถูกต้องควรเป็นไปตามเอกสาร TrueWatch ฉบับปัจจุบัน โดยทั่วไปจะใช้ API key ร่วมกับ endpoint หรือ site key:
Authorization=<TRUEWATCH_API_KEY>;Endpoint=<TRUEWATCH_SITE_KEY>บทความต้นฉบับใช้โมเดลที่อิงตาม API key ซึ่งแต่ละคำขอจะถูกจำกัดขอบเขตตามเวิร์กสเปซที่เชื่อมโยงกับ API key นั้น ในเอกสารสำหรับการใช้งานจริงฉบับภาษาอังกฤษ ควรหลีกเลี่ยงการวาง API key จริงลงในภาพหน้าจอ ไคลเอนต์แชต หรือไฟล์คอนฟิกที่ใช้ร่วมกัน
ตัวอย่างการแมป endpoint:
const SITE_KEY_MAP = { us1: 'https://us1-openapi.truewatch.com',
eu1: 'https://eu1-openapi.truewatch.com',
ap1: 'https://ap1-openapi.truewatch.com',};
5. เปิดใช้งาน MCP Server
หลังจากกำหนดค่า URL และ header แล้ว ให้เปิดใช้งานการเชื่อมต่อ MCP server
6. เลือก MCP Server ในแชตหรือผู้ช่วย
กลับไปที่เวิร์กสเปซหลักใน Cherry Studio ในหัวข้อสนทนาหรือผู้ช่วย ให้เลือก MCP server ที่เพิ่งสร้าง
7. ตรวจสอบการเชื่อมต่อ
ถามผู้ช่วยด้วยคำถามด้าน Observability ง่าย ๆ ที่ต้องมีการเรียกใช้เครื่องมือของ TrueWatch เริ่มจากคำขอแบบอ่านอย่างเดียวที่มีความเสี่ยงต่ำ เช่น:
Show me the available TrueWatch MCP tools for this workspace.จากนั้นทดสอบคิวรีที่จำกัดขอบเขต:
Find recent critical alerts in the current workspace and summarize the affected services.เป้าหมายของการตรวจสอบไม่ใช่แค่ "ไคลเอนต์ตอบกลับ" แต่ต้องยืนยันว่าคำตอบมาจากการเรียกใช้เครื่องมือ ใช้เวิร์กสเปซที่คาดหวัง และไม่เปิดเผยข้อมูลนอกขอบเขตที่ตั้งใจไว้
หมายเหตุด้านความปลอดภัยและธรรมาภิบาล
MCP ทำให้การเข้าถึงเครื่องมือง่ายขึ้น ซึ่งทำให้ขอบเขตการเข้าถึงยิ่งสำคัญมากขึ้น ไม่ใช่น้อยลง สำหรับสภาพแวดล้อม Observability บนโปรดักชัน:
- ใช้ API key แบบอ่านอย่างเดียว เว้นแต่เวิร์กโฟลว์เฉพาะต้องการสิทธิ์มากกว่านั้น
- ให้ไคลเอนต์ AI หรือเอเจนต์แต่ละตัวมีคีย์ของตัวเอง แทนการใช้คีย์กว้างของทีมร่วมกัน
- จำกัดขอบเขตการเข้าถึง ตามเวิร์กสเปซ สภาพแวดล้อม เซอร์วิส หรือทีม เท่าที่ทำได้
- เก็บ API key ไว้นอกพรอมต์ ภาพหน้าจอ และเอกสารสาธารณะ
- บันทึกการเรียกใช้เครื่องมือ เพื่อให้ทบทวนการสืบสวนย้อนหลังได้
- ต้องได้รับการอนุมัติ สำหรับทุกการดำเนินการที่มีผลข้างเคียงต่อโปรดักชัน
- อย่าให้เอเจนต์เรียกใช้ทุกเครื่องมือเพียงเพราะมีเครื่องมือนั้นอยู่
นี่คือความแตกต่างเดียวกันที่ปรากฏตลอดสถาปัตยกรรม AI agent observability ที่กว้างขึ้นของ TrueWatch: CLI, MCP Server และ OpenAPI เป็นอินเทอร์เฟซของเครื่องมือ ส่วน Toby AI Agents เพิ่มระเบียบวิธีแก้ปัญหาเฉพาะด้าน Observability ธรรมาภิบาล ร่องรอยหลักฐาน ขั้นตอนการอนุมัติ และการตรวจสอบแบบวงจรปิดไว้ด้านบน
MCP เปลี่ยนอะไรสำหรับเวิร์กโฟลว์ Observability
สำหรับทีมวิศวกรรมและทีมปฏิบัติการ MCP ช่วยลดอุปสรรคระหว่างการสืบสวนด้วยภาษาธรรมชาติกับข้อมูลจริงบนโปรดักชัน มนุษย์สามารถถามได้ว่า:
Which services had the most error spikes in the last hour?ผู้ช่วยที่เชื่อมต่อ MCP จะแปลงคำถามนั้นเป็นการเรียกใช้เครื่องมือ ดึงข้อมูลล่าสุดจาก TrueWatch และส่งคืนสรุปพร้อมหลักฐาน วิศวกรยังคงเป็นผู้ตัดสินว่าผลลัพธ์ครบถ้วนหรือไม่ ต้องการบริบทเพิ่มเติมหรือไม่ และควรดำเนินการใดต่อไป
MCP ช่วยได้ในเรื่อง:
- ให้ไคลเอนต์ AI เข้าถึงข้อมูล Observability แบบสดได้ แทนที่จะพึ่งพาความรู้คงที่ของโมเดลเพียงอย่างเดียว
- กำหนดมาตรฐานวิธีเปิดเผยเครื่องมือในไคลเอนต์ AI ที่แตกต่างกัน
- ลดงานเชื่อมต่อเฉพาะกิจสำหรับทีมที่สร้างผู้ช่วยภายในองค์กร
- ทำให้ความสามารถด้าน Observability เป็นส่วนหนึ่งของเวิร์กโฟลว์วิศวกรรมในวงกว้าง
สิ่งที่ MCP เพียงอย่างเดียวยังไม่เพียงพอ:
- ไม่ได้กำหนดระเบียบวิธีจัดการเหตุการณ์ (incident) ของคุณ
- ไม่ได้สร้างสิทธิ์บนโปรดักชันที่ปลอดภัยให้โดยอัตโนมัติ
- ไม่ได้มาแทนการอนุมัติจากมนุษย์สำหรับการดำเนินการที่มีความเสี่ยงสูง
- ไม่ได้สอนเอเจนต์เรื่องแค็ตตาล็อกเซอร์วิส โมเดลความเป็นเจ้าของ หรือรันบุ๊กของคุณ
ใช้ MCP เป็นชั้นอินเทอร์เฟซ แล้วใช้ธรรมาภิบาลของแพลตฟอร์มและบริบทของโปรดักชันเพื่อทำให้เอเจนต์น่าเชื่อถือ
คำถามที่พบบ่อย
Q: MCP server คืออะไร และ TrueWatch MCP Server มีอะไรให้บ้าง
A: MCP server เปิดเผยเครื่องมือ ทรัพยากร และพรอมต์ของระบบผ่าน Model Context Protocol เพื่อให้ไคลเอนต์ AI ที่รองรับ MCP เรียกใช้ได้ด้วยสิทธิ์ที่เหมาะสม TrueWatch MCP Server นำรูปแบบนี้มาใช้กับ Observability ได้แก่ มอนิเตอร์ ล็อก แดชบอร์ด และคิวรี DQL เพื่อให้ไคลเอนต์ AI ที่รองรับ MCP เรียกใช้ได้ด้วย API key ที่จำกัดขอบเขต
Q: ไคลเอนต์ AI ตัวใดใช้งานกับ TrueWatch MCP Server ได้บ้าง
A: ไคลเอนต์ที่รองรับ MCP ทุกตัวใช้งานได้ รวมถึง Claude Code และ Cursor การเชื่อมต่อใช้ endpoint, header และประเภทการเชื่อมต่อ streamableHttp เดียวกัน ไม่ว่าจะใช้ไคลเอนต์ใด
Q: การเข้าถึงผ่าน MCP เป็นแบบอ่านอย่างเดียวหรือไม่
A: ขึ้นอยู่กับสิทธิ์ที่ผูกกับ API key TrueWatch แนะนำให้เริ่มจากคีย์แบบอ่านอย่างเดียว และขยายสิทธิ์ต่อเมื่อเวิร์กโฟลว์เฉพาะต้องการเท่านั้น
Q: MCP มาแทนขั้นตอนการอนุมัติได้หรือไม่
A: ไม่ได้ MCP เป็นอินเทอร์เฟซของเครื่องมือ ไม่ใช่ชั้นธรรมาภิบาล ขั้นตอนการอนุมัติ ร่องรอยการตรวจสอบ และการเก็บรักษาหลักฐานสำหรับการดำเนินการบนโปรดักชันมาจากสถาปัตยกรรมเอเจนต์โดยรอบ ซึ่งในกรณีของ TrueWatch คือ Toby AI Agents
Q: API key เดียวใช้ร่วมกับ AI agent หลายตัวได้หรือไม่
A: ทำได้ แต่ไม่แนะนำ การให้ไคลเอนต์ AI หรือเอเจนต์แต่ละตัวมีคีย์ของตัวเองช่วยให้จำกัดขอบเขต บันทึก และเพิกถอนการเข้าถึงได้อย่างอิสระ
ขั้นตอนถัดไป
เชื่อมต่อ TrueWatch API key แบบอ่านอย่างเดียวกับไคลเอนต์ที่รองรับ MCP ทดสอบคิวรี Observability ที่มีความเสี่ยงต่ำสองสามรายการ และตัดสินใจว่าเอเจนต์วิศวกรรมของคุณควรเข้าถึงเครื่องมือใดได้บ้าง
สำรวจเอกสาร TrueWatch MCP และเข้าร่วมรายชื่อรอ Toby AI Agents →
