ให้เอเจนต์ดูแลรายการสิ่งที่ต้องทำของคุณ

MCP หรือ CLI?

เลือกใช้ MCP tools เมื่อเอเจนต์ของคุณมีการเชื่อมต่อ MCP กับ TaskForge อยู่แล้ว มันมี type ชัดเจน คืนค่า error แบบมีโครงสร้างที่เอเจนต์ใช้แก้ไขตัวเองได้ และไม่ต้องมีอะไรใน PATH ของคุณเลย ส่วน CLI ให้ใช้จาก shell ที่ไม่มีการเชื่อมต่อ MCP เช่น script, cron, CI หรือเอเจนต์เขียนโค้ดที่ทำงานอยู่ใน repo ที่ checkout ไว้ ทั้งสองแบบขับเคลื่อนเอนจินเดียวกันด้วย semantics เดียวกัน จึงเลือกอันไหนที่ runtime ของคุณต่อไว้แล้วก็ได้ การแก้ไฟล์ Vault ด้วยมือคือทางเลือกสุดท้าย

ติดตั้ง

{
  "mcpServers": {
    "taskforge": {
      "command": "npx",
      "args": ["-y", "taskforge-md", "mcp", "--stdio"],
      "env": {
        "TASKFORGE_VAULT": "/path/to/your/vault"
      }
    }
  }
}

บน Windows ให้ใส่ cmd /c ไว้หน้า npx ไคลเอนต์ MCP บนเดสก์ท็อปอย่าง Claude Desktop จะเริ่มเซิร์ฟเวอร์โดยไม่ผ่าน shell และ npx เป็นสคริปต์ .cmd ที่ Windows จะรันได้ผ่าน shell เท่านั้น:

{
  "mcpServers": {
    "taskforge": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "taskforge-md", "mcp", "--stdio"],
      "env": {
        "TASKFORGE_VAULT": "C:\\path\\to\\your\\vault"
      }
    }
  }
}

คอมไพล์ taskforge เองจาก source แทนที่จะใช้ npx ใช่ไหม ให้ชี้คอนฟิกไปที่ไบนารีโดยตรง:

"command": "taskforge",
"args": ["mcp", "--stdio"]

ใช้ได้เฉพาะบนเดสก์ท็อป เพราะนั่นคือที่ที่ MCP client อาศัยอยู่ taskforge มาในรูปไบนารีเนทีฟตัวเดียวสำหรับ macOS และ Windows โดย MCP server เป็นหนึ่งใน subcommand ของมัน เวอร์ชัน Linux จะมาเร็ว ๆ นี้

ชุดเครื่องมือทั้งหมด

มีทั้งหมด 30 เครื่องมือ ครอบคลุมวงจรชีวิตของงานและโน้ตทั้งหมด ได้แก่ สร้าง อ่าน อัปเดต ทำเสร็จ เก็บถาวร และลบ แต่ละอย่างมีเวอร์ชันทำทีละหลายรายการด้วย นอกจากนี้ยังมีการย้าย การเปลี่ยนงานแม่ และการแปลงระหว่างบรรทัดแบบ inline กับไฟล์งาน การสร้าง เปลี่ยนชื่อ ลบ และแก้ไขโน้ตโดยไม่ทำให้ลิงก์เสีย การตรวจสอบ lint ก่อนเขียนบรรทัด การเรียก doctor เพื่อตรวจสุขภาพ vault และ resource ของสำเนียงงานกับพื้นที่เพื่อให้เอเจนต์เรียนรู้รูปแบบของคุณก่อนลงมือทำ หกอย่างด้านล่างคือสิ่งที่คุณจะใช้บ่อยที่สุด ทุกการเรียกจะอ่าน vault จากดิสก์ใหม่เสมอ เอเจนต์จึงทำงานกับไฟล์ล่าสุดอยู่เสมอ

แต่ละเครื่องมือมี annotation กำกับไว้ ทำให้ไคลเอนต์รู้ได้ทันทีว่าการเรียกไหนอ่านอย่างเดียว ไหนเขียน และไหนลบ ส่วนที่เหลือของชุดเครื่องมือยังมี bulk_add_tasks, bulk_update_tasks, bulk_complete_tasks, bulk_delete_tasks, get_tasks, archive_task, move_task, bulk_move_tasks, convert_task, bulk_convert_tasks, outdent_task, bulk_reparent_tasks, lint_task, doctor, list_spaces, get_dialect, create_note, read_note, update_note, patch_note_block, patch_note_frontmatter, normalize_references, delete_note และ move_note

สามรีซอร์ส

นอกจากเครื่องมือแล้ว เซิร์ฟเวอร์ยังเปิดให้เข้าถึงบริบทแบบอ่านอย่างเดียว เพื่อให้เอเจนต์เรียนรู้กฎของ Vault คุณก่อนที่จะลงมือทำ:

ถ้ามันหา Vault ของคุณไม่เจอ

เซิร์ฟเวอร์เริ่มทำงานเสมอ แม้จะยังไม่รู้ว่า Vault ของคุณอยู่ที่ไหน ดังนั้น Claude Desktop จะไม่มีวันแสดง "server failed to start" แบบไม่ชัดเจน เมื่อการเรียกเครื่องมือหา Vault ไม่เจอ มันจะคืนข้อผิดพลาดที่เป็นข้อความธรรมดาให้เอเจนต์ส่งต่อได้ ได้แก่ ตั้งค่าตัวแปรสภาพแวดล้อม TASKFORGE_VAULT ให้เป็นพาธของ Vault คุณ หรือติดตั้งบันเดิลใหม่แล้วป้อนไดเรกทอรี Vault เมื่อถูกถาม

ทำงานในเครื่องเท่านั้น

MCP server ของ TaskForge ทำงานในเครื่องและอ่านเขียนไฟล์ Markdown ใน Vault ของคุณ การติดตั้งผ่าน npx จะดาวน์โหลดแพ็กเกจจาก npm ไคลเอนต์ AI ของคุณอาจส่งอินพุตและผลลัพธ์ของเครื่องมือไปยังผู้ให้บริการของมัน โดยการตั้งค่าความเป็นส่วนตัวของผู้ให้บริการนั้นยังมีผลอยู่ ระบบซิงค์ของ Vault ที่คุณใช้อยู่แล้วจะส่งต่อการแก้ไขระหว่างอุปกรณ์

ชอบใช้เทอร์มินัลมากกว่าไหม?

ถ้าคุณอยากเขียนสคริปต์จัดการงาน หรือรันคำสั่งครั้งเดียวแทนที่จะให้เอเจนต์เป็นคนควบคุม taskforge CLI ก็ครอบคลุม Vault เดียวกันด้วยกฎเดียวกัน

คำถามที่คนถามบ่อย