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

Canonical source: https://maguyva.ai/th/for-warp

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

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

> รายการ 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 ได้ด้วยเมื่อคุณเปิดตัวเลือกนั้น

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

```text
# 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 มอบ*แผนที่ของโค้ด*ให้เอเจนต์

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

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

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

```text
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 แบบเรียกซ้ำทั่วรีโพและเอาต์พุตทั้งหมดของมัน

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

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

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

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

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

## ตั้งค่าใน Warp

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

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

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

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

`~/.warp/.mcp.json`

```json
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}
```

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

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

[เอกสาร MCP](https://docs.warp.dev/agents/capabilities/mcp/) ของ Warp อธิบายเรื่องเซิร์ฟเวอร์จากไฟล์ การแชร์ และการยืนยันตัวตน

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

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