สำหรับผู้ใช้ Claude Desktop

Claude Desktop มองไม่เห็นรีโพของคุณ ให้มันได้เห็นสักรีโพ

Claude Desktop คือที่ที่หลายคนถามเรื่องโค้ดที่ตัวเองไม่ได้กำลังแก้: การรีวิว การรับพนักงานใหม่ การประชุมแก้เหตุขัดข้อง Maguyva ทำดัชนีรีโพแล้วให้บริการผ่าน MCP คำตอบจึงอ้างอิงไฟล์และบรรทัดแทนความจำ

เริ่มใช้ฟรี อ่านวิธีตั้งค่ากับ Claude Desktop

แผน Free: รีโพซิทอรี 3 แห่ง, บรรทัดที่ทำดัชนีสูงสุด 50,000 บรรทัด ไม่ต้องใช้บัตรเครดิต

ไม่ต้องมีสำเนาในเครื่อง ถามดัชนีได้เลย

สิ่งที่ต้องรู้เกี่ยวกับ Claude Desktop

ข้อเท็จจริงสี่ข้อเฉพาะของ Claude Desktop

// ไฟล์คอนฟิก

claude_desktop_config.json

เปิดได้จาก Settings → Developer → Edit Config บน macOS ไฟล์อยู่ใน ~/Library/Application Support/Claude/ บน Windows อยู่ใน %APPDATA%\Claude\

// การรับส่งข้อมูล

บริดจ์ในเครื่อง

ไฟล์นี้เริ่มโปรเซสในเครื่อง คู่มือนี้จึงรัน @maguyva/mcp ผ่าน npx ต้องติดตั้ง Node.js

// คีย์

รายการ env หนึ่งรายการ

บริดจ์อ่าน MAGUYVA_API_KEY จากบล็อก env ของเซิร์ฟเวอร์ในไฟล์เดียวกัน

// รีสตาร์ต

ปิดแอป แล้วเปิดใหม่

Claude Desktop อ่านไฟล์ตอนเปิดแอป หลังแก้ไขให้ปิดแอปให้สนิท เซิร์ฟเวอร์จะเริ่มทำงานเมื่อเปิดครั้งถัดไป

คำสั่งของโปรเจกต์กำหนดกรอบการทำงาน ใช้มันให้เต็มที่

โปรเจกต์ของ Claude เก็บคำสั่งและไฟล์ที่ทุกแชตในโปรเจกต์ใช้เป็นจุดเริ่มต้น เหมาะสำหรับ:

คำตอบมีไว้สำหรับใคร: ผู้รีวิว พนักงานใหม่ วิศวกรที่อยู่เวร
สไตล์การเขียนสำหรับคำอธิบายและบทสรุป
เอกสารไม่กี่ฉบับที่คุณอยากให้อ้างอิง เช่น ภาพรวมสถาปัตยกรรม

ไฟล์ที่อัปโหลดคือสแนปช็อต หนึ่งวันหลังอัปโหลด รีโพก็เปลี่ยนไปแล้ว

เมื่อโค้ดที่วางไว้ไม่พอ

สามทางที่การคุยเรื่องโค้ดผิดพลาดเมื่อไม่มีตัวโค้ด

// โค้ดที่วางไว้ล้าสมัย

ไฟล์ที่วางลงแชตเมื่อสัปดาห์ก่อนอธิบายโค้ดของสัปดาห์ก่อน Claude ตอบอย่างมั่นใจจากเวอร์ชันที่ได้รับ

// โค้ดท่อนเดียวไม่ใช่ทั้งระบบ

ไฟล์เดียวแทบไม่เคยตอบได้ว่า “ถ้าสิ่งนี้ล้มเหลวจะเกิดอะไรขึ้น?” ตัวจัดการ การลองใหม่ และการแจ้งเตือนมักอยู่กันคนละแพ็กเกจ

// ไม่มีสำเนาในเครื่อง ก็ไม่มี grep

Claude Desktop ไม่มีสำเนาทำงานของรีโพคุณ หากไม่มีเครื่องมือ ทุกคำตอบเรื่องโครงสร้างขึ้นอยู่กับว่าคุณจำวางอะไรไว้บ้าง

Maguyva ในฐานะเซิร์ฟเวอร์ MCP ใน Claude Desktop

รายการ mcpServers เดียวให้สิ่งเหล่านี้แก่ Claude:

เครื่องมือ 11 รายการบนรีโพที่ทำดัชนีแล้วของคุณ การค้นหาเชิงความหมาย เชิงโครงสร้าง (AST) เชิงกราฟ และข้อความ รวมถึงการค้นหาสัญลักษณ์ ส่วนที่พึ่งพา และการดึงไฟล์
คำตอบพร้อมพาธไฟล์และหมายเลขบรรทัด ครอบคลุม 285+ ภาษา คุณจึงตรวจสอบทุกข้ออ้างได้
ผลลัพธ์ที่รับรู้แบรนช์ Claude จึงตอบเรื่องแบรนช์ที่คุณระบุ ไม่ใช่ไฟล์ที่ใครสักคนอัปโหลดไว้เมื่อเดือนก่อน

คำสั่งของโปรเจกต์บอก Claude ว่าต้องตอบอย่างไร
Maguyva มอบโค้ดที่ใช้เป็นฐานของคำตอบให้ Claude

สองเวิร์กโฟลว์

คำถามที่ปกติคุณต้องเปิด IDE เพื่อตอบ

// workflow 01

อธิบายเส้นทางของโค้ดระหว่างการรีวิว

claude> เกิดอะไรขึ้นหลัง webhook การชำระเงินไม่ผ่านการตรวจลายเซ็น?

semantic_search("webhook signature verification failure")
  src/payments/webhooks.ts:64   verifySignature()
  src/payments/webhooks.ts:91   rejectAndAlert()

→ Claude ตอบโดยอ้างอิงทั้งสองบรรทัด
[exit 0]

ทุกขั้นของคำตอบชี้ไปที่ไฟล์และบรรทัดที่คุณเปิดดูได้

// workflow 02

ประเมินขนาดของการเปลี่ยนแปลงก่อนวางแผน

claude> มีกี่จุดที่อ่านฟิลด์เก่า plan_code?

text_pattern_search("plan_code")
  พบ 14 รายการใน 9 ไฟล์
dependency_search("getPlanCode", dependents)
  ผู้เรียก 6 จุด

→ การประเมินเริ่มจากตัวเลข ไม่ใช่การเดา
[exit 0]

มีประโยชน์ในการประชุมวางแผน เมื่อไม่มีใครเปิดรีโพอยู่

ตั้งค่าใน Claude Desktop

สามขั้นตอน แผน Free: รีโพซิทอรี 3 แห่ง, บรรทัดที่ทำดัชนีสูงสุด 50,000 บรรทัด ไม่ต้องใช้บัตรเครดิต

// step 01

ทำดัชนีรีโพที่ maguyva.ai

เลือกรีโพที่คุณรู้จักอยู่แล้ว เพื่อให้คุณประเมินคำตอบได้

// step 02

เพิ่ม Maguyva ใน claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "-y",
        "@maguyva/mcp"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}

// step 03

แทนที่ตัวยึดตำแหน่ง รีสตาร์ต แล้วถามคำถามเดียว

เปลี่ยน mgv_xxxx เป็นคีย์ API ของคุณ ปิด Claude Desktop ให้สนิทแล้วเปิดใหม่ หากเซิร์ฟเวอร์ไม่ปรากฏ ให้อ่าน mcp-server-maguyva.log ในโฟลเดอร์ล็อกของ Claude (~/Library/Logs/Claude บน macOS)

เปิดให้สมัครใช้งานด้วยตนเองแล้ว

ทำดัชนีรีโพเดียวที่คุณรู้จักดีอยู่แล้ว

เชื่อมต่อ Claude Desktop ผ่าน MCP แล้วถามคำถามเดียวที่คุณตรวจสอบได้

อินเด็กซ์รีโพแรกของคุณ ดูเอกสารความเข้ากันได้