คู่มือ

การเชื่อมต่อ Claude

การเชื่อมต่อ Claude

v1.11.0+

การเชื่อมต่อ Claude เป็นฟีเจอร์ที่เพิ่มส่วนขยายให้แอปเดสก์ท็อป Claude (Windows, macOS) เพื่อควบคุม GeckoFlag จากการสนทนากับ Claude ท่านค้นหา ดู สร้าง และอัปเดตงาน โปรเจกต์ Wiki และโน้ต รวมถึงส่งออกแผนภูมิ Gantt เป็น Excel ได้ ส่วนขยายทำงานบนคอมพิวเตอร์ของผู้ใช้ และสื่อสารโดยตรงกับ GeckoFlag ของผู้ใช้เท่านั้น การดำเนินการทั้งหมดทำด้วยสิทธิ์ผู้ใช้ของเจ้าของ API token

การตั้งค่าของผู้ดูแลระบบ

  1. 1เปิดตั้งค่าในเมนูด้านข้าง แล้วคลิกแก้ไขที่การ์ดการเชื่อมต่อ Claudeหน้าการตั้งค่า การ์ด “Claude Integration” ถูกเน้นด้วยกรอบสีแดง
  2. 2เปิดเปิดใช้การเชื่อมต่อ Claude (ค่าเริ่มต้นคือปิด) หากต้องการให้ Claude สร้างและแก้ไขด้วย ให้เปิดอนุญาตการเขียนแล้วบันทึก หากไม่อนุญาตการเขียน token ทั้งหมดจะเป็นแบบอ่านอย่างเดียวหน้าการตั้งค่าการเชื่อมต่อ Claude ช่องเลือก “Enable Claude integration” และ “Allow writing” ถูกเน้นด้วยกรอบสีแดง และด้านล่างแสดงจำนวนผู้ใช้ที่ได้รับอนุญาตและจำนวน API token
  3. 3ในผู้ใช้ เปิดแก้ไขของผู้ใช้ที่ต้องการ เปิดอนุญาตการใช้การเชื่อมต่อ Claude (API) แล้วคลิกอัปเดต การตั้งค่านี้แยกจาก “อนุญาตการลงทะเบียนด้วย AI” เมื่อยกเลิกสิทธิ์ API token ทั้งหมดของผู้ใช้นั้นจะถูกลบหน้าแก้ไขผู้ใช้ เมนู “Users” ด้านข้างและช่องเลือก “Allow Claude integration (API)” ถูกเน้นด้วยกรอบสีแดง

สร้าง API token

  1. 1เปิดโปรไฟล์ในเมนูด้านข้าง แล้วในส่วนAPI token ให้ระบุชื่อ token วันหมดอายุ (30 วัน 90 วัน 365 วัน หรือไม่มีวันหมดอายุ ค่าเริ่มต้นคือ 90 วัน) และสิทธิ์ (อ่านอย่างเดียวหรืออ่านและเขียน) แล้วสร้าง tokenส่วน “API Tokens (Claude Integration)” ในหน้าโปรไฟล์ ช่อง Token name, Expires in และ Permission ถูกเน้นด้วยกรอบสีแดง
  2. 2คัดลอก token ที่แสดง (สตริงที่ขึ้นต้นด้วย gfk_) token จะแสดงเพียงครั้งเดียวทันทีหลังสร้าง และจด “URL สำหรับกรอกในส่วนขยาย” ที่แสดงในส่วนเดียวกันไว้ด้วย
  • สร้าง token ได้สูงสุด 5 รายการต่อคน และลบ token ที่ไม่ใช้แล้วได้ทุกเมื่อจากหน้าโปรไฟล์
  • เมื่อสร้าง token เจ้าของจะได้รับอีเมลแจ้ง เมื่อเปลี่ยนรหัสผ่าน token ทั้งหมดของผู้ใช้นั้นจะถูกลบ

ตั้งค่าในแอปเดสก์ท็อป Claude

  1. 1เปิดSettings (การตั้งค่า) →Extensions (ส่วนขยาย) ในแอปเดสก์ท็อป Claude ลากไฟล์ส่วนขยายของ GeckoFlag (.mcpb) มาวาง แล้วคลิกInstall (ติดตั้ง) หรือติดตั้งด้วยการดับเบิลคลิกที่ไฟล์ หรือจากAdvanced settings (การตั้งค่าขั้นสูง) ก็ได้ ไฟล์ส่วนขยายรวมอยู่ในไฟล์ที่ท่านดาวน์โหลดได้หลังจากซื้อ GeckoFlag
  2. 2กรอกรายการต่อไปนี้ในหน้าการตั้งค่า แล้วคลิกSave (บันทึก)
    • GeckoFlag URL (จำเป็น): URL ที่จดไว้ ต้องขึ้นต้นด้วย https:// (ใช้ http:// ได้เฉพาะ localhost, *.test และ *.local)
    • API token (จำเป็น): token ที่คัดลอกไว้ จะถูกบันทึกแบบปิดบัง
    • Export folder (ไม่บังคับ): โฟลเดอร์สำหรับบันทึกไฟล์ Excel ของแผนภูมิ Gantt หากเว้นว่างไว้ จะบันทึกในโฟลเดอร์ดาวน์โหลด
    หน้าการตั้งค่าส่วนขยายของ GeckoFlag มีช่อง GeckoFlag URL, API token และ Export folder
  3. 3ขอให้ Claude “ตรวจสอบว่าเชื่อมต่อกับ GeckoFlag ได้หรือไม่” หากแสดงเจ้าของ token เวอร์ชันของ GeckoFlag และบอกว่าเขียนได้หรือไม่ ถือว่าเสร็จสิ้น

ขั้นตอนโดยละเอียดพร้อมภาพหน้าจอ ดูได้ที่ขั้นตอนการใช้งานการเชื่อมต่อ Claude แนะนำให้ตั้งค่าการดำเนินการเขียนเป็น “ยืนยันทุกครั้ง” ในการตั้งค่าส่วนขยายของ Claude

สิ่งที่ทำได้

  • งาน: ค้นหา (โปรเจกต์ สถานะ ผู้รับผิดชอบ ผู้สร้าง ลำดับความสำคัญ คำค้น วันครบกำหนด งานหลัก) ดูรายละเอียดและความคิดเห็น สร้าง (ระบุงานหลักและผู้รับการแจ้งเตือนได้) แก้ไขรายการ โพสต์ความคิดเห็น และเปลี่ยนสถานะ
  • โปรเจกต์: ดูรายการและรายละเอียด สร้าง (ทุกคนยกเว้นแขก) เปลี่ยนชื่อ คำอธิบาย เจ้าของ และช่วงเวลา สลับสถานะเสร็จสิ้น/ยังไม่เสร็จ และเพิ่มหรือนำสมาชิกออก (เจ้าของและผู้ดูแลระบบ)
  • Wiki: ดู เขียนชื่อเรื่องและเนื้อหาใหม่ และเพิ่มต่อท้าย (สมาชิกของโปรเจกต์และผู้ดูแลระบบ)
  • โน้ต: ดูรายการ ค้นหา ดู สร้าง เขียนใหม่ และเพิ่มต่อท้ายโน้ตของตนเอง
  • ข้อมูลหลัก: เพิ่มประเภทงาน สถานะ ลำดับความสำคัญ และตำแหน่ง (แผนก) รวมถึงเปลี่ยนชื่อและสี (ผู้ดูแลระบบ)
  • แผนภูมิ Gantt: แปลงงานของโปรเจกต์ (สูงสุด 5,000 รายการ) เป็นไฟล์ Excel แล้วบันทึกลงในคอมพิวเตอร์ หากช่วงเวลาเกิน 120 วัน จะเป็น 1 คอลัมน์ = 1 สัปดาห์
  • ค้นหาผู้ใช้: ค้นหาผู้ใช้จากชื่อ (เฉพาะ ID และบทบาท ไม่ส่งคืนที่อยู่อีเมล)

ระบุงานได้ด้วยรหัส เช่น “WEB-12” การเขียนต้องมีทั้ง token แบบ “อ่านและเขียน” และ “อนุญาตการเขียน” ของเว็บไซต์

สิ่งที่ทำไม่ได้และขีดจำกัด

  • ไม่สามารถลบ (โปรเจกต์ งาน ความคิดเห็น ข้อมูลหลัก Wiki โน้ต) แก้ไขความคิดเห็น แนบหรือดูรูปภาพและไฟล์ เปลี่ยนรหัสโปรเจกต์ หรือจัดลำดับข้อมูลหลักได้
  • ไม่สามารถเพิ่มหรือแก้ไขผู้ใช้ เปลี่ยนการตั้งค่าเว็บไซต์ ใช้งานกระดาน Kanban บุ๊กมาร์ก หรือการตั้งค่าการแจ้งเตือน หรือดูโน้ตของผู้ใช้อื่น (แม้แต่ผู้ดูแลระบบก็ทำไม่ได้)
  • การเขียนทำครั้งละ 1 รายการ หากมีหลายรายการ Claude จะดำเนินการทีละรายการ รอการตอบกลับได้ 30 วินาที และการเขียนจะไม่ลองใหม่อัตโนมัติเพื่อป้องกันการบันทึกซ้ำ
  • ชื่องานไม่เกิน 50 ตัวอักษร ชื่อข้อมูลหลักไม่เกิน 20 ตัวอักษร (ประเภทละไม่เกิน 10 รายการ สีเลือกได้จาก 8 สี) เนื้อหา Wiki รวมไม่เกิน 65,535 ไบต์ และเนื้อหาโน้ตไม่เกิน 1,000,000 ไบต์
  • เนื้อหาที่ Claude อ่านจะถูกตัดทอนเมื่อคำอธิบาย Wiki หรือโน้ตยาวเกิน 8,000 ตัวอักษร หรือความคิดเห็นยาวเกิน 2,000 ตัวอักษร Claude จะไม่เขียนเนื้อหาที่ถูกตัดทอนกลับคืน แต่จะแนะนำให้เพิ่มต่อท้ายแทน
  • การค้นหาและรายการแสดงได้สูงสุด 50 รายการต่อหน้า ขีดจำกัดจำนวนครั้งคือ 60 ครั้งต่อนาทีต่อ token
  • ใช้ได้เฉพาะเมื่อแอปเดสก์ท็อป Claude เปิดอยู่บนคอมพิวเตอร์

ประวัติและอีเมลแจ้งเตือน

  • การแก้ไขรายการของงานจะไม่บันทึกความคิดเห็นประวัติและไม่ส่งอีเมล เหมือนการแก้ไขในหน้าจอ หากต้องการเก็บประวัติ ให้ขอว่า “เปลี่ยนผ่านความคิดเห็น”
  • เมื่อเปลี่ยนสถานะหรือค่าอื่นผ่านความคิดเห็น ระบบจะบันทึกประวัติเหมือนในหน้าจอ และส่งอีเมลถึงสมาชิกที่รับการแจ้งเตือนความคิดเห็นทั้งหมด
  • เมื่อสร้างงาน อีเมลจะส่งถึงเฉพาะสมาชิกที่ระบุเป็นผู้รับการแจ้งเตือน เมื่อสร้างโปรเจกต์ สมาชิกจะได้รับอีเมลเชิญ (ไม่ส่งเมื่อเพิ่มสมาชิกภายหลัง)
  • การดำเนินการจะถูกบันทึกเป็นการดำเนินการของเจ้าของ token และไม่มีการแสดงว่า “ผ่าน Claude”

ความปลอดภัยและการจัดการข้อมูล

เมื่อปิดการเชื่อมต่อ Claude API จะถูกจัดการเหมือน URL ที่ไม่มีอยู่ (404) โปรเจกต์และงานที่ไม่มีสิทธิ์ก็จะถูกถือว่า “ไม่มีอยู่” เช่นกัน เซิร์ฟเวอร์เก็บ token ไว้เฉพาะค่าแฮช และการจำกัดการเข้าถึงตามที่อยู่ IP ของ GeckoFlag มีผลกับ API ด้วย เนื้อหาของงาน Wiki และโน้ตที่ Claude อ่านจะถูกส่งไปยัง Anthropic เป็นส่วนหนึ่งของการสนทนา ก่อนเริ่มใช้งาน โปรดตรวจสอบว่ากฎภายในองค์กรหรือสัญญากับคู่ค้าไม่ได้จำกัดการส่งข้อมูลไปยังบริการภายนอก หากเชื่อมต่อไม่ได้ ดูที่เมื่อใช้งานไม่ได้