# MCP · ใช้ blockwallets ได้จากเครื่องมือ AI ของคุณ

> เซิร์ฟเวอร์ MCP ระยะไกลของ blockwallets: ค้นเอกสารการเชื่อมต่อ สร้างใบแจ้งหนี้ทดสอบ ตรวจคำสั่งซื้อและยอดคงเหลือได้จาก Claude, ChatGPT, Cursor และ Codex ไม่มีเครื่องมือใดโอนเงินออกได้

ให้ Claude, ChatGPT, Cursor และ Codex อ่านเอกสาร สร้างใบแจ้งหนี้ทดสอบ และตรวจคำสั่งซื้อแทนคุณ ทำได้แค่รับเงินและอ่านข้อมูล โอนเงินออกไม่ได้

## สองที่อยู่

- `https://blockwallets.io/mcp` (ต้องเข้าสู่ระบบ): เข้าสู่ระบบด้วย OAuth หรือใช้โทเค็น MCP (Bearer) จากแดชบอร์ด ใช้ได้ทุกเครื่องมือ
- `https://blockwallets.io/mcp/public` (ไม่ต้องเข้าสู่ระบบ): เฉพาะเครื่องมือสาธารณะ: เอกสาร เครือข่าย ราคา คำอธิบายลายเซ็น และรายการตรวจสำหรับการเชื่อมต่อ

## สรุปสั้น ๆ: เชื่อมต่อ ดีบัก และดูบัญชีได้ใน AI

- ระหว่างเขียนโค้ดเชื่อมต่อ AI อ่านเอกสารและกฎลายเซ็นของเราได้เอง ไม่ต้องคัดลอกวาง
- ด้วยโทเค็นทดสอบ AI สร้างใบแจ้งหนี้ทดสอบ คุณจำลองการชำระ แล้ว AI ตรวจสถานะตั้งแต่ต้นจนจบ
- ในงานประจำวัน แค่ถามว่า “เมื่อวานรับเงินได้เท่าไร” หรือ “order_1042 จ่ายแล้วหรือยัง” ก็ได้คำตอบ

## คัดลอกโค้ดหนึ่งส่วน ไปวางในเครื่องมือของคุณ

สร้างโทเค็นที่ “นักพัฒนา › เครื่องมือ AI (MCP)” ในแดชบอร์ด โทเค็นแสดงเพียงครั้งเดียว เริ่มจากโทเค็นทดสอบก่อน

### Claude Code

ใช้โทเค็น หรือเอา --header ออกแล้วรัน /mcp ใน Claude Code เพื่อเข้าสู่ระบบด้วย OAuth

```bash
claude mcp add --transport http blockwallets https://blockwallets.io/mcp \
  --header "Authorization: Bearer bw_mcp_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
```

### Claude Code · เฉพาะเครื่องมือเอกสาร (ไม่ต้องเข้าสู่ระบบ)

```bash
claude mcp add --transport http blockwallets-docs https://blockwallets.io/mcp/public
```

### Cursor · ~/.cursor/mcp.json

```json
{
  "mcpServers": {
    "blockwallets": {
      "url": "https://blockwallets.io/mcp",
      "headers": {
        "Authorization": "Bearer bw_mcp_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}
```

### Windsurf · ~/.codeium/windsurf/mcp_config.json

```json
{
  "mcpServers": {
    "blockwallets": {
      "serverUrl": "https://blockwallets.io/mcp",
      "headers": {
        "Authorization": "Bearer bw_mcp_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}
```

### Codex · ~/.codex/config.toml

ใส่โทเค็นในตัวแปรสภาพแวดล้อม BLOCKWALLETS_MCP_TOKEN ต้องใช้ Codex รุ่นใหม่ที่รองรับ MCP ผ่าน HTTP

```toml
[mcp_servers.blockwallets]
url = "https://blockwallets.io/mcp"
bearer_token_env_var = "BLOCKWALLETS_MCP_TOKEN"
```

## Claude และ ChatGPT: แค่เข้าสู่ระบบ

### Claude (เว็บ / เดสก์ท็อป)

1. การตั้งค่า → ตัวเชื่อมต่อ → เพิ่มตัวเชื่อมต่อแบบกำหนดเอง
2. ตั้งชื่อ blockwallets และใช้ URL https://blockwallets.io/mcp
3. กดเชื่อมต่อ แล้วเข้าสู่ระบบแดชบอร์ด blockwallets ในหน้าที่เปิดขึ้น
4. ในหน้าขอความยินยอม เลือกโหมดทดสอบหรือใช้งานจริง และจะอนุญาตให้สร้างใบแจ้งหนี้หรือไม่ แล้วกดอนุญาต

### ChatGPT

1. การตั้งค่า → แอปและตัวเชื่อมต่อ → ขั้นสูง เปิดโหมดนักพัฒนา
2. สร้างตัวเชื่อมต่อด้วย URL https://blockwallets.io/mcp และการยืนยันตัวตนแบบ OAuth
3. เข้าสู่ระบบแดชบอร์ด blockwallets
4. เลือกโหมดและสิทธิ์ในหน้าขอความยินยอม แล้วกดอนุญาต

ไม่อยากเข้าสู่ระบบ? ใช้ https://blockwallets.io/mcp/public เพื่อใช้เฉพาะเครื่องมือเอกสารสาธารณะ

## 11 เครื่องมือ ไม่มีอันไหนโอนเงินออกได้

| เครื่องมือ | ทำอะไร | สิทธิ์ |
|---|---|---|
| `search_docs` | ค้นในเอกสารการเชื่อมต่อ ส่งกลับส่วนที่เกี่ยวข้องพร้อมลิงก์ | สาธารณะ |
| `get_doc` | อ่านเอกสารหนึ่งหัวข้อในรูปแบบ Markdown | สาธารณะ |
| `list_networks` | เหรียญและเครือข่าย จำนวนการยืนยัน และยอดขั้นต่ำ | สาธารณะ |
| `get_pricing` | ค่าธรรมเนียมและขั้นตามยอด | สาธารณะ |
| `explain_signature` | อธิบายการคำนวณลายเซ็นทีละขั้น (ไม่รับ API key) | สาธารณะ |
| `integration_checklist` | ขั้นตอนการเชื่อมต่อและรายการตรวจรับตามเทคโนโลยีที่คุณใช้ | สาธารณะ |
| `create_payment` | สร้างใบแจ้งหนี้และส่งหน้าชำระเงินกลับ (idempotent ตาม order_id) | payments:create |
| `create_payment_link` | สร้างลิงก์ชำระเงินและคิวอาร์โค้ด | payments:create |
| `get_payment` | อ่านใบแจ้งหนี้หนึ่งใบตาม order_id หรือ uuid | read |
| `list_payments` | แสดงรายการใบแจ้งหนี้ตามสถานะและวันที่ | read |
| `get_balance` | อ่านยอดคงเหลือจริง (อ่านอย่างเดียว ถอนไม่ได้) | read |

## รับได้อย่างเดียว ส่งออกไม่ได้

- **ไม่มีเครื่องมือโอนเงินออก**: การถอน การจ่ายออก การคืนเงิน ที่อยู่ถอน URL callback และคีย์ ไม่มีใน MCP และไม่มีสิทธิ์สำหรับสิ่งเหล่านี้ คุณทำได้เองในแดชบอร์ดเท่านั้น
- **เริ่มจากโหมดทดสอบ**: ข้อมูลรับรองทดสอบสร้างใบแจ้งหนี้ได้บนเทสต์เน็ตเท่านั้นและเห็นแค่ข้อมูลทดสอบ ไม่เกี่ยวกับเงินจริง
- **ให้โหมดจริงอ่านอย่างเดียว**: ข้อมูลรับรองโหมดจริงเห็นคำสั่งซื้อและยอดจริง ให้สิทธิ์อ่านอย่างเดียวหากไม่ต้องสร้างใบแจ้งหนี้ บัญชีที่เปิดยืนยันตัวตนสองขั้นต้องกรอกรหัสเมื่อสร้างข้อมูลรับรองโหมดจริง และเราจะส่งอีเมลแจ้งทุกครั้ง
- **ยกเลิกได้ทุกเมื่อ**: โทเค็นและการอนุญาต OAuth อยู่ในรายการเดียวกันในแดชบอร์ด ยกเลิกเมื่อไร โทเค็นนั้นหยุดทำงานทันที
- **เก็บแค่ค่าแฮช**: โทเค็นและรหัสเก็บเป็น sha256 โทเค็นแสดงครั้งเดียว ทุกการเรียกของร้านค้าถูกบันทึกเพื่อตรวจสอบ และแต่ละข้อมูลรับรองจำกัด 60 คำขอต่อนาที

## คำถามที่พบบ่อย

### MCP คืออะไร?

Model Context Protocol มาตรฐานเปิดที่ให้เครื่องมือ AI เรียกใช้บริการภายนอก เมื่อเชื่อมต่อแล้ว Claude, ChatGPT, Cursor และอื่น ๆ เรียกเครื่องมือของ blockwallets ได้โดยตรง

### AI ใช้มันเอาเงินของฉันไปได้ไหม?

ไม่ได้ ไม่มีเครื่องมือสำหรับถอน จ่ายออก คืนเงิน หรือเปลี่ยนที่อยู่และคีย์ และไม่มีสิทธิ์สำหรับการกระทำเหล่านั้น

### โหมดทดสอบกับโหมดจริงต่างกันอย่างไร?

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

### Cursor เข้าสู่ระบบด้วย OAuth ได้ไหม?

ตอนนี้ใน Cursor ให้ใช้โทเค็นจากแดชบอร์ด OAuth ใช้ได้กับไคลเอนต์ที่เปลี่ยนเส้นทางแบบ https หรือ loopback เช่น Claude, ChatGPT และ Claude Code

### ยกเลิกสิทธิ์เข้าถึงอย่างไร?

หาโทเค็นหรือการอนุญาตนั้นที่ “นักพัฒนา › เครื่องมือ AI (MCP)” ในแดชบอร์ด แล้วกดยกเลิก มีผลทันที

OAuth metadata: https://blockwallets.io/.well-known/oauth-protected-resource · https://blockwallets.io/.well-known/oauth-authorization-server