Cascade / MCP

หน้าเอกสารการ setup Cascade + MCP

หน้านี้ตั้งใจทำเป็น “หน้าเดียวจบ” สำหรับทีม: วิธีตั้งค่า, แนวทาง customizations, และรูปแบบการบันทึกประวัติการใช้งานให้ตรวจสอบย้อนหลังได้ โดยจะหลีกเลี่ยงการใส่ token/secret ลงใน repo

SetupMCP CustomizationsUsage Historyกลับหน้าแรก

1) Setup Cascade (Checklist)

ทำตามลำดับนี้เพื่อให้ใช้งานได้ และลดความเสี่ยงเรื่องข้อมูล/สิทธิ์

Checklist ก่อนเริ่ม

  • ยืนยันว่าโปรเจกต์เปิดใน IDE ถูก workspace (repo นี้)
  • ตั้งกติกาเรื่องข้อมูล: ห้ามใส่ secrets/PII ลงในแชท หรือให้ tool ส่งออกนอกองค์กร
  • ถ้าจะใช้เครื่องมือภายนอก (เช่น search/web) ให้ระบุขอบเขตข้อมูลที่ส่งออก ให้ชัดเจน

แนวทางการใช้งานในงานโค้ด

  • เริ่มจากให้ Cascade สำรวจโครงสร้าง (code search) ก่อนแก้โค้ด
  • งานที่กระทบหลายไฟล์: ให้ทำเป็น plan (todo) แล้วค่อยลงมือทีละ milestone
  • เวลาขอให้รันคำสั่ง: แยก “คำสั่งปลอดภัย” vs “คำสั่งมีผลกระทบ” และขออนุมัติ

สิ่งที่ตรวจพบใน repo นี้

  • โครงสร้างเว็บเป็น Next.js (App Router) อยู่ใน src/app
  • มีหน้า/คอมโพเนนต์สรุป MCP อยู่แล้ว: src/app/McpOverview.tsx
  • ไม่พบโฟลเดอร์ .windsurf ใน repo (อาจเป็น config ที่อยู่ในเครื่องและไม่ได้ commit)

2) MCP Customizations (สิ่งที่ควรบันทึกไว้)

ส่วนนี้เป็นโครงให้คุณกรอก/อัปเดต เพื่อสะท้อน config จริงในเครื่อง

MCP Servers ที่ใช้งาน

กรอกตามที่คุณเปิดใช้งานจริง (ตัวอย่างจากหน้า MCP เดิมในเว็บนี้):

gdrive

ค้น/อ่านไฟล์จาก Google Drive

brave-search

ค้นเว็บ / local search (อาจติด rate limit)

deepwiki

อ่าน/ถามโครงสร้าง repo บน GitHub

memory

บันทึกกติกา/บริบทระยะยาว

Custom Instructions / Rules

แนะนำให้จดหัวข้อเหล่านี้ไว้ในที่เดียว (เช่น README ภายในทีม หรือเอกสารภายนอก):

  • แนวทางการตอบ/ภาษา/สไตล์การแก้โค้ด
  • สิ่งที่ห้ามทำ (เช่น ห้ามเก็บ secrets, ห้ามรันคำสั่งอันตรายโดยไม่ขออนุมัติ)
  • มาตรฐานการตั้งชื่อ branch/PR/commit
  • แนวทาง review (เช่น ต้องมี test, ต้องมี migration plan)

Workflows

ถ้าคุณมี workflow แบบไฟล์ในเครื่อง (เช่น .windsurf/workflows) แต่ไม่ได้อยู่ใน repo, ให้ระบุ:

  • ชื่อ workflow (เช่น /do, /how)
  • วัตถุประสงค์
  • ขั้นตอนสำคัญ + เงื่อนไขความปลอดภัย

3) ประวัติการใช้งาน (Usage History)

ใน repo นี้ยังไม่พบไฟล์ log ทางการ จึงทำเป็นเทมเพลตให้คุณบันทึกเอง

รูปแบบที่แนะนำ (คัดลอกไปใช้ได้ทันที)

# Cascade Usage History

## 2025-__-__
- Work item: (สรุปงาน 1 บรรทัด)
- Repo/Path: (เช่น kasidit-blog)
- Scope: (หน้า/ฟีเจอร์/ไฟล์หลัก)
- Tools used:
  - code_search: (คำค้น)
  - grep_search: (คำค้น)
  - read_file: (ไฟล์สำคัญ)
  - apply_patch/write_to_file: (ไฟล์ที่แก้)
- Outcome:
  - (ทำอะไรสำเร็จ)
- Notes/Risks:
  - (สิ่งที่ต้องระวัง/สิ่งที่ยังค้าง)

## 2025-__-__
- ...

ถ้าต้องการ “ประวัติทั้งหมด” จริง ๆ

  • ต้องมีแหล่งข้อมูลจริง เช่น export จากระบบแชท/IDE หรือไฟล์บันทึกในทีม (ผมยังไม่เห็นไฟล์นั้นใน repo)
  • ถ้าคุณมีไฟล์/ลิงก์ที่เก็บประวัติ (เช่น markdown/Notion/Drive) ส่ง path/URL มาได้ แล้วผมจะช่วยสรุป + จัดรูปแบบเป็นหน้านำเสนอให้

ต้องการให้หน้านี้ “ดึงข้อมูลจริง” จากไฟล์ใน repo อัตโนมัติไหม? ถ้าต้องการ บอกชื่อไฟล์ที่คุณจะใช้เก็บ history (เช่น docs/cascade-usage-history.md) แล้วผมจะปรับหน้าให้ render จากไฟล์นั้นครับ