สำหรับผู้ใช้ VS Code

Copilot เห็นเวิร์กสเปซของคุณ Maguyva ทำแผนที่ทั้งรีโพ

เอเจนต์ใน VS Code อ่านไฟล์ที่คุณแนบและไฟล์ที่มันค้นเจอเอง Maguyva ทำดัชนีทั้งรีโพแล้วส่งให้ผ่าน MCP เอเจนต์จึงถามได้ว่าสัญลักษณ์อยู่ที่ไหนและใครเรียกใช้ ก่อนจะลงมือแก้

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

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

รายการ servers เดียวใน .vscode/mcp.json: URL หนึ่งรายการและเฮดเดอร์ Authorization หนึ่งรายการ

สิ่งที่ควรรู้เกี่ยวกับ VS Code

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

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

.vscode/mcp.json

เซิร์ฟเวอร์อยู่ใต้ servers ไม่ใช่ mcpServers หากต้องการใช้ในทุกเวิร์กสเปซ ให้รัน MCP: Open User Configuration แล้วเพิ่มรายการเดียวกันใน mcp.json ของโปรไฟล์คุณ

// การส่งผ่าน

type: http

VS Code เชื่อมต่อกับ endpoint ของ Maguyva ผ่าน Streamable HTTP และจะถอยไปใช้ SSE เฉพาะเมื่อเซิร์ฟเวอร์ไม่รองรับเท่านั้น ไม่มีอะไรรันบนเครื่อง

// คีย์

การอ้างอิงตัวแปรสภาพแวดล้อม

เฮดเดอร์เขียนว่า Bearer ${env:MAGUYVA_API_KEY} ซึ่ง VS Code อ่านค่าจากสภาพแวดล้อมที่ใช้เปิดโปรแกรม คีย์จึงไม่อยู่ในไฟล์ที่คุณ commit อยากให้ถามแทนไหม? ตัวแปรอินพุตจะถามครั้งเดียวแล้วเก็บคีย์ไว้

// ความเชื่อถือ

ความเชื่อถือพื้นที่ทำงาน

เซิร์ฟเวอร์ใน .vscode/mcp.json จะเริ่มทำงานโดยไม่ถามแยกเมื่อคุณเชื่อถือเวิร์กสเปซแล้ว และจะไม่เริ่มเลยในโหมดจำกัด ส่วน Configure Tools ในช่องแชตใช้เปิดหรือปิดเครื่องมือทีละตัว

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

# .github/copilot-instructions.md
- รัน npm test ก่อนจะบอกว่าการแก้ไขเสร็จแล้ว
- ห้ามแก้ไฟล์ที่ถูกสร้างอัตโนมัติใน src/gen/

VS Code อ่านคำสั่งระดับทั้งโปรเจกต์จาก .github/copilot-instructions.md หรือ AGENTS.md และคำสั่งเฉพาะจุดจากไฟล์ .github/instructions/*.instructions.md ที่มีแพตเทิร์น applyTo ใช้สำหรับ:

คำสั่ง build, test และ lint
ข้อตกลงที่เอเจนต์ทำผิดอยู่เรื่อย ๆ
โฟลเดอร์ที่เอเจนต์ไม่ควรแตะ

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

เมื่อมุมมองเวิร์กสเปซไม่พอ

สามสิ่งที่เอเจนต์เรียนรู้จากไฟล์ที่เปิดอยู่ไม่ได้

// สิ่งที่แนบมาไม่ใช่ทั้งหมด

เอเจนต์ทำงานจากสิ่งที่คุณแนบและสิ่งที่การค้นหาส่งกลับมา ผู้เรียกในอีกแพ็กเกจที่พังหลังการแก้ไขไม่เคยอยู่ในรายการไหนเลย

// ข้อความที่ตรงกันไม่ใช่การอ้างอิง

การค้นหาในเวิร์กสเปซเจอสตริง แต่แยกไม่ออกว่าเป็นการเรียกจริง คอมเมนต์ mock หรือเมธอดชื่อเดียวกันในคลาสอื่น

// ทุกการอ่านกินบริบท

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

Maguyva ในฐานะเซิร์ฟเวอร์ MCP ใน VS Code

รายการ servers เดียวให้เอเจนต์ได้:

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

VS Code ให้ เวิร์กสเปซของคุณ แก่เอเจนต์
Maguyva ให้ แผนที่ของรีโพ แก่เอเจนต์

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

ถามแผนที่ก่อน แล้วค่อยแก้ไข

// workflow 01

หาเทสต์ให้เจอก่อนแก้พาร์เซอร์

vscode agent> เทสต์ไหนบ้างที่เรียก parseConfig?

dependency_search("parseConfig", dependents)
  tests/config/parse.test.ts:12
  tests/cli/flags.test.ts:88

→ หลังแก้ไข เอเจนต์รันแค่สองไฟล์นี้ ไม่ใช่ทั้งชุดเทสต์
[exit 0]

คำตอบระบุไฟล์เทสต์สองไฟล์ที่ไปถึงพาร์เซอร์ เอเจนต์จึงตรวจการแก้ไขตรงจุดที่อาจพังได้

// workflow 02

ประเมินขนาดการเปลี่ยนชื่อก่อนแก้ครั้งแรก

vscode agent> เปลี่ยนชื่อ OrderStatus.PENDING เป็น OrderStatus.QUEUED

find_symbol("OrderStatus", references)
  23 การอ้างอิงใน 9 ไฟล์

→ เอเจนต์วางแผนแก้รอบเดียวทั้งเก้าไฟล์
[exit 0]

จำนวนการอ้างอิงมาถึงก่อนการแก้ไข ไม่ใช่หลังจากตัวตรวจไทป์ล้มเหลว

ตั้งค่าใน VS Code

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

// step 01

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

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

// step 02

เพิ่ม Maguyva ใน .vscode/mcp.json

.vscode/mcp.json

{
  "servers": {
    "maguyva": {
      "type": "http",
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MAGUYVA_API_KEY}"
      }
    }
  }
}

// step 03

ตั้งค่าคีย์แล้วเริ่มเซิร์ฟเวอร์

ตั้งค่า MAGUYVA_API_KEY ในสภาพแวดล้อมที่คุณใช้เปิด VS Code แล้วเริ่มเซิร์ฟเวอร์จากโค้ดเลนส์เหนือรายการของมัน ถามเอเจนต์หนึ่งคำถามที่คุณรู้คำตอบอยู่แล้ว

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

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

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

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