กำหนดค่า PandaNpc MCP Server สำหรับ Claude Code และ Codex

PandaNpc MCP server เชื่อมต่อตัวแทนการเขียนโค้ดที่รองรับ MCP เข้ากับฐานความรู้ PandaNote ของคุณ บันทึกการทำงาน งานตามกำหนดเวลา การกำหนดค่าโมเดล และ Agent Service Center ซึ่งมีประโยชน์เมื่อตัวแทนต้องการบริบทของโปรเจกต์ที่คงอยู่แทนที่จะเริ่มจากบทสนทนาที่ว่างเปล่าทุกครั้ง

เซิร์ฟเวอร์ทำงานในเครื่องผ่านการขนส่งมาตรฐานอินพุต/เอาต์พุตของ MCP ไคลเอนต์ MCP ของคุณจะเริ่มกระบวนการ pandanpc-mcp เมื่อเปิดเซสชัน คุณไม่จำเป็นต้องเปิดพอร์ตหรือรันเว็บเซิร์ฟเวอร์แยกต่างหาก

ก่อนติดตั้ง

คุณจำเป็นต้องมี:

• Node.js และ npm พร้อมใช้งานในสภาพแวดล้อมเดียวกับที่ไคลเอนต์ MCP รัน
• บัญชี PandaNpc ที่เข้าถึงที่อยู่อีเมลที่ใช้สำหรับการยืนยันตัวตน
• Claude Code, OpenAI Codex, Cursor หรือไคลเอนต์อื่นที่รองรับเซิร์ฟเวอร์ MCP แบบ stdio ในเครื่อง

หากคุณต้องการให้ตัวแทนจัดตารางงานบนคอมพิวเตอร์เครื่องใดเครื่องหนึ่งของคุณ ให้ติดตั้งและเชื่อมต่อ PandaPaw ก่อน เครื่องมือบันทึกและพื้นที่ทำงานไม่จำเป็นต้องมีอุปกรณ์ PandaPaw ออนไลน์

ติดตั้งหรืออัปเดต MCP server

ติดตั้งแพ็กเกจแบบ global บน macOS, Linux หรือ Windows:

npm install -g @pandanpc/mcp-server

ยืนยันว่าโปรแกรมปฏิบัติการมองเห็นได้ในเชลล์ของคุณ:

pandanpc-mcp --help

รันคำสั่ง npm เดียวกันทุกครั้งที่ต้องการอัปเดต รีสตาร์ทไคลเอนต์ MCP หลังการอัปเดต เนื่องจากไคลเอนต์ที่กำลังรันอยู่จะยังคงใช้เวอร์ชันกระบวนการที่เปิดตัวครั้งแรก

ตรวจสอบ ประวัติเวอร์ชัน MCP server เมื่อเครื่องมือหรือพฤติกรรมแตกต่างจากสกรีนช็อตหรือบทช่วยสอนที่เก่ากว่า

เพิ่ม PandaNpc ใน Claude Code

วิธีที่น่าเชื่อถือที่สุดคือคำสั่งกำหนดค่าของ Claude Code เอง ใช้ user scope หากคุณต้องการให้ PandaNpc พร้อมใช้งานในทุกโปรเจกต์:

claude mcp add --scope user pandanpc -- pandanpc-mcp

ใช้ --scope project เมื่อควรแชร์การกำหนดค่าผ่านรีโพซิทอรีปัจจุบัน หรือ --scope local เมื่อควรใช้กับคุณเท่านั้นในโปรเจกต์ปัจจุบัน

ตรวจสอบเซิร์ฟเวอร์ที่ลงทะเบียน:

claude mcp get pandanpc
claude mcp list

คุณยังสามารถกำหนดค่าเซิร์ฟเวอร์ stdio ด้วยตนเองในไฟล์กำหนดค่า MCP ที่ใช้โดยการติดตั้ง Claude Code ของคุณ:

{
  "mcpServers": {
    "pandanpc": {
      "command": "pandanpc-mcp"
    }
  }
}

เพิ่ม PandaNpc ใน OpenAI Codex

Codex สามารถลงทะเบียนกระบวนการภายในเครื่องเดียวกันได้จากบรรทัดคำสั่ง:

codex mcp add pandanpc -- pandanpc-mcp

ตรวจสอบการกำหนดค่าที่บันทึกไว้:

codex mcp get pandanpc
codex mcp list

รายการที่เทียบเท่าใน ~/.codex/config.toml คือ:

[mcp_servers.pandanpc]
command = "pandanpc-mcp"

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

กำหนดค่า Cursor และไคลเอนต์ MCP อื่น ๆ

สำหรับ Cursor ให้เพิ่มเซิร์ฟเวอร์ภายในเครื่องไปที่ ~/.cursor/mcp.json โดยใช้รูปแบบ JSON เดียวกับที่แสดงสำหรับ Claude Code สำหรับ Windsurf และไคลเอนต์อื่น ๆ ให้สร้างเซิร์ฟเวอร์ MCP แบบ stdio ซึ่งคำสั่งคือ pandanpc-mcp และรายการอาร์กิวเมนต์ว่างเปล่า

โปรแกรมปฏิบัติการต้องอยู่ใน PATH ที่แอปพลิเคชันกราฟิกได้รับ หากทำงานในเทอร์มินัลแต่ไคลเอนต์เดสก์ท็อปรายงานว่า "command not found" ให้ใช้เส้นทางโปรแกรมปฏิบัติการแบบสัมบูรณ์ที่ส่งคืนโดยคำสั่งต่อไปนี้:

command -v pandanpc-mcp

บน Windows PowerShell ให้ใช้:

Get-Command pandanpc-mcp

ลงชื่อเข้าจากตัวแทน

PandaNpc ใช้ขั้นตอนการยืนยันอีเมลสองขั้นตอน ขอให้ตัวแทนดำเนินการตามลำดับนี้:

1. เรียก note_login ด้วยที่อยู่อีเมลของคุณ PandaNpc จะส่งรหัสยืนยัน
2. เรียก note_login อีกครั้งด้วยที่อยู่อีเมลเดียวกันและรหัสนั้น

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

ตรวจสอบการเชื่อมต่อ MCP

รันการทดสอบแบบอ่านอย่างเดียวขนาดเล็กก่อนอนุญาตให้ตัวแทนสร้างหรือแก้ไขข้อมูล:

1. ขอให้เรียก list_workspaces
2. ขอให้เรียก list_notes สำหรับหนึ่งเวิร์กสเปซ
3. ขอให้ค้นหาคีย์เวิร์ดที่ไม่เป็นอันตรายด้วย search_notes

การตอบสนองที่สำเร็จพิสูจน์ว่าไคลเอนต์ MCP เริ่มกระบวนการ การตรวจสอบสิทธิ์เสร็จสมบูรณ์ และ API ของบัญชีเข้าถึงได้ สำหรับการทดสอบการเขียน ให้สร้างโน้ตที่ใช้แล้วทิ้งแล้วทำ soft-delete

รายการเครื่องมือที่แน่นอนที่ไคลเอนต์ MCP ของคุณแสดงคือแหล่งความจริงสำหรับเวอร์ชันที่ติดตั้ง เครื่องมือถูกจัดกลุ่มตามเวิร์กโฟลว์เหล่านี้:

สำหรับคำจำกัดความฟิลด์ผู้ให้บริการและโมเดล ดู ผู้ให้บริการ AI แบบกำหนดเองและ API Key สำหรับขอบเขตบัญชีและการเรียกเก็บเงิน ดู บัญชี แผน และต้นทุน API ของ PandaNpc

แนวปฏิบัติการทำงานอย่างปลอดภัย

• เริ่มต้นด้วยเครื่องมือ list, read หรือ search ก่อนดำเนินการ create, update, delete หรือ schedule
• อ่านโน้ตก่อนอัปเดต เนื่องจากการอัปเดตโน้ตจะแทนที่เอกสาร Markdown ทั้งหมดแทนที่จะใช้ patch
• ถือว่าพรอมป์ตามกำหนดเวลาเป็นคำขอรันโค้ด: ยืนยันเครื่องเป้าหมาย ไดเรกทอรีทำงาน เขตเวลา และนิพจน์ cron หกฟิลด์
• เก็บ API Key ของผู้ให้บริการไว้นอกพรอมป์และโน้ต ป้อนความลับผ่านขั้นตอนการกำหนดค่าผู้ให้บริการที่ตั้งใจไว้เท่านั้น
• ตรวจสอบการ์ดอนุมัติเครื่องมือ MCP ก่อนอนุญาตการทำลายล้างหรือการกระทำภายนอก
• ใช้ save_done สำหรับบันทึกการทำงานแทนการเดาเวิร์กสเปซและโฟลเดอร์วันที่ด้วยตนเอง

การแก้ไขปัญหา

ไคลเอนต์รายงานว่าไม่พบ `pandanpc-mcp`

เปิดเทอร์มินัลใหม่หลังการติดตั้งและตรวจสอบเส้นทางโปรแกรมปฏิบัติการ แอปพลิเคชันเดสก์ท็อปบางครั้งรับ PATH ที่เก่ากว่า กำหนดค่าเส้นทางแบบสัมบูรณ์หรือรีสตาร์ทแอปพลิเคชัน หาก npm ติดตั้งผ่านตัวจัดการเวอร์ชัน ตรวจสอบให้แน่ใจว่าไคลเอนต์ MCP เริ่มต้นภายใต้ผู้ใช้และสภาพแวดล้อมเดียวกัน

เซิร์ฟเวอร์ลงทะเบียนแล้วแต่ไม่มีเครื่องมือปรากฏ

รีสตาร์ทไคลเอนต์ จากนั้นตรวจสอบ claude mcp get pandanpc หรือ codex mcp get pandanpc ลบและเพิ่มรายการอีกครั้งหากคำสั่งผิด ตรวจสอบด้วยว่าคุณไม่ได้กำหนดค่ากระบวนการ stdio ในเครื่องเป็น URL HTTP

เครื่องมือบอกว่าคุณยังไม่ได้ตรวจสอบสิทธิ์

เรียก note_login สองครั้งอีกครั้ง ใช้รหัสยืนยันล่าสุด ตรวจสอบโฟลเดอร์สแปม และยืนยันว่าทั้งสองครั้งใช้อีเมลเดียวกัน

งานตามกำหนดเวลาไม่พบเครื่อง

เรียก list_scheduled_bridges ก่อน หากไม่มีอุปกรณ์พร้อมใช้งาน ให้ตรวจสอบ สถานะ PandaPaw และการเชื่อมต่ออุปกรณ์ บนเครื่องเป้าหมาย เครื่องที่ปิดอยู่ หลับ ลงชื่อออก หรือตัดการเชื่อมต่อไม่สามารถเริ่มการทำงานตามกำหนดการได้

การอัปเดตโน้ตลบข้อความที่มีอยู่

update_note รับเนื้อหาทดแทนเต็มรูปแบบ กู้คืนโน้ตจากประวัติหรือถังขยะที่มี จากนั้นอ่านเนื้อหาปัจจุบันและส่งเอกสารที่รวมกัน

ต้องการความช่วยเหลือเฉพาะบัญชี? ติดต่อ support@pandanpc.com และระบุชื่อไคลเอนต์ MCP ระบบปฏิบัติการ เวอร์ชันแพ็กเกจ และข้อความข้อผิดพลาดที่แน่นอนโดยไม่มีความลับ