MCP server ทำอะไรได้บ้าง
MCP (Model Context Protocol) คือมาตรฐานเปิดที่แอป AI ใช้เรียกเครื่องมือภายนอก
พอเชื่อมต่อแล้ว ผู้ช่วย AI จะตัดสินใจเองว่าเมื่อไรควรเรียกเครื่องมือของเรา ลองบอกว่า “ขอไอคอน 3D หมาจิ้งจอกน่ารักๆ ทำไอคอนแอป” มันจะค้นหาในคลัง โชว์ตัวอย่างให้ดู แล้วส่งลิงก์ดาวน์โหลดหรือสร้างแบบใหม่ให้ได้ โดยไม่ต้องเปิดเว็บเลย
- ค้นหาไอคอนกว่า 12,000 ชิ้น ด้วยคำค้น หมวดหมู่ สไตล์ (realistic / isometric / clay) หรือ collection ที่คัดไว้
- มองเห็นไอคอนจริง: get_icon แนบรูปตัวอย่างไปด้วย ผู้ช่วยที่รองรับรูปภาพจะประเมินให้ได้
- ดาวน์โหลดไฟล์ 512px หรือต้นฉบับ และสร้างไอคอนใหม่ด้วย Studio โดยคิดเครดิตแบบเดียวกับบนเว็บทุกประการ
ค้นหาฟรี ที่เหลือเป็นของแพลน Studio search_icons ใช้ได้โดยไม่ต้องมีคีย์ (สูงสุด 100 ครั้ง/วัน) เชื่อมต่อแล้วลองได้ทันที ส่วน tool อื่น (รายละเอียด ดาวน์โหลด 512px/ต้นฉบับ การสร้างไอคอน ข้อมูลบัญชี) เป็นของแพลน Studio ต้องใช้ API key ส่วนตัวของบัญชี Studio (Settings → API keys) คีย์ของแพลน Free/Designer ใช้ได้แค่การค้นหา
Endpoint
URL เดียว ใช้ Streamable HTTP ไม่มี session ค้าง
client ที่รองรับ MCP ทุกตัวจะถาม URL ของ server ของเราคือ:
เปิด URL นี้ในเบราว์เซอร์จะเห็นการ์ด JSON บอกรายชื่อ tools ส่วน client จะคุยกับมันด้วย JSON-RPC ผ่าน POST เอง คุณไม่ต้องเรียกเองเลย
https://realisticicon.com/api/mcpเชื่อมต่อ client
สามขั้น ใช้เวลาประมาณหนึ่งนาที
- ถ้าอยู่บนแพลน Studio ให้สร้าง API key ที่ Settings → API keys แล้วคัดลอกไว้ (แสดงครั้งเดียว)
- เพิ่ม server ใน client ด้วย URL ด้านล่าง พร้อม header Authorization
- สั่งผู้ช่วย AI ให้หาไอคอน มันจะค้นพบ tools เองอัตโนมัติ
ทดสอบ: ถามว่า “มี tool อะไรจาก realisticicon บ้าง” ผู้ช่วยควรตอบรายชื่อ search_icons, get_icon และตัวอื่นๆ
# the key is required — MCP is part of the Studio plan
claude mcp add --transport http realisticicon https://realisticicon.com/api/mcp \
--header "Authorization: Bearer blu_live_YOUR_KEY"รันครั้งเดียวใน terminal ใส่ `--scope user` ถ้าอยากใช้ได้ทุกโปรเจกต์ เช็คสถานะด้วย `claude mcp list`
API key
คีย์ผูก server เข้ากับบัญชี Studio และเครดิตของคุณ
- เข้าสู่ระบบแล้วเปิด Settings → API keys
- กด Create key ตั้งชื่อ (เช่น “Claude Code”, “Cursor”) แล้วคัดลอกคีย์ คีย์ขึ้นต้นด้วย blu_live_ และแสดงเพียงครั้งเดียว
- ส่งเป็น header Authorization: Bearer blu_live_… ตอนเพิ่ม server
- หมุนเวียนหรือเพิกถอนได้จากหน้าเดิมทุกเมื่อ คีย์เก่าจะหยุดทำงานทันที
- คีย์ใช้เครดิตของคุณได้ (ดาวน์โหลด, สร้างไอคอน) ดูแลเหมือนรหัสผ่าน
- คีย์แก้ไขบัญชี ซื้อเครดิต หรือสร้างคีย์เพิ่มไม่ได้ สิ่งเหล่านั้นต้องล็อกอินผ่านเบราว์เซอร์
- มีคีย์ที่ใช้งานได้สูงสุด 10 ตัว แนะนำแยกคีย์ต่อเครื่องมือ จะได้เพิกถอนทีละตัวได้
Tools
สิ่งที่ผู้ช่วย AI เรียกได้ ทุก tool ตอบกลับทั้งข้อความอ่านง่ายและข้อมูลแบบมีโครงสร้าง
| Tool | ต้องใช้ | ทำอะไร | ลองพูดว่า |
|---|---|---|---|
search_icons | ไม่ต้อง | ค้นหาไอคอนด้วยคำค้น หมวดหมู่ สไตล์ ชนิด (image / video) หรือ collection ได้ผลลัพธ์ทีละหน้า พร้อม URL ตัวอย่าง 256px และลิงก์หน้าไอคอน | “หาไอคอน 3D แก้วกาแฟ สไตล์ clay ให้หน่อย” |
get_icon | API key | รายละเอียดเต็มของไอคอนหนึ่งชิ้น คำอธิบาย แท็ก prompt ที่ใช้สร้าง ขนาดที่มี พร้อมรูป 128px ให้ผู้ช่วยมองเห็น | “ขอดูอันที่สอง แล้วบอกว่ามีขนาดอะไรบ้าง” |
list_collections | API key | รายชื่อ collection ที่คัดไว้ (Christmas, Marketing essentials, …) เอาไปใส่ search_icons เพื่อไล่ดูได้ | “มี collection ตามธีมอะไรบ้าง” |
get_account | API key | แพลน ยอดเครดิต ขนาดดาวน์โหลดสูงสุด และรวมการสร้างด้วย Studio หรือไม่ | “เหลือเครดิตเท่าไร” |
download_icon | API key | URL ไฟล์ตรงที่ 256px (ฟรี), 512px หรือ PNG ต้นฉบับ หักเครดิตครั้งแรกที่ดาวน์โหลดไอคอนนั้นแบบความละเอียดสูง ดาวน์โหลดซ้ำฟรี | “ดาวน์โหลดหมาจิ้งจอกตัวนั้นที่ 512px” |
generate_icon | API key | สร้างไอคอนใหม่ 1–4 รูปจาก prompt ด้วย Studio ใช้ไอคอนในคลังเป็นตัวอ้างอิงสไตล์ได้ ได้ URL รูปและ prompt ที่ขยายแล้ว (ใช้เวลาราว 30–90 วินาที) | “สร้างไอคอน 3D แพนด้าแดงถือแก้วกาแฟ” |
list_generations | API key | รายการที่คุณสร้างด้วย Studio ล่าสุด พร้อม URL รูปและ prompt ผู้ช่วยจะได้หยิบของเดิมมาใช้แทนการเสียเครดิตสร้างซ้ำ | “ขอดูไอคอนที่ฉันสร้างไว้ครั้งก่อน” |
เครดิตและแพลน
กติกาเดียวกับบนเว็บ เพราะ MCP server เรียกโค้ดคิดเงินชุดเดียวกัน
- 256px หรือเล็กกว่า: ไม่หักเครดิต แต่ก็ยังต้องเรียกด้วยคีย์เหมือน tool อื่น
- 512px และต้นฉบับ: 1 เครดิตในครั้งแรกที่ดาวน์โหลดไอคอนนั้น (แพลน Studio 5 เครดิต) ดาวน์โหลดไอคอนเดิมซ้ำขนาดใดก็ฟรี
- การสร้างด้วย Studio: คิดต่อรูปตามอัตราของ Studio กันเครดิตไว้ก่อนรัน และคืนให้สำหรับรูปที่สร้างไม่สำเร็จ
- ถ้าเครดิตหมด tool จะบอกผู้ช่วย AI ให้พาคุณไปหน้า Billing แทนที่จะลองซ้ำ
- MCP ขายอยู่ในแถว Studio เท่านั้น: คีย์ของแพลน Free หรือ Designer เชื่อมต่อไม่ได้เลย แม้แต่การค้นหา ต้องอัปเกรดเป็น Studio ถึงจะเปิดใช้ server ได้
- 3D เป็นฟีเจอร์เบต้าของแพลน Studio: generate_icon ที่ kind เป็น "3d" จะถูกปฏิเสธในแพลนอื่น
| แพลน | ขนาดดาวน์โหลดสูงสุด | สร้างด้วย Studio |
|---|---|---|
| Studio | 1024px | รวมอยู่ในแพลน |
ตัวอย่างคำสั่ง
คำสั่งที่ใช้ได้ดีเมื่อเชื่อมต่อ server แล้ว
- “อยากได้ไอคอนแอปติดตามนิสัย ขอดูตัวเลือก 3D แบบ realistic 6 แบบ”search_icons → เห็นตัวอย่างในแชท → สั่งต่อว่า “อันที่สาม แต่เป็นสไตล์ isometric” เพื่อปรับ
- “สามอันนี้ อันไหนเข้ากับพื้นหลังสีกรมท่าที่สุด”get_icon ทีละอัน → ผู้ช่วยดูรูปจริงก่อนตอบ
- “ขอไฟล์ต้นฉบับของไอคอนหมาจิ้งจอกอาร์กติก”get_account (เช็คแพลน) → download_icon size=original → ได้ URL ไว้บันทึก
- “ทำไอคอน 3D จรวดสไตล์ clay ให้เหมือนสไตล์ของไอคอน cute-shiba-inu-icon”generate_icon พร้อม referenceIconIds → ได้ PNG ใหม่ และบันทึกในประวัติ Studio ด้วย
ข้อจำกัด
เหลือเฟือสำหรับคนใช้จริง แต่รัดกุมสำหรับ loop ที่หลุด
- เรียก tool ได้ 300 ครั้งต่อเดือน ตามที่การ์ด Studio เขียนไว้ — get_account บอกว่าเหลือเท่าไรและรีเซ็ตเมื่อไร ส่วนการเชื่อมต่อ ดูรายชื่อ tool และตัว get_account เองไม่นับ
- 300 คำขอต่อนาทีต่อคีย์ (คำขอที่ไม่มีคีย์ไปไม่ถึง tool อยู่แล้ว) เกินจากนั้นจะได้ 429 พร้อม Retry-After
- ค้นหาได้สูงสุด 50 ไอคอนต่อหน้า ไล่หน้าต่อด้วย page และ seed ที่ tool ส่งกลับมา
- generate_icon ทำงานแบบรอผล อาจใช้เวลาถึงสองสามนาที และจำกัด count ไม่เกิน 4 รูปต่อครั้ง
- รูปตัวอย่างที่แนบในผลลัพธ์ถูกย่อเหลือ 256px เพื่อให้บทสนทนาเบา
แก้ปัญหา
ข้อความที่ผู้ช่วย AI จะบอก และสิ่งที่ควรทำ
| เจอข้อความ | ทำแบบนี้ |
|---|---|
| 401 “`get_icon` is part of the Studio plan and needs an API key” | เชื่อมต่อโดยไม่มีคีย์ ซึ่งใช้ได้แค่ search_icons สร้างคีย์จากบัญชีแพลน Studio ที่ Settings → API keys แล้วเพิ่ม header Authorization จากนั้นเชื่อมต่อใหม่ |
| “The API key was rejected (invalid_api_key / api_key_revoked)” | พิมพ์ผิด หรือคีย์ถูกหมุนเวียน/เพิกถอนแล้ว คัดลอกคีย์ปัจจุบันจาก Settings หรือสร้างใหม่ |
| “Not enough credits” | เติมเครดิตหรืออัปเกรดที่หน้า Billing ดาวน์โหลด 256px ยังใช้ได้ฟรี |
| 403 “`download_icon` is included in the Studio plan only” | คีย์ใช้ได้ แต่บัญชีอยู่บนแพลน Free หรือ Designer ซึ่งใช้ได้แค่ search_icons อัปเกรดเป็น Studio ที่หน้า Billing แล้วคีย์เดิมจะใช้ได้ทันที |
| client บอกว่าติดต่อ server ไม่ได้ | เช็คว่า URL ลงท้ายด้วย /api/mcp และใช้ https เปิดในเบราว์เซอร์ควรเห็นการ์ด JSON |
| 429 rate_limited | รอตามวินาทีใน Retry-After แล้วลดความถี่ของระบบอัตโนมัติลง โควตา 300/นาที คิดต่อคีย์ |
| 429 monthly_limit_reached | บัญชีใช้โควตา 300 ครั้งของเดือนนี้หมดแล้ว เริ่มใหม่วันที่ 1 ของเดือนถัดไป ระหว่างนี้ get_account กับ search_icons ยังเรียกได้ และ get_account บอกเวลารีเซ็ตที่แน่นอน |
| 429 daily_limit_reached | การค้นหาแบบไม่มีคีย์จำกัด 100 ครั้ง/วันต่อ IP (ต่อบัญชีถ้าใช้คีย์ Free/Designer) โควตาจะค่อยๆ คืนภายใน 24 ชั่วโมง คีย์ Studio ไม่ติดเพดานนี้ |
พร้อมลองหรือยัง
ถ้าอยู่บนแพลน Studio: สร้างคีย์ เพิ่ม URL ในผู้ช่วย AI ของคุณ แล้วสั่งหาไอคอนได้เลย