SSD Nodes Learn Hosting plans →
คู่มือ Matt Connorโดย Matt Connor

เปรียบเทียบ Agent skills, MCP servers และ rules files

สรุปความแตกต่างของ Agent skills, MCP servers และ rules files สำหรับ coding agent เลือกใช้ให้เหมาะสมตามลักษณะข้อมูลเพื่อลดการใช้ tokens และประหยัดค่าใช้จ่ายในระยะยาว

ความแตกต่างระหว่าง Agent skills, MCP servers และ rules files: คำตอบโดยย่อ

Agent skills, MCP servers และ rules files ต่างก็เป็นการนำความรู้ไปใส่ไว้ให้ coding agent ใช้งาน ให้เลือกใช้โดยพิจารณาจากลักษณะของความรู้นั้นๆ MCP (model context protocol) เหมาะสำหรับข้อมูลที่อาจเปลี่ยนแปลงได้ทุกครั้งที่คุณเรียกดู ส่วน skill เหมาะสำหรับขั้นตอนการทำงานที่คุณสามารถเขียนบันทึกไว้ในวันนี้และยังคงถูกต้องแม้เวลาผ่านไป 6 สัปดาห์ สำหรับ rules file นั้นเหมาะสำหรับข้อเท็จจริงเพียงไม่กี่ประการที่ต้องยึดถือในทุกเซสชัน

การเลือกดังกล่าวมีต้นทุน และต้นทุนนั้นคือ context ทุก token ที่เสียไปกับคำสั่งที่ agent ไม่จำเป็นต้องใช้ คือ token ที่หายไปจากการอ่านโค้ด นอกจากนี้ยังเป็น token ที่คุณต้องจ่ายซ้ำในทุกรอบการสนทนา เนื่องจาก context window ทั้งหมดจะถูกส่งใหม่ในทุกคำขอ ดังนั้นคำถามที่มีประโยชน์จึงไม่ใช่กลไกใดที่ สามารถ ทำงานนี้ได้ (เพราะส่วนใหญ่ทำได้ทั้งสามอย่าง) แต่เป็นคำถามที่ว่ากลไกใดมีต้นทุนต่ำที่สุดในขณะที่ไม่ได้ถูกเรียกใช้งาน

ต้นทุนของแต่ละส่วนก่อนการใช้งาน

ทั้งสามส่วนโหลดข้อมูลในเวลาที่ต่างกัน และจังหวะเวลานี้คือความแตกต่างทั้งหมด

ไฟล์กฎแบบไม่มีเงื่อนไขจะโหลดขึ้นมาเมื่อเริ่มโปรแกรมในทุกเซสชัน ไม่ว่าจะเกี่ยวข้องหรือไม่ก็ตาม เว้นแต่จะถูกยกเว้นไว้ Claude Code จะอ่านไฟล์ startup CLAUDE.md ในช่วงเริ่มต้นของทุกการสนทนา โดยจะตัดคอมเมนต์ HTML ระดับบล็อกที่อยู่นอกบล็อกโค้ดออกก่อนที่จะแทรกเนื้อหา และจะข้ามไฟล์ที่มีขนาดเกิน 4 MiB ไป นอกจากนี้ claudeMdExcludes ยังสามารถใช้ยกเว้นไฟล์ได้ ยกเว้นไฟล์นโยบายที่มีการจัดการไว้ เป้าหมายที่แนะนำคือไม่เกิน 200 บรรทัดต่อไฟล์ เพราะไฟล์ที่ยาวกว่านั้นจะใช้ context มากขึ้น และ โมเดลจะปฏิบัติตามได้แม่นยำน้อยลง ผลกระทบทั้งสองอย่างนี้ส่งผลในทิศทางเดียวกัน ซึ่งเป็นเหตุผลว่าทำไมไฟล์กฎขนาด 900 บรรทัดจึงแย่ยิ่งกว่าไม่มีประโยชน์

ทักษะ (skill) จะโหลดในสองขั้นตอน ในช่วงเริ่มต้นจะมีเพียงบรรทัด description จาก frontmatter ของแต่ละ SKILL.md เท่านั้นที่เข้าสู่ context เพื่อให้โมเดลทราบว่ามีทักษะนี้อยู่และทราบโดยประมาณว่าควรใช้เมื่อใด ส่วนเนื้อหาหลักจะถูกโหลดเมื่อมีการเรียกใช้ทักษะ ดังนั้นเอกสารอ้างอิงขนาด 400 บรรทัดจึงแทบไม่มีต้นทุนจนกว่าจะถึงเวลาที่จำเป็นต้องใช้

เซิร์ฟเวอร์ MCP เคยเป็นส่วนที่มีต้นทุนสูง และนี่คือจุดที่ข้อมูลเปรียบเทียบส่วนใหญ่ที่คุณอ่านมานั้นล้าสมัยไปแล้ว ปัจจุบัน Claude Code เปิดใช้งานการค้นหาเครื่องมือ (tool search) เป็นค่าเริ่มต้น โดยจะมีเพียงชื่อเครื่องมือและฟิลด์คำสั่งของเซิร์ฟเวอร์เท่านั้นที่โหลดเมื่อเริ่มเซสชัน ส่วน JSON (JavaScript object notation) schema ฉบับเต็มจะถูกเลื่อนการโหลดออกไปจนกว่า Claude จะค้นหาเครื่องมือเหล่านั้น การเพิ่มเซิร์ฟเวอร์จึงไม่มีต้นทุนเป็นหลักพันโทเคนตั้งแต่ต้นอีกต่อไป อย่างไรก็ตาม มันยังคงมีต้นทุนอยู่ และจะมีต้นทุนเต็มจำนวนตั้งแต่ต้นหากตั้งค่าในรูปแบบที่ปิดการค้นหาเครื่องมือไว้

แผนภูมิStartup and post-use context cost, estimated tokens
ข้อมูลเบื้องหลังแผนภูมินี้
[
  {
    "label": "Rules file, 200 lines",
    "at_startup": "2,500",
    "after_use": "2,500"
  },
  {
    "label": "Skill, 12 KB body",
    "at_startup": 40,
    "after_use": "3,000"
  },
  {
    "label": "MCP server, tool search on",
    "at_startup": 500,
    "after_use": "3,200"
  },
  {
    "label": "MCP server, tool search off",
    "at_startup": "4,500",
    "after_use": "4,500"
  }
]

ตัวเลขเหล่านี้เป็นการประมาณการ ไม่ใช่การวัดผลจากเครื่องของคุณ โดยคำนวณจากขนาดของข้อความที่แต่ละกลไกโหลด โดยประมาณ 4 ตัวอักษรต่อ 1 โทเคน: ไฟล์กฎขนาด 200 บรรทัดมีขนาดประมาณ 10 KB ในรูปแบบ markdown, คำอธิบายทักษะมีขนาดประมาณ 160 ตัวอักษร และเซิร์ฟเวอร์ที่เปิดใช้งานเครื่องมือ 12 รายการจะมี schema ขนาดประมาณ 18 KB รวมกับบล็อกคำสั่งขนาด 2 KB โดย Claude Code จะตัดฟิลด์คำสั่งของเซิร์ฟเวอร์และคำอธิบายของแต่ละเครื่องมือที่โหลดตั้งแต่ต้นไว้ที่ 4,096 ตัวอักษรเป็นค่าเริ่มต้น และที่ 16,384 ตัวอักษรสำหรับคำอธิบายเครื่องมือที่โหลดผ่านการค้นหาเครื่องมือ ก่อนเวอร์ชัน v2.1.296 ขีดจำกัดที่สั้นกว่าคือ 2,048 ตัวอักษร และ CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH จะเข้ามาแทนที่ขีดจำกัดทั้งสองหากคุณตั้งค่าไว้ คำสั่งและคำอธิบายจากเซิร์ฟเวอร์ MCP บางตัวที่โฮสต์โดย Anthropic จะส่งถึง Claude ครบถ้วนแม้จะตั้งค่าตัวแปรนี้ไว้ ดังนั้นขีดจำกัดเหล่านี้จึงไม่ใช่เพดานสูงสุดแบบครอบจักรวาล ส่วนถัดไปจะแสดงวิธีอ่านตัวเลขจริงของคุณเอง

ให้อ่านสองแถวแรกควบคู่กัน ไฟล์กฎมีต้นทุน 2,500 โทเคนในเซสชันที่ไม่มีใครต้องการใช้มัน ทักษะมีต้นทุน 40 โทเคนในเซสชันเดียวกัน และ 3,000 ในเซสชันที่ 1 จาก 10 ที่มีการเรียกใช้ สองแถวสุดท้ายคือเซิร์ฟเวอร์เดียวกันโดยเปรียบเทียบระหว่างการเปิดและปิดการค้นหาเครื่องมือ: 500 โทเคนเทียบกับ 4,500 ช่องว่างนี้คือเหตุผลที่คำแนะนำเก่าๆ เกี่ยวกับปัญหา context บวมจาก MCP ยังคงถูกส่งต่อกันมา

ณ เดือนตุลาคม 2026 Claude Code ใช้การค้นหาเครื่องมือบน Claude Opus 4, Sonnet 4, Haiku 4.5 และรุ่นใหม่กว่า รวมถึงบน Opus 4.5, Sonnet 4.5, Haiku 4.5 และรุ่นใหม่กว่าบน Google Cloud's Agent Platform สำหรับรุ่นก่อนหน้านี้ และการใช้งานบน Microsoft Foundry ที่โฮสต์บน Azure เครื่องมือ MCP ทุกตัวจะโหลดตั้งแต่ต้นไม่ว่าคุณจะตั้งค่าอย่างไรก็ตาม เมื่อใช้ ANTHROPIC_BASE_URL ชี้ไปยัง LLM gateway การค้นหาเครื่องมือจะถูกเปิดใช้งานเป็นค่าเริ่มต้นตั้งแต่เวอร์ชัน v2.1.304 เป็นต้นมา เวอร์ชันที่เก่ากว่าจะปิดการใช้งานไว้เว้นแต่คุณจะเลือกเปิดเอง ตั้งแต่เวอร์ชัน v2.1.305 เป็นต้นไป Claude Code สามารถลองส่งคำขอไปยัง gateway ใหม่อีกครั้งโดยไม่ใช้การค้นหาเครื่องมือหลังจากเกิด 400 หรือ 422 โดยจะโหลดเครื่องมือทั้งหมดตั้งแต่ต้นเมื่อการลองใหม่นั้นสำเร็จ ให้ตั้งค่า ENABLE_TOOL_SEARCH เพื่อควบคุมการทำงานนี้: false จะโหลดทุก schema ตั้งแต่ต้น, true จะเลื่อนการโหลดออกไปโดยใช้การสำรองข้อมูลของโมเดลและการปรับใช้แบบเดียวกับการไม่ตั้งค่าใดๆ และ auto จะโหลดเครื่องมือตั้งแต่ต้นตราบใดที่คำจำกัดความทั้งหมดรวมกันไม่เกิน 10% ของ context window จากนั้นจะเปิดการค้นหาเครื่องมือค้างไว้เมื่อถึงเกณฑ์นั้นแม้ว่าขนาดรวมจะลดลงในภายหลังก็ตาม เซิร์ฟเวอร์ที่ตั้งค่าด้วย "alwaysLoad": true จะโหลดเครื่องมือตั้งแต่ต้นโดยไม่คำนึงถึง ENABLE_TOOL_SEARCH

# Load schemas up front only if they fit in 5% of the window
ENABLE_TOOL_SEARCH=auto:5 claude

คำถามตัดสินใจ: ข้อมูลมีการเปลี่ยนแปลงระหว่างการเรียกใช้งานหรือไม่?

ให้ถามคำถามนี้เป็นอันดับแรก เพราะจะช่วยตัดตัวเลือกที่ไม่ใช่ออกไปได้ทันที หากเอเจนต์จำเป็นต้องอ่านหรือเขียนสิ่งที่อาจเปลี่ยนแปลงได้ในครั้งถัดไปที่เรียกใช้ คุณจำเป็นต้องมีเซิร์ฟเวอร์ เช่น ระบบติดตามปัญหา (issue tracker), ฐานข้อมูล, แดชบอร์ดสำหรับตรวจสอบสถานะ หรือ API (application programming interface) ภายในของคุณเอง การจดบันทึกไว้ไม่ช่วยแก้ปัญหานี้ เพราะสิ่งที่คุณเขียนจะกลายเป็นข้อมูลเก่าทันทีที่มีคนอื่นแก้ไขบันทึกนั้น โค้ดเบสของคุณเองก็จัดอยู่ในรายการนี้เช่นกัน เนื่องจากโครงสร้างของมันเปลี่ยนแปลงไปตามทุก commit ซึ่งเป็นเหตุผลเบื้องหลังการ ส่งแผนผังที่ผ่านการวิเคราะห์ของ repository ให้เอเจนต์ผ่าน MCP แทนการอธิบายโครงสร้างในไฟล์ที่จะล้าสมัยไปตามกาลเวลา

หากคำตอบยังคงถูกต้องแม้เวลาผ่านไปหกสัปดาห์โดยไม่มีใครดูแล คุณควรใช้ทักษะ (skill) เช่น รายการตรวจสอบการปล่อยซอฟต์แวร์ (release checklist), ขั้นตอนการย้ายระบบ (migration procedure), รูปแบบการตอบกลับเมื่อเกิดข้อผิดพลาด หรือวิธีการเขียนทดสอบที่ repository นี้ต้องการ ทักษะคือไฟล์ที่อยู่ใน git มันไม่มีพอร์ต ไม่มีกระบวนการทำงาน (process) และไม่มีโหมดความล้มเหลวอื่นใดนอกจากการให้ข้อมูลที่ผิด ซึ่งสามารถตรวจสอบได้ผ่านการทำ code review

หากเป็นข้อเท็จจริงเพียงหนึ่งข้อที่ต้องนำไปใช้กับงานที่คุณยังไม่ได้คิดถึง ให้ใส่ไว้ในไฟล์กฎ (rules file) Run make lint before committing. Never push to main. Handlers live in src/api/handlers/. โดยให้มีเพียงบรรทัดเดียวต่อหนึ่งรายการ ทันทีที่รายการใดขยายตัวจนกลายเป็นขั้นตอนการทำงาน มันจะไม่ใช่ข้อเท็จจริงอีกต่อไป แต่จะกลายเป็นขั้นตอนปฏิบัติ (procedure) และควรย้ายไปอยู่ในรูปแบบของทักษะแทน

เมื่อไฟล์กฎเพียงพอแล้ว

ไฟล์กฎจะถูกโหลดจากหลายตำแหน่ง โดยเรียงลำดับจากกว้างที่สุดไปจนถึงเฉพาะเจาะจงที่สุด ได้แก่ ไฟล์นโยบายที่จัดการโดยระบบ, ~/.claude/CLAUDE.md ส่วนตัวของคุณ, ./CLAUDE.md หรือ ./.claude/CLAUDE.md ของโปรเจกต์ และ ./CLAUDE.local.md ที่ถูกละเว้นโดย git ไฟล์ทั้งหมดที่ค้นพบจะถูกนำมาต่อกันแทนที่จะเขียนทับกัน และไฟล์ที่อยู่ใกล้กับไดเรกทอรีทำงานของคุณมากที่สุดจะถูกอ่านเป็นลำดับสุดท้าย

ตั้งแต่เวอร์ชัน v2.1.277 เป็นต้นไป Claude Code จะอ่าน AGENTS.md ด้วย แต่โดยค่าเริ่มต้นจะอ่านก็ต่อเมื่อไม่มี CLAUDE.md, .claude/CLAUDE.md หรือ CLAUDE.local.md อยู่ในไดเรกทอรีทำงานของคุณหรือไดเรกทอรีที่อยู่เหนือขึ้นไป หาก repository ของคุณมีทั้งสองอย่าง Claude จะอ่านเฉพาะไฟล์ CLAUDE.md เท่านั้น ดังนั้นอย่าเก็บสำเนาไว้สองชุดเพราะข้อมูลจะคลาดเคลื่อนจากกัน

ln -s AGENTS.md CLAUDE.md

การสร้าง symlink จะไม่แสดงผลลัพธ์ใดๆ หากสำเร็จ ให้เริ่มเซสชันใหม่ รันคำสั่ง /context all และยืนยันว่า CLAUDE.md ปรากฏขึ้นภายใต้ Memory files หากไม่มีรายการดังกล่าวแสดงอยู่ แสดงว่าเอเจนต์ไม่เคยเห็นไฟล์นั้นมาก่อนและการปรับแก้ข้อความก็จะไม่ช่วยอะไร หากคุณต้องการเพิ่มบรรทัดเฉพาะสำหรับ Claude ให้ใช้รูปแบบการ import แทน และวางบรรทัดเหล่านั้นไว้ใต้คำสั่ง import

@AGENTS.md

## Claude Code

Use plan mode for changes under `src/billing/`.

มีกับดักหนึ่งจุดที่ต้องระวัง คือการ import ด้วย @path จะไม่บันทึกบริบท ไฟล์ที่ถูก import จะถูกขยายและโหลดในขณะเริ่มต้นทำงานพร้อมกับไฟล์ที่อ้างถึง โดยสามารถซ้อนกันได้ลึกสูงสุดสี่ระดับ การแบ่งไฟล์กฎขนาด 600 บรรทัดออกเป็นหกไฟล์ย่อยช่วยให้มนุษย์จัดการได้ง่ายขึ้น แต่ไม่ได้เปลี่ยนแปลงค่าใช้จ่ายด้านโทเค็นแต่อย่างใด ธรรมเนียมปฏิบัติเบื้องหลัง AGENTS.md และไฟล์คู่ขนานสำหรับมนุษย์ เป็นสิ่งที่ควรค่าแก่การอ่านก่อนที่คุณจะตัดสินใจเลือกรูปแบบการจัดวาง

สิ่งที่ช่วยลดค่าใช้จ่ายได้จริงคือ .claude/rules/ ที่มีฟิลด์ paths ไฟล์กฎที่มี frontmatter เป็น paths จะถูกโหลดก็ต่อเมื่อเอเจนต์เข้าถึงไฟล์ที่ตรงกับรูปแบบที่กำหนดไว้เท่านั้น

---
paths:
  - "src/api/**/*.ts"
---

# API rules

- Every endpoint validates its input.
- Use the standard error response shape.

กฎที่ไม่มีฟิลด์ paths จะถูกโหลดในขณะเริ่มต้นทำงานด้วยลำดับความสำคัญเดียวกับ .claude/CLAUDE.md ดังนั้นรูปแบบการทำงานที่เหมาะสมคือการใช้กฎแบบไม่มีเงื่อนไขสั้นๆ ร่วมกับรายการ paths สำหรับสิ่งที่สำคัญเฉพาะภายในไดเรกทอรีใดไดเรกทอรีหนึ่งเท่านั้น

เมื่อคุณต้องการใช้ skill

Skill คือไดเรกทอรีที่มีไฟล์ SKILL.md อยู่ภายใน Skill ส่วนบุคคลจะอยู่ที่ ~/.claude/skills/<name>/SKILL.md และมีผลกับทุกโปรเจกต์บนเครื่องของคุณ ส่วน Project skill จะอยู่ที่ .claude/skills/<name>/SKILL.md ซึ่งจะถูกรวมไปกับ repository และสามารถตรวจสอบผ่าน pull request ได้เหมือนไฟล์อื่นๆ

mkdir -p ~/.claude/skills/summarize-changes
---
name: summarize-changes
description: Summarizes uncommitted changes and flags anything risky. Use when the user asks what changed, wants a commit message, or asks to review their diff.
---

Run `git status` and `git diff` against the merge base.
Group the changes by intent, not by file.
Call out anything touching auth, migrations or deletions.

ส่วน description เป็นเพียงส่วนเดียวของไฟล์ที่ถูกนำมาพิจารณาก่อนที่ skill จะทำงาน จึงทำหน้าที่สองอย่างพร้อมกัน คือระบุว่า skill นั้นทำอะไร และระบุว่าควรเรียกใช้เมื่อใด หากคำอธิบายระบุว่า "ช่วยในการ deploy" จะไม่มีข้อมูลให้โมเดลจับคู่กับคำขอได้ ส่งผลให้ skill ไม่ถูกเรียกใช้งานและคุณอาจสรุปไปเองว่า skill ไม่ทำงาน

ชื่อไดเรกทอรีจะกลายเป็นชื่อคำสั่ง ดังนั้นตัวอย่างข้างต้นจะทำให้คุณได้คำสั่ง /summarize-changes ใน skill ส่วนบุคคลหรือ project skill หากมีการระบุ name ใน frontmatter ที่ต่างจากชื่อไดเรกทอรี ระบบจะแสดงชื่อนั้นในเมนู / แทน เว้นแต่ว่าชื่อนั้นจะถูกใช้โดยคำสั่งอื่นไปแล้ว แต่ชื่อไดเรกทอรียังคงใช้เรียก skill ได้ตามปกติ

เมื่อ skill ถูกเรียกใช้งาน เนื้อหาที่แสดงผลจะเข้าสู่บทสนทนาในฐานะข้อความเดียวและจะคงอยู่ตลอดช่วง session นั้น Claude Code จะไม่อ่านไฟล์ซ้ำในภายหลัง ดังนั้นควรเขียนคำสั่งที่เป็นแนวทางปฏิบัติถาวรแทนขั้นตอนที่ใช้ครั้งเดียว และรักษาเนื้อหาให้กระชับ เพราะหลังจากจุดนั้น ทุกบรรทัดจะมีต้นทุนต่อการส่งคำขอแต่ละครั้ง หลังจากระบบทำการ auto-compaction แล้ว Claude Code จะแนบการเรียกใช้ล่าสุดของแต่ละ skill กลับเข้ามา โดยเก็บเนื้อหา 5,000 token แรกของแต่ละ skill ไว้ภายใต้งบประมาณรวม 25,000 token หากคุณเรียกใช้ skill ขนาดใหญ่หลายรายการใน session เดียว skill ที่เก่าที่สุดจะถูกตัดออกไป ซึ่งเป็นเหตุผลว่าทำไม skill ถึงดูเหมือนหยุดทำงานหลังจากสนทนาไปนานๆ หากเรียกใช้ซ้ำ skill นั้นก็จะกลับมาทำงานอีกครั้ง Skill ที่เน้นขั้นตอนการทำงานที่ซับซ้อนจะแสดงให้เห็นถึงการแลกเปลี่ยนนี้อย่างชัดเจน เช่น the unlazy skill และวิธี Depth Tree ซึ่งใช้ context จริงไปกับเงื่อนไขและไฟล์แผนงาน เพื่อแลกกับการที่ agent จะไม่สรุปงานว่าเสร็จสิ้นก่อนเวลาอันควร เมื่อขั้นตอนเดียวกันสามารถใช้ได้กับ codebase มากกว่าหนึ่งแห่ง ให้ แชร์ skill เดียวกันข้ามหลาย repository แทนการคัดลอกไฟล์ไปมา

เมื่อคุณต้องการ MCP server

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

# Remote HTTP server
claude mcp add --transport http notion https://mcp.notion.com/mcp

# Remote HTTP server behind a bearer token
claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token"

# Local stdio server: everything after -- is passed through untouched
claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \
  -- npx -y airtable-mcp-server

ตัว -- มีความสำคัญ สำหรับเซิร์ฟเวอร์แบบ stdio มันทำหน้าที่แยกตัวเลือกของ Claude Code ออกจากบรรทัดคำสั่งที่ใช้เริ่มเซิร์ฟเวอร์ของคุณ หากคุณละเว้นส่วนนี้ --port 8080 ที่ตั้งใจส่งให้เซิร์ฟเวอร์จะถูกตีความว่าเป็นตัวเลือกของ claude mcp add ซึ่งจะส่งผลให้เกิดข้อผิดพลาดในการประมวลผล

claude mcp list
claude mcp get notion

claude mcp add จะยืนยันด้วยบรรทัด Added ... ซึ่งแจ้งเพียงว่าการตั้งค่าถูกบันทึกลงดิสก์แล้ว claude mcp list คือคำสั่งที่แสดงสถานะจริง เนื่องจากจะพิมพ์สถานะความพร้อมใช้งานข้างชื่อเซิร์ฟเวอร์แต่ละตัว ได้แก่ ✔ Connected, ! Needs authentication หรือ ✘ Failed to connect สถานะความล้มเหลวหมายความว่า Claude Code ไม่สามารถติดต่อเซิร์ฟเวอร์นั้นได้ ไม่ได้หมายความว่าคำสั่งแสดงรายการทำงานผิดพลาด ภายในเซสชัน /mcp จะแสดงมุมมองเดียวกันสำหรับแต่ละเซิร์ฟเวอร์พร้อมจำนวนเครื่องมือที่มี

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

MCP server คือกระบวนการที่คุณต้องรันเอง

นี่คือต้นทุนที่การเปรียบเทียบของผู้ให้บริการมักมองข้าม Skill คือไฟล์หนึ่งไฟล์ แต่ MCP server คือซอฟต์แวร์ที่ทำงานในที่ใดที่หนึ่ง และเมื่อที่แห่งนั้นคือ VPS (virtual private server) ของคุณ คุณก็ต้องรับผิดชอบเรื่อง uptime ของมันด้วย

stdio server เป็นกรณีที่มีต้นทุนต่ำ Claude Code จะเรียกใช้มันเป็นกระบวนการลูก (child process) เมื่อเริ่มเซสชันและจะยุติการทำงานเมื่อเซสชันสิ้นสุดลง จึงไม่มีอะไรต้องคอยตรวจสอบหรืออัปเดตตามกำหนดการของตัวเอง ส่วน remote HTTP server เป็นบริการที่ทำงานต่อเนื่องยาวนาน ซึ่งต้องการสิ่งที่บริการลักษณะนี้ทุกตัวต้องมี เริ่มต้นจากการมีผู้ใช้เฉพาะของตัวเอง ให้สร้างผู้ใช้ mcp ที่ unit ด้านล่างนี้จะใช้รัน และกำหนดสิทธิ์ในไดเรกทอรีของเซิร์ฟเวอร์ให้ผู้ใช้นั้น:

sudo useradd --system --home-dir /srv/notes-mcp --shell /usr/sbin/nologin mcp
sudo chown -R mcp:mcp /srv/notes-mcp
[Unit]
Description=Notes MCP server
After=network-online.target
Wants=network-online.target

[Service]
User=mcp
WorkingDirectory=/srv/notes-mcp
ExecStart=/usr/bin/node /srv/notes-mcp/dist/server.js
Environment=PORT=8931
Restart=on-failure
RestartSec=5
NoNewPrivileges=true
PrivateTmp=true

[Install]
WantedBy=multi-user.target
sudo systemctl daemon-reload
sudo systemctl enable --now notes-mcp
systemctl is-active notes-mcp
journalctl -u notes-mcp -n 50 --no-pager

systemctl is-active ควรแสดงผลเป็น active หากแสดงผลเป็น failed ให้ดูสาเหตุใน journal ซึ่งในการรันครั้งแรก มักเกิดจาก environment variable ที่ขาดหายไปหรือพอร์ตถูกใช้งานโดยโปรเซสอื่นไปแล้ว Restart=on-failure เป็นสิ่งที่จำเป็นในกรณีนี้ เพราะ MCP server ที่ล่มจะไม่แจ้งเตือนด้วยตัวเอง คุณจะทราบก็ต่อเมื่อ agent แจ้งว่าไม่สามารถอ่านข้อมูลจาก issue tracker ของคุณได้

ให้ผูกกระบวนการไว้กับ 127.0.0.1 และวาง reverse proxy ที่มี TLS (transport layer security) ไว้ด้านหน้า MCP server ที่เข้าถึงฐานข้อมูลของคุณและตอบสนองผ่านพอร์ตสาธารณะโดยไม่มีการยืนยันตัวตน เปรียบเสมือนการเปิดเผยฐานข้อมูลของคุณสู่สาธารณะ การรัน MCP server บน VPS ครอบคลุมรายละเอียดเรื่อง proxy, certificate และ firewall อย่างถูกต้อง

จากนั้นให้ประเมินภาระงานที่ต้องทำซ้ำอย่างตรงไปตรงมา บริการนี้ต้องการการอัปเดตความปลอดภัยตามรอบของมันเอง ซึ่งไม่เกี่ยวข้องกับ agent ที่ติดต่อกับมัน เมื่อ OAuth token หมดอายุ claude mcp list จะเริ่มแสดงผลเป็น ! Needs authentication ในช่วงเวลาที่ไม่เหมาะสม ข้อมูลประจำตัว (credentials) ของมันจะอยู่ในไฟล์ config หรือใน header Authorization ดังนั้นจึงต้องได้รับการดูแลเช่นเดียวกับความลับอื่นๆ ซึ่งเป็นหัวข้อใหญ่ในตัวเอง: การเก็บความลับให้พ้นจากมือของ AI agent งานเหล่านี้ไม่มีอยู่เลยสำหรับ skill

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

วิธีการวัดต้นทุนบริบทของคุณเอง

หยุดการคาดเดาแล้วรัน /context all ภายในเซสชัน คำสั่งนี้จะแสดงรายละเอียดปัจจุบัน ได้แก่ system prompt, ไฟล์หน่วยความจำ, เครื่องมือ และ MCP servers พร้อมน้ำหนักโทเค็นของแต่ละรายการ

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

หากเปิดใช้งาน discovery cache สำหรับบัญชีของคุณ เซิร์ฟเวอร์ระยะไกลที่คุณเคยใช้งานมาก่อนอาจแสดงสถานะเป็น cached 2h ago · connects on first use · 5 tools นั่นหมายความว่า Claude Code ได้อ่านรายการเครื่องมือจากเซสชันก่อนหน้าแทนที่จะเชื่อมต่อในขณะเริ่มต้นระบบ และมันจะเชื่อมต่อในครั้งแรกที่มีการเรียกใช้เครื่องมือ เครื่องมือต่างๆ จะพร้อมใช้งานตั้งแต่ข้อความแรกของคุณ ดังนั้นจึงไม่มีสิ่งใดที่ต้องแก้ไข โดยปกติแล้วแคชจะถูกปิดไว้ตามค่าเริ่มต้นเว้นแต่การทยอยเปิดใช้งานจะเปิดฟีเจอร์นี้ให้คุณ: ตั้งค่า MCP_DISCOVERY_CACHE=0 เพื่อให้ทุกเซิร์ฟเวอร์เชื่อมต่อในขณะเริ่มต้นระบบ หรือ 1 เพื่อเปิดใช้งานแคช สำหรับภาพรวมที่กว้างขึ้น การจัดการหน้าต่างบริบทของ Claude Code จะครอบคลุมถึงสิ่งที่ยังคงอยู่หลังจากการบีบอัดข้อมูล และ ต้นทุนของโทเค็นเหล่านั้นจริงๆ จะช่วยแปลงตัวเลขเหล่านั้นให้เป็นมูลค่าเงิน

ทำไมทักษะของฉันถึงไม่ทำงาน?

สาเหตุที่พบบ่อยที่สุดคือ description เนื่องจากเป็นข้อความเดียวในบริบทที่ระบบอ่านก่อนจะเรียกใช้ทักษะ ดังนั้นหากข้อความดังกล่าวไม่ได้ระบุถึงสถานการณ์ที่เกิดขึ้น ระบบก็จะไม่พบสิ่งที่ตรงกัน คุณควรเขียนเงื่อนไขการเรียกใช้ (trigger) ลงในประโยค เช่น "ใช้เมื่อผู้ใช้ถามว่ามีอะไรเปลี่ยนแปลง ต้องการข้อความ commit หรือต้องการให้ตรวจสอบ diff" คำอธิบายที่คลุมเครือจะทำให้ระบบล้มเหลวโดยไม่มีการแจ้งเตือน ซึ่งทำให้ตรวจสอบปัญหาได้ยาก

สาเหตุที่สองคือการพิมพ์ผิดในส่วน frontmatter ซึ่งใน Claude Code จะไม่มีการแจ้งเตือนเช่นกัน ชื่อฟิลด์ต้องตรงกันทุกประการรวมถึงเครื่องหมายขีดกลาง และ Claude Code จะเพิกเฉยต่อฟิลด์ที่ระบบไม่รู้จักโดยไม่รายงานข้อผิดพลาด ระบบจะแจ้งเตือนอย่างชัดเจนก็ต่อเมื่อคุณทำการแพ็กเกจทักษะหรืออัปโหลดไปยัง claude.ai หรือ Skills API ซึ่งยอมรับฟิลด์จำนวนจำกัดและจะปฏิเสธฟิลด์ที่เหลือทันที:

Unexpected key(s) in SKILL.md frontmatter: argument-hint. Allowed properties are: allowed-tools, compatibility, description, license, metadata, name

สาเหตุที่สามคือตำแหน่งที่ตั้ง ทักษะของโปรเจกต์จะถูกโหลดจาก .claude/skills/ ในไดเรกทอรีปัจจุบันของคุณและในทุกไดเรกทอรีแม่ขึ้นไปจนถึง root ของ repository ทักษะที่อยู่ในไดเรกทอรีย่อยที่อยู่ ต่ำกว่า จุดที่คุณเริ่มทำงานจะไม่ถูกโหลดเมื่อเริ่มต้นโปรแกรม ทักษะเหล่านั้นจะปรากฏขึ้นก็ต่อเมื่อเอเจนต์อ่านหรือแก้ไขไฟล์ภายในไดเรกทอรีย่อยนั้นเป็นครั้งแรก ดังนั้นจนกว่าจะถึงตอนนั้น ทักษะดังกล่าวจะไม่แสดงในระบบเติมคำอัตโนมัติและไม่สามารถเรียกใช้ด้วยชื่อได้

สิ่งที่เทียบเท่ากับความล้มเหลวแบบเงียบนี้ในส่วนของ MCP คือรายการ .mcp.json ที่มี url แต่ไม่มี type โดย Claude Code จะอ่านรายการใดก็ตามที่ไม่มี type ว่าเป็น stdio server ดังนั้นระบบจะข้ามรายการนั้นไปและรายงานว่า:

MCP server "notes" has a "url" but no "type"; add "type": "http" (or "sse" / "ws") to this entry

การใช้งานทั้งสามส่วนร่วมกัน

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

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

FAQ

ฉันควรเขียน skill หรือสร้าง MCP server ขึ้นมาใช้งาน?

ให้ตัดสินใจโดยพิจารณาว่าข้อมูลมีการเปลี่ยนแปลงระหว่างการเรียกใช้งานแต่ละครั้งหรือไม่ หากเอเจนต์จำเป็นต้องอ่านสถานะแบบเรียลไทม์ที่ผู้อื่นสามารถแก้ไขได้ เช่น ระบบติดตามปัญหา (issue tracker), ฐานข้อมูล หรือแดชบอร์ด คุณจำเป็นต้องใช้ MCP server เพราะข้อมูลใดก็ตามที่คุณเขียนบันทึกไว้จะกลายเป็นข้อมูลเก่าทันทีที่มีการเปลี่ยนแปลงในระบบ หากคุณสามารถเขียนคำตอบลงไปครั้งเดียวแล้วข้อมูลนั้นยังคงถูกต้องแม้เวลาผ่านไป 6 สัปดาห์ ให้เขียนเป็น skill แทน skill คือไฟล์ใน git ที่ไม่มีกระบวนการทำงานเบื้องหลัง ไม่ต้องเปิดพอร์ต และไม่ต้องมีตารางการแพตช์ จึงเป็นทางเลือกที่ประหยัดทรัพยากรกว่าในทุกกรณีที่เป็นไปได้

MCP servers ยังคงทำให้ context window ของฉันเต็มอยู่หรือไม่?

เต็มช้ากว่าเมื่อก่อนมาก ปัจจุบัน Claude Code เปิดใช้งานการค้นหาเครื่องมือ (tool search) เป็นค่าเริ่มต้น ดังนั้นเมื่อเริ่มเซสชันจะมีเพียงชื่อเครื่องมือและฟิลด์คำสั่งของเซิร์ฟเวอร์เท่านั้นที่ถูกโหลดเข้ามา ส่วน schema ฉบับเต็มจะถูกดึงมาก็ต่อเมื่อ Claude ค้นหาเครื่องมือนั้นๆ ซึ่งรวมถึงเซสชันที่อยู่หลัง LLM gateway ที่ตั้งค่าผ่าน ANTHROPIC_BASE_URL ตั้งแต่เวอร์ชัน v2.1.304 เป็นต้นไป การโหลดข้อมูลทั้งหมดล่วงหน้า (upfront loading) ยังคงเกิดขึ้นกับ ENABLE_TOOL_SEARCH=false สำหรับเซิร์ฟเวอร์ที่ตั้งค่าไว้ที่ "alwaysLoad": true บนโมเดลที่เก่ากว่า Claude Opus 4 และ Sonnet 4 (เก่ากว่ารุ่น 4.5 บน Google Cloud's Agent Platform) และบนการปรับใช้ Microsoft Foundry ที่โฮสต์บน Azure ให้รัน /context all เพื่อดูว่าคุณอยู่ในสถานการณ์ใด เนื่องจากตัวเลขในบทความเปรียบเทียบเก่าๆ นั้นตั้งสมมติฐานว่ามีการโหลดข้อมูลล่วงหน้าทั้งหมด

Claude Code อ่านไฟล์ AGENTS.md หรือไม่?

อ่าน ตั้งแต่เวอร์ชัน v2.1.277 เป็นต้นมา แต่โดยค่าเริ่มต้นจะอ่านก็ต่อเมื่อไม่มีไฟล์ CLAUDE.md, .claude/CLAUDE.md หรือ CLAUDE.local.md อยู่ในไดเรกทอรีทำงานของคุณหรือไดเรกทอรีที่อยู่เหนือขึ้นไป หาก repository ของคุณมีทั้งสองอย่าง Claude จะอ่านเฉพาะไฟล์ CLAUDE.md เท่านั้น ดังนั้นให้ใช้วิธีอ้างอิงไฟล์หนึ่งไปยังอีกไฟล์หนึ่งแทนการเก็บไว้สองชุด ให้รัน ln -s AGENTS.md CLAUDE.md เพื่อสร้าง symlink แบบปกติ หรือใส่ @AGENTS.md ไว้ที่บรรทัดแรกของไฟล์ CLAUDE.md แล้วเพิ่มคำสั่งเฉพาะสำหรับ Claude ไว้ด้านล่าง จากนั้นเริ่มเซสชันและรัน /context all เพื่อยืนยันว่า CLAUDE.md ปรากฏขึ้นภายใต้ Memory files

ทำไม skill ของฉันถึงหยุดทำงานกลางคันระหว่างเซสชัน?

สาเหตุส่วนใหญ่มักเกิดจาก Auto-compaction เมื่อบทสนทนาถูกสรุป Claude Code จะแนบการเรียกใช้งานล่าสุดของแต่ละ skill กลับเข้ามา โดยเก็บเนื้อหา 5,000 token แรกของแต่ละ skill ไว้ ภายใต้งบประมาณรวม 25,000 token สำหรับทุก skill รวมกัน ระบบจะจัดสรรงบประมาณนี้โดยเริ่มจาก skill ที่ถูกเรียกใช้งานล่าสุด ดังนั้นหากคุณเรียกใช้งาน skill ขนาดใหญ่หลายรายการ skill ที่เก่ากว่าจะถูกตัดออกไปโดยสมบูรณ์ ให้เรียกใช้งาน skill นั้นอีกครั้งเพื่อกู้คืนเนื้อหาทั้งหมด

ฉันจะหยุดไม่ให้ไฟล์กฎ (rules file) ขนาดใหญ่โหลดในทุกเซสชันได้อย่างไร?

ให้ย้ายส่วนที่สำคัญเฉพาะบางครั้งไปไว้ในไฟล์ .claude/rules/ โดยกำหนดฟิลด์ paths ไว้ในส่วน frontmatter เพื่อให้แต่ละไฟล์โหลดเฉพาะเมื่อเอเจนต์เข้าถึงไฟล์ที่ตรงกับเงื่อนไขเท่านั้น การแยกไฟล์ออกเป็น @path imports ไม่ช่วยแก้ปัญหานี้ เพราะไฟล์ที่ถูก import จะถูกขยายและโหลดพร้อมกันตั้งแต่เริ่มทำงานร่วมกับไฟล์ที่อ้างอิงถึง สิ่งใดที่เป็นขั้นตอนการทำงานหลายขั้นตอนมากกว่าจะเป็นข้อเท็จจริงถาวร ควรเปลี่ยนให้เป็น skill แทน เนื่องจากเนื้อหาของ skill จะไม่ใช้ทรัพยากรใดๆ จนกว่าจะถูกเรียกใช้งาน

บทความนี้มีประโยชน์หรือไม่