คู่มือ MCP
MCP เชื่อมต่อ Codex หรือ Claude Code กับงานใน Rememo เพื่ออ่านบริบท เพิ่มความคืบหน้า และดำเนินการกับงานเมื่อคุณอนุญาต
ยังไม่ได้เผยแพร่บน npm คำสั่งด้านล่างใช้ได้หลังจากเผยแพร่แล้ว
ก่อนเริ่มต้น
- ใช้ Node.js 24.18.1–24.x ติดตั้ง CLI ของ Codex หรือ Claude Code ที่ต้องการเชื่อมต่อ และให้เรียกใช้ได้ผ่าน PATH
- ใน Rememo เปิด การตั้งค่า → ส่วนตัว → Agent access สร้างโทเค็นการเข้าถึงส่วนตัว เลือกขอบเขตสิทธิ์ที่ต้องการ และคัดลอกโทเค็นซึ่งแสดงเพียงครั้งเดียว
- ใช้ tasks:read เพื่ออ่านงาน, tasks:write เพื่อรับหรือทำงานให้เสร็จ, comments:write เพื่อเพิ่มความคืบหน้า และ context:read เพื่ออ่านบริบทของงาน เพิกถอนโทเค็นในหน้า Agent accessเมื่อไม่ต้องการใช้อีก
เชื่อมต่อไคลเอนต์
npx @rememo/cli mcp setup- เลือก codex, claude หรือ both ต้องติดตั้ง CLI ของไคลเอนต์ที่เลือกก่อนจึงจะลงทะเบียน Rememo ได้
- ใช้ https://app.rememo.io หรือ URL ของ Rememo ที่คุณโฮสต์เอง รวมถึงคำนำหน้าพาธถ้ามี สามารถระบุ URL ที่มี /api/ ได้เช่นกัน
- วางโทเค็นในช่องรับข้อมูลที่ซ่อนค่าในเทอร์มินัล ระบบจะบันทึกลงไฟล์ส่วนตัวในเครื่อง และลงทะเบียนกับไคลเอนต์เฉพาะพาธของไฟล์ จากนั้นเริ่มไคลเอนต์ใหม่
ไฟล์ส่วนตัวเริ่มต้นคือ ~/.rememo/mcp/config.json (ไดเรกทอรี 0700 และไฟล์ 0600 ในระบบที่รองรับ) เก็บไว้เป็นส่วนตัว อย่าใส่โทเค็นในอาร์กิวเมนต์คำสั่งหรือการตั้งค่าไคลเอนต์ที่ใช้ร่วมกัน
เครื่องมือที่ใช้ได้
rememo_list_tasks- แสดงรายการงานที่โทเค็นของคุณเข้าถึงได้
rememo_get_task- อ่านงาน ขั้นตอนการทำงาน และบริบทที่ได้รับอนุญาต
rememo_claim_task- รับงานไว้ในคอลัมน์ปลายทางที่ระบุชัดเจนเมื่อคุณร้องขอ
rememo_add_task_update- เพิ่มความคิดเห็นในงาน
rememo_complete_task- ทำงานให้เสร็จเมื่อคุณร้องขออย่างชัดเจน
ไคลเอนต์จะรับหรือทำงานให้เสร็จเมื่อคุณร้องขออย่างชัดเจนเท่านั้น การรับงานต้องระบุคอลัมน์ปลายทาง เซิร์ฟเวอร์ไม่รับงานเองโดยอัตโนมัติ
การตั้งค่าขั้นสูงและการแก้ปัญหา
การตั้งค่าแบบไม่โต้ตอบ
ตั้งค่า REMEMO_PERSONAL_ACCESS_TOKEN ในสภาพแวดล้อม แล้วระบุ --client และ --url ไม่มีอาร์กิวเมนต์ --token อย่าให้ค่าตัวแปรปรากฏในประวัติเชลล์หรือบันทึกที่ใช้ร่วมกัน
npx @rememo/cli mcp setup --client both --url https://app.rememo.ioการติดตั้งแยกกัน
ใช้ --config พร้อมพาธสัมบูรณ์ของไฟล์ส่วนตัวแยกต่างหากสำหรับ Rememo อีกชุดหนึ่ง เรียกการตั้งค่าอีกครั้งเพื่ออัปเดตเฉพาะการลงทะเบียน Rememo โดยคงการตั้งค่าอื่นของไคลเอนต์ไว้
npx @rememo/cli mcp setup --client codex --url https://tasks.example.com/team --config /ABSOLUTE/PRIVATE/team.jsonเซิร์ฟเวอร์แบบแยก
สำหรับไคลเอนต์ที่คุณตั้งค่าเอง ให้เริ่มเซิร์ฟเวอร์ stdio ด้วยไฟล์กำหนดค่าส่วนตัว ลงทะเบียนคำสั่งและพาธของไฟล์เท่านั้น ไม่ใช่โทเค็น
npx -y @rememo/mcp@0.1.0 --config /ABSOLUTE/PRIVATE/config.jsonลำดับการกำหนดค่า: ไฟล์ --config ที่ระบุ จากนั้นคู่ตัวแปร REMEMO_API_URL และ REMEMO_PERSONAL_ACCESS_TOKEN ที่ครบถ้วน แล้วจึงเป็นไฟล์ส่วนตัวเริ่มต้น ระบบจะปฏิเสธคู่ตัวแปรที่ไม่ครบ REMEMO_API_URL คือ URL ฐานของ API ซึ่งรวม /api/
หากเชื่อมต่อไม่สำเร็จ
ตรวจสอบเวอร์ชัน Node.js คำสั่งของไคลเอนต์ที่เลือกใน PATH, URL ของ Rememo และขอบเขตสิทธิ์ของโทเค็น เริ่มไคลเอนต์ใหม่หลังลงทะเบียน หากลงทะเบียนได้เพียงบางส่วน ให้แก้ไขไคลเอนต์นั้นแล้วตั้งค่าอีกครั้ง เพิกถอนและเปลี่ยนโทเค็นที่เปิดเผยหรือหมดอายุ