สร้าง MCP Server ตัวแรก: ภาพรวมขั้นตอนสำหรับมือใหม่
ภาพรวม 6 ขั้นตอนตั้งแต่เลือกโจทย์ ออกแบบ Tool ทดสอบด้วย MCP Inspector จนต่อกับ Claude Desktop ได้ พร้อมจุดที่มือใหม่พลาดบ่อย
คุณเป็นนักพัฒนาหรือนักวิเคราะห์ข้อมูลที่เริ่มใช้ Claude หรือ ChatGPT ทุกวัน แล้วเกิดคำถามว่า "ถ้า AI ค้นคู่มือนโยบายบริษัทเราได้เองคงดี" คำตอบคือสร้าง MCP Server ของคุณเอง บทความนี้เป็นแผนที่ภาพรวม ให้คุณรู้ว่าต้องผ่านอะไรบ้างก่อนลงมือ
MCP Server คืออะไร
ตาม เอกสาร Server Concepts ของ MCP, Server คือโปรแกรมที่เปิดความสามารถให้แอป AI ผ่านอินเทอร์เฟซมาตรฐาน โดยเปิดได้ 3 แบบ คือ Tools (ฟังก์ชันที่โมเดลเรียกได้), Resources (ข้อมูลสำหรับเป็นบริบท) และ Prompts (เทมเพลตคำสั่ง) สำหรับ Server ตัวแรก แนะนำให้โฟกัสที่ Tools ก่อน เหมือนคู่มือทางการที่สอนสร้าง Server พยากรณ์อากาศซึ่งมี tool แค่ 2 ตัว
ก่อนเริ่ม: ตัดสินใจ 2 เรื่อง
ภาษาและ SDK
คู่มือ Build an MCP server มีตัวอย่างทั้ง Python, TypeScript, Java, Kotlin และ C# เลือกภาษาที่ทีมถนัด เพราะ SDK จัดการรายละเอียดโปรโตคอลให้แล้ว คุณแค่เขียน logic ของเครื่องมือ
รันบนเครื่อง หรือบนอินเทอร์เน็ต
Server แบบ local ใช้ transport ชื่อ stdio รันบนเครื่องเดียวกับแอป AI เหมาะกับการเรียนรู้ ส่วน Server แบบ remote ใช้ Streamable HTTP ให้หลายคนใช้ร่วมกันได้ แต่ต้องคิดเรื่องการ login และความปลอดภัยเพิ่ม มือใหม่ควรเริ่มจาก local
6 ขั้นตอนภาพรวม
1. เลือกโจทย์ให้แคบ
เริ่มจากงานเดียวที่มีคุณค่าชัด เช่น "ค้นนโยบายบริษัทตามคำสำคัญ" ไม่ใช่ "ต่อทุกระบบของบริษัท"
2. ตั้งค่า environment และติดตั้ง SDK
สร้างโปรเจกต์ใหม่ ติดตั้ง SDK ของ MCP ตามภาษาที่เลือก และเตรียม API key หรือไฟล์ข้อมูลที่ Server ต้องใช้
3. ออกแบบ Tool ให้โมเดลเข้าใจ
แต่ละ tool มีชื่อ คำอธิบาย และ input schema โมเดลตัดสินใจจากคำอธิบายเป็นหลัก จึงควรเขียนให้ชัดว่า "ใช้เมื่อไหร่" และ input แต่ละช่องคืออะไร
4. เขียน logic และข้อความ error ที่มีประโยชน์
ข้างใน tool คือโค้ดปกติที่เรียก API หรืออ่านฐานข้อมูล ถ้าเกิดปัญหา ให้ตอบกลับเป็นข้อความที่บอกว่าผิดตรงไหน โมเดลจะปรับแล้วลองใหม่ได้
5. ระวังเรื่อง log
คู่มือทางการเตือนว่า Server แบบ stdio ห้ามเขียนอะไรลง stdout เพราะจะทำให้ข้อความ JSON-RPC เสียหาย ให้ส่ง log ไปที่ stderr หรือไฟล์แทน นี่คือสาเหตุอันดับต้นๆ ที่ทำให้ Server ตัวแรกของมือใหม่ใช้งานไม่ได้
6. ทดสอบ แล้วต่อกับแอป AI
ใช้ MCP Inspector ซึ่งเป็นเครื่องมือพัฒนาของโปรเจกต์ MCP เพื่อเรียกดูรายการ tool และลองเรียกทีละตัว เมื่อผ่านแล้ว เพิ่ม Server ลงไฟล์ตั้งค่าของ Claude Desktop แล้วรีสตาร์ตแอป
ตัวอย่าง: ผู้ช่วยค้นนโยบายของบริษัทไทย
ทีม HR มีนโยบายเป็นไฟล์ PDF หลายสิบไฟล์ คุณสร้าง Server ที่มี 2 tool คือ ค้นนโยบายตามคำสำคัญ และดึงเนื้อหานโยบายตามรหัส เมื่อพนักงานถามว่า "เบิกค่าเดินทางต่างจังหวัดได้เท่าไหร่" โมเดลเรียก tool ค้นหา เจอนโยบายที่เกี่ยวข้อง ดึงเนื้อหา แล้วสรุปให้ พร้อมบอกว่าอ้างอิงจากเอกสารไหน
ข้อควรระวัง
- Server รันด้วยสิทธิ์ของคุณ ถ้าให้อ่านโฟลเดอร์ทั้งเครื่อง มันก็อ่านได้ทั้งเครื่อง จำกัดขอบเขตตั้งแต่แรก
- ตรวจ input ทุกครั้ง สเปกกำหนดว่า Server ต้อง validate input, ควบคุมสิทธิ์, จำกัดอัตราการเรียก และกรอง output
- อย่าใส่ API key ในโค้ด เก็บไว้ใน environment variable
- เริ่มจาก read-only tool ที่เขียนหรือลบข้อมูลควรมาทีหลัง เมื่อมีขั้นยืนยันจากผู้ใช้แล้ว
- สเปกมีหลายเวอร์ชัน ใช้ SDK รุ่นล่าสุดและอ่านคู่มือเวอร์ชันปัจจุบันเสมอ
Server ตัวแรกที่ดี ไม่ได้ทำได้ทุกอย่าง แต่ทำงานเดียวได้แม่นและปลอดภัย
ทำอะไรต่อ
- เขียนโจทย์ 1 ประโยค และ tool ที่ต้องมีไม่เกิน 3 ตัว
- ทำตามคู่มือ Build an MCP server ของทางการให้จบ 1 รอบ เพื่อเข้าใจโครงสร้าง
- เปลี่ยนตัวอย่างพยากรณ์อากาศเป็นโจทย์ของคุณเอง
- ทดสอบด้วย MCP Inspector แล้วค่อยต่อกับ Claude Desktop
- ชวนเพื่อนร่วมทีมลองใช้ แล้วจดว่า AI เลือก tool ผิดตอนไหน เพื่อปรับคำอธิบาย
อยากลองต่อ MCP กับเครื่องมือจริงก่อนเขียนเอง ดูคอร์ส ลองใช้ MCP เชื่อม AI กับเครื่องมือจริง บน Plants.work Learn หรืออ่าน MCP ต่างจาก API อย่างไร เพื่อออกแบบ tool ให้ตรงงาน