ข้ามไปที่เนื้อหา

สำหรับผู้ใช้ Warp

เอเจนต์ของ Warp อยู่ในเทอร์มินัล ให้แผนที่ของรีโพกับมัน

เอเจนต์ของ Warp รันคำสั่งและอ่านสิ่งที่พิมพ์ออกมา Maguyva ทำดัชนีทั้งรีโพแล้วส่งให้ผ่าน MCP เอเจนต์จึงถามได้ว่าโค้ดอยู่ที่ไหน แทนที่จะรัน grep กับ cat ไปเรื่อย ๆ จนกว่าจะเจอ

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

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

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

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

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

~/.warp/.mcp.json

Warp เริ่มเซิร์ฟเวอร์ในไฟล์ส่วนกลางนี้ให้เอง คุณยังวาง JSON เดียวกันใน Settings → Agents → MCP servers → + Add ได้ด้วย

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

ระยะไกลผ่าน URL

รายการ url เชื่อมต่อผ่าน Streamable HTTP หรือ SSE ไม่มีอะไรรันบนเครื่องและไม่ต้องใช้ Node.js

// คีย์

เฮดเดอร์แบบตรงตัว

คีย์ใส่ลงในเฮดเดอร์ Authorization โดยตรง เก็บไว้ในไฟล์ส่วนกลาง ไม่ใช่ใน .warp/.mcp.json ของโปรเจกต์ที่คุณ commit

// ไฟล์ของโปรเจกต์

ไม่เริ่มเองอัตโนมัติ

Warp ตรวจพบ .warp/.mcp.json ในรีโพที่โคลนมา แต่จะรอให้คุณเริ่มเซิร์ฟเวอร์แต่ละตัวเอง และอ่านเซิร์ฟเวอร์จากคอนฟิกของ Claude Code และ Codex ได้ด้วยเมื่อคุณเปิดตัวเลือกนั้น

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

# AGENTS.md
- รัน make test ก่อนจะบอกว่าการแก้ไขเสร็จแล้ว
- ใช้สคริปต์ใน bin/ ไม่ใช่คำสั่งเฉพาะกิจ

Warp อ่านกฎของโปรเจกต์จาก AGENTS.md (หรือ WARP.md ซึ่งมีลำดับก่อนถ้ามีทั้งสองไฟล์) และใช้กฎส่วนกลางทุกที่ ใช้สำหรับ:

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

กฎบอกเอเจนต์ว่าควรทำงานอย่างไร แต่บอกไม่ได้ว่าเซอร์วิสไหนยังอ่านตัวแปรสภาพแวดล้อมที่คุณกำลังจะลบอยู่

เมื่อ grep ในเทอร์มินัลไม่พอ

สามสิ่งที่เซสชันเชลล์เรียนรู้ได้ไม่ถูก

// เอาต์พุตไหลผ่านไป

ทุก grep และ cat ที่เอเจนต์รันจะไปอยู่ในบทสนทนา การค้นหาที่พิมพ์ออกมาสองร้อยบรรทัดใช้บริบทหมดก่อนงานจริงจะเริ่ม

// ที่ตรงกันไม่ใช่ผู้เรียก

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

// เชลล์เริ่มจากศูนย์

เซสชันใหม่ไม่รู้อะไรเกี่ยวกับรีโพเลย ดัชนีของ Maguyva สร้างไว้แล้ว คำถามแรกจึงได้คำตอบที่จัดอันดับทันที

Maguyva ในฐานะเซิร์ฟเวอร์ MCP ของ Warp

รายการ mcpServers เดียวให้เอเจนต์ของ Warp ได้:

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

Warp ให้ เทอร์มินัล แก่เอเจนต์

Maguyva มอบแผนที่ของโค้ดให้เอเจนต์

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

ถามแผนที่ก่อน แล้วค่อยรันคำสั่ง

// workflow 01

ตามหาต้นตอของสคริปต์ที่ล้มเหลว

warp agent> deploy.sh ล้มเหลว: ไม่ได้ตั้งค่า BUILD_ID ตั้งค่าไว้ที่ไหน?

text_pattern_search("BUILD_ID=")
  ci/env.sh:9   export BUILD_ID=...
  docs/deploy.md:31   ← ข้อความ

→ เอเจนต์ source ไฟล์ ci/env.sh แล้วรันการดีพลอยใหม่
[exit 0]

การค้นหาในดัชนีครั้งเดียวแทน grep แบบเรียกซ้ำทั่วรีโพและเอาต์พุตทั้งหมดของมัน

// workflow 02

ตรวจผู้เรียกก่อนเปลี่ยนขั้นตอนตอนบูต

warp agent> เลิกรัน migration ตอนสตาร์ตได้ไหม?

dependency_search("runMigrations", dependents)
  ผู้เรียก 3 ราย: server.ts, worker.ts, scripts/seed.ts

→ เอเจนต์ย้ายทั้งสามไปไว้ในขั้นตอน release
[exit 0]

ผู้เรียกมาถึงก่อนการเปลี่ยนแปลง worker จึงไม่บูตขึ้นมากับสคีมาเก่า

ตั้งค่าใน Warp

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

  1. // step 01

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

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

  2. // step 02

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

    ~/.warp/.mcp.json

    {
      "mcpServers": {
        "maguyva": {
          "url": "https://maguyva.tools/mcp",
          "headers": {
            "Authorization": "Bearer mgv_xxxx"
          }
        }
      }
    }
  3. // step 03

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

    เปลี่ยน mgv_xxxx เป็นคีย์ API ของคุณแล้วบันทึก ตรวจว่าเซิร์ฟเวอร์ทำงานอยู่ใน Settings → Agents → MCP servers แล้วถามหนึ่งคำถามที่คุณรู้คำตอบอยู่แล้ว