MCP
ใช้ Mailera ใน VS Code
เพิ่ม Mailera ใน .vscode/mcp.json เพื่อให้ Copilot Chat ในโหมด Agent เข้าถึงกล่องจดหมายของคุณได้ VS Code จะถาม API key เมื่อใช้ครั้งแรกและจัดเก็บเป็นข้อมูลลับ จึงไม่มีคีย์อยู่ในไฟล์กำหนดค่า
เอกสารทางการของ VS Codeก่อนเริ่มต้น
- สร้างเวิร์กสเปซฟรีและเชื่อมต่อกล่องจดหมายอย่างน้อยหนึ่งบัญชี
- ไปที่การตั้งค่า → API key สร้างคีย์แล้วเลือกสิทธิ์ โดยสิทธิ์ read ก็เพียงพอสำหรับเริ่มต้น
- คัดลอกคีย์ทันทีที่สร้าง — Mailera จะแสดงคีย์แบบเต็มเพียงครั้งเดียว
การตั้งค่า
- สร้าง .vscode/mcp.json ในเวิร์กสเปซ หรือเรียกใช้ MCP: Open User Configuration เพื่อใช้กับทุกเวิร์กสเปซ
- วางการกำหนดค่าด้านล่าง เมื่อเรียกใช้ครั้งแรก VS Code จะถาม API key ของ Mailera และจัดเก็บเป็นข้อมูลลับ
- เปิด Chat ในโหมด Agent แล้วคลิกไอคอนเครื่องมือ เครื่องมือของ mailera ควรปรากฏในรายการ
.vscode/mcp.json
{ "inputs": [ { "type": "promptString", "id": "mailera-api-key", "description": "Mailera API key", "password": true } ], "servers": { "mailera": { "type": "http", "url": "https://mailera.app/api/public/v1/mcp", "headers": { "Authorization": "Bearer ${input:mailera-api-key}" } } }}ไฟล์นี้ไม่มีคีย์ จึงคอมมิตให้ทั้งทีมใช้ร่วมกันได้ โดยแต่ละคนป้อนคีย์ของตนเอง
ตรวจสอบการเชื่อมต่อ
สั่งเอเจนต์ว่า “แสดงรายการกล่องจดหมาย Mailera ของฉัน” เอเจนต์จะเรียก list_mailboxes และแสดงกล่องจดหมายพร้อมสถานะการซิงค์ จากนั้นลองสั่งว่า “ค้นหาอีเมลล่าสุดจาก noreply@… แล้วดึง OTP”
รายการเครื่องมือและแนวทางความปลอดภัยข้อผิดพลาดที่พบบ่อย
- 401 unauthorized
- คีย์ไม่ถูกต้อง ถูกเพิกถอน หรือขาด Bearer ส่วนหัวต้องเป็น Authorization: Bearer mh_live_…
- ไม่พบ send_email หรือ rescue_spam
- คีย์ไม่มีสิทธิ์ที่จำเป็น (send, move) Mailera จะแสดงเฉพาะเครื่องมือที่ตรงกับสิทธิ์ของคีย์ — สร้างคีย์ใหม่พร้อมสิทธิ์ที่ต้องการ
- เอเจนต์ไม่พบกล่องจดหมาย
- คีย์ถูกจำกัดให้ใช้กับกลุ่มที่ไม่มีกล่องจดหมาย หรือเวิร์กสเปซยังไม่ได้เชื่อมต่อกล่องจดหมายใดๆ
- 429 rate_limited
- คีย์นี้ส่งคำขอเกิน 300 ครั้งต่อนาที รอตามจำนวนวินาทีที่ระบุใน Retry-After แล้วลองอีกครั้ง
ใช้ Mailera ใน VS Code
ไปที่การตั้งค่า → API key สร้างคีย์แล้วเลือกสิทธิ์ โดยสิทธิ์ read ก็เพียงพอสำหรับเริ่มต้น