Dvina MCP

ใช้ Dvina จากแอปอื่นผ่าน MCP

เชื่อมต่อไคลเอนต์ MCP เช่น Claude Code, ChatGPT หรือ Cursor กับ Dvina แล้วลงชื่อเข้าใช้ เพื่อให้ไคลเอนต์อ่านและเพิ่มข้อมูลใน Dvina ของคุณได้เมื่อคุณอนุญาต

ดูเป็น Markdown

Dvina มีเซิร์ฟเวอร์ MCP ของตัวเอง เมื่อเชื่อมต่อไคลเอนต์ MCP เช่น Claude Code, ChatGPT หรือ Cursor แอปนั้นจะค้นหาใน Dvina ของคุณ อ่านเอกสารและความจำ รวมถึงเพิ่มโน้ต งาน และการเตือนความจำในนามของคุณได้

ก่อนเริ่มต้น

คุณต้องมีที่อยู่ของเซิร์ฟเวอร์:

https://api.dvina.ai/mcp

หากบริษัทของคุณใช้งาน Dvina บนเซิร์ฟเวอร์ของบริษัทเอง ให้ใช้ที่อยู่ Dvina API ของบริษัทโดยเติม /mcp ต่อท้าย ขอที่อยู่นี้ได้จากผู้ดูแลระบบของคุณ

เซิร์ฟเวอร์ใช้ Streamable HTTP หากไคลเอนต์ให้เลือกวิธีการรับส่งข้อมูล ให้เลือก HTTP

เชื่อมต่อไคลเอนต์

Claude Code

  1. เรียกใช้คำสั่งนี้ในเทอร์มินัล:

    claude mcp add --transport http dvina https://api.dvina.ai/mcp

  2. เปิด Claude Code เรียกใช้ /mcp เลือก dvina แล้วลงชื่อเข้าใช้ Dvina

ChatGPT

  1. เปิดส่วนที่ให้คุณเพิ่มเซิร์ฟเวอร์ MCP ใน ChatGPT
  2. ป้อน https://api.dvina.ai/mcp เป็นที่อยู่เซิร์ฟเวอร์ และเลือก OAuth หากระบบถามว่าจะลงชื่อเข้าใช้ด้วยวิธีใด
  3. ลงชื่อเข้าใช้ Dvina เมื่อ ChatGPT ขอ

Cursor

  1. Open the place where Cursor lets you add an MCP server.
  2. Add a server named dvina with the address https://api.dvina.ai/mcp.
  3. Sign in to Dvina when Cursor asks.

คุณไม่จำเป็นต้องมี client ID หรือ secret ไคลเอนต์จะลงทะเบียนกับ Dvina เองเมื่อเชื่อมต่อครั้งแรก

ลงชื่อเข้าใช้

เซิร์ฟเวอร์ MCP ของ Dvina ให้คุณลงชื่อเข้าใช้ด้วย OAuth ผ่านเบราว์เซอร์:

  1. ลงชื่อเข้าใช้ Dvina ตามปกติ
  2. หากคุณอยู่ในพื้นที่ทำงานมากกว่าหนึ่งแห่ง ให้เลือกพื้นที่ทำงานหนึ่งแห่งใน เลือกพื้นที่ทำงาน แล้วเลือก ดำเนินการต่อ ไคลเอนต์จะทำงานในพื้นที่ทำงานนั้นเท่านั้น
  3. ใน อนุญาตการเข้าถึง ให้ตรวจสอบชื่อแอป แล้วเลือก อนุญาตให้เข้าถึง หากคุณไม่รู้จักแอปนั้น ให้เลือก ปฏิเสธ

ไคลเอนต์จะยังคงเชื่อมต่ออยู่ คุณจึงไม่ต้องลงชื่อเข้าใช้ทุกครั้ง

สิ่งที่ไคลเอนต์ทำได้

ไคลเอนต์เห็นเครื่องมือของ Dvina และใช้เครื่องมือเหล่านั้นเมื่อจำเป็นสำหรับคำขอของคุณ:

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

ไคลเอนต์ไม่สามารถลบสิ่งใดอย่างถาวร เปิดลิงก์สาธารณะ เชื่อมต่อหรือยกเลิกการเชื่อมต่อแอป หรือเปลี่ยนการตั้งค่าผู้ดูแลระบบหรือการเรียกเก็บเงินได้

อนุมัติการเปลี่ยนแปลง

การทำงานของไคลเอนต์เป็นไปตามกฎเดียวกับส่วนอื่น ๆ ใน Dvina:

  • การอ่านจะทำได้โดยไม่ต้องถามคุณก่อน
  • การเพิ่มสิ่งใหม่ เช่น โน้ต ไฟล์ความจำ หรืองาน จะทำได้โดยไม่ต้องถามคุณก่อน และจะไม่เปลี่ยนสิ่งที่มีอยู่แล้ว
  • การเปลี่ยนแปลงหรือนำสิ่งใดออก เช่น การย้ายเอกสารไปที่ถังขยะ การเขียนหน้าแคนวาสใหม่ การหยุดงาน หรือการแชร์รายการ จะถามคุณก่อน ไคลเอนต์จะแสดงสรุปการเปลี่ยนแปลงที่ Dvina จัดทำขึ้น แล้วให้คุณอนุมัติหรือปฏิเสธ หากคุณปฏิเสธ จะไม่มีการเปลี่ยนแปลงใด ๆ

หมายเหตุ

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

สิทธิ์เข้าถึงของคุณและกฎของบริษัท

ไคลเอนต์ทำงานในนามของคุณ โดยเข้าถึงและทำได้เฉพาะสิ่งที่คุณเข้าถึงและทำได้ใน Dvina:

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

เชื่อมต่อด้วยคีย์ API แทน OAuth

ในแผน Enterprise ไคลเอนต์สามารถเชื่อมต่อด้วยโทเค็นการเข้าถึงส่วนบุคคลแทนการลงชื่อเข้าใช้ได้ ใช้วิธีนี้กับไคลเอนต์ที่ลงชื่อเข้าใช้ด้วย OAuth ไม่ได้ หรือกับสคริปต์

  1. เปิดการตั้งค่า แล้วเลือก การเข้าถึง API
  2. ใต้ โทเค็นการเข้าถึงส่วนบุคคล ให้เลือก สร้างโทเค็น
  3. ป้อน ชื่อ เลือก สิทธิ์เข้าถึง และเวลาที่ หมดอายุ แล้วเลือก สร้างโทเค็น
  4. ใต้ คัดลอกโทเค็นของคุณ ให้คัดลอกโทเค็น โทเค็นจะแสดงให้เห็นครั้งนี้เท่านั้น

เลือกสิทธิ์เข้าถึงที่ไคลเอนต์ต้องใช้:

  • อ่านอย่างเดียว: ไคลเอนต์จะเห็นเฉพาะเครื่องมือสำหรับอ่าน โดยค้นหาและอ่านข้อมูลใน Dvina ของคุณได้ แต่เพิ่มหรือเปลี่ยนแปลงสิ่งใดไม่ได้
  • อ่านและเขียน: ไคลเอนต์จะเห็นเครื่องมือทั้งหมด และการเปลี่ยนแปลงยังต้องขออนุมัติจากคุณ เช่นเดียวกับ OAuth

ส่งโทเค็นในเฮดเดอร์ Authorization ต่อจาก Bearer ตัวอย่างเช่น ใน Claude Code:

claude mcp add --transport http dvina https://api.dvina.ai/mcp --header "Authorization: Bearer <your token>"

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

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

ดูข้อมูลเพิ่มเติมเกี่ยวกับโทเค็นได้ที่การเข้าถึง API