เครื่องมือ LINE OA MCP
LINE OA MCP ทั้ง 10 เครื่องมือ วิธีเชื่อมต่อ และตัวอย่าง: Claude Code, Codex หรือ Cursor สร้างการเชื่อมต่อ LINE ติดตามแต่ละขั้น ส่งข้อความโดยไม่แตะข้อมูลรับรอง
URL ของเซิร์ฟเวอร์#
LINE OA MCP อยู่ใต้โปรเจกต์ที่คุณรันเอง และใช้ Streamable HTTP:
https://line-oa-mcp--<องค์กร>.hosting.agentlab.run/mcpวิธีรันดูที่รัน LINE OA MCP บน Agent Lab
วิธีเชื่อมต่อ#
ทุกคำขอต้องมี Authorization: Bearer <Agent token> ลงชื่อเข้าใช้แผงควบคุมด้วย Google แล้วสร้างโทเค็นในหน้า Agent token (/tokens) ใส่ไว้ในตัวแปรสภาพแวดล้อม อย่าเขียนในไฟล์หรือวางในแชต:
export LINE_AGENT_SDK_TOKEN='<Agent token ของคุณ>'สำหรับ Claude Code ให้เพิ่มสิ่งนี้ใน .mcp.json ของโปรเจกต์ (${LINE_AGENT_SDK_TOKEN} จะถูกแทนค่าจากตัวแปรสภาพแวดล้อมตอนเริ่มทำงาน):
{
"mcpServers": {
"line-oa-mcp": {
"type": "http",
"url": "https://line-oa-mcp--<องค์กร>.hosting.agentlab.run/mcp",
"headers": { "Authorization": "Bearer ${LINE_AGENT_SDK_TOKEN}" }
}
}
}ไคลเอนต์ MCP อื่นที่รองรับ Streamable HTTP ใช้ URL เดียวกันพร้อมเฮดเดอร์ Authorization ได้
เครื่องมือ#
| เครื่องมือ | ใช้ทำอะไร |
|---|---|
line_connect_account | สร้างการเชื่อมต่อกับบัญชีทางการ LINE ที่มีอยู่ คืนค่า setupUrl ให้ส่งต่อให้คน ซึ่งจะกรอก Channel ID และ Channel Secret ในหน้านั้น |
line_get_connection | อ่านสถานะของการเชื่อมต่อ ว่าแต่ละขั้นเป็นตาของใครและนับว่าเสร็จเมื่อไร ทุกครั้งที่อ่านจะตรวจด้วยว่าคนทำขั้นตอนฝั่ง LINE เสร็จแล้วหรือยัง |
line_list_connections | แสดงการเชื่อมต่อทั้งหมดพร้อมสถานะ |
line_send_message | พุชข้อความถึงผู้ทดสอบที่จับคู่แล้ว ใช้ได้เมื่อการเชื่อมต่อเผยแพร่แล้ว และการพุชนับรวมโควตารายเดือนของบัญชี |
line_start_sandbox | เมื่อยังไม่มีบัญชีทางการ รับรหัส join ของแซนด์บ็อกซ์ที่ใช้ร่วมกัน |
line_get_sandbox | อ่านสถานะแซนด์บ็อกซ์ ถ้า live เป็น true แสดงว่าข้อความแรกส่งถึงแล้ว |
line_configure_bot | ตั้งค่าวิธีที่ AI ตอบ: บทบาท สิ่งที่รู้ น้ำเสียง และสิ่งที่ห้ามทำ (สูงสุด 4,000 ตัวอักษร) เปิดหรือปิดการตอบของ AI หรือจำกัดผู้รับกลับไปที่ผู้ใช้ทดสอบ มีผลกับข้อความถัดไป |
line_request_go_live | โดยค่าเริ่มต้น AI ตอบเฉพาะผู้ใช้ทดสอบที่จับคู่ไว้ เครื่องมือนี้ขอให้ผู้ใช้อนุญาตให้ AI ตอบเพื่อนทุกคน จะไม่มีอะไรเปลี่ยนจนกว่าผู้ใช้จะลงชื่อเข้าใช้และอนุมัติที่ approveUrl ใช้ได้เฉพาะการเชื่อมต่อที่ใช้งานแล้วและมี mode เป็น direct |
line_get_messages | อ่านเหตุการณ์ล่าสุด ใหม่สุดก่อน: ผู้ใช้ทดสอบเขียนอะไรและแต่ละเหตุการณ์ถูกจัดการอย่างไร สำหรับเพื่อนคนอื่นจะเก็บเพียง user ID ที่ปิดบังไว้และวิธีจัดการ ไม่เก็บข้อความ |
line_new_account_steps | ขั้นตอนสร้างบัญชีทางการและเปิด Messaging API ซึ่ง LINE ให้เจ้าของทำเอง |
ทุกเครื่องมือตอบประโยคแรกว่าควรบอกคนว่าอะไร ตามด้วย JSON ทั้งหมด ซึ่งมีฟิลด์เหมือนออบเจ็กต์การเชื่อมต่อของ HTTP API
ขั้นตอนทั่วไป#
- สร้างการเชื่อมต่อ เรียก
line_connect_accountแล้วส่งsetupUrlที่ได้ให้คน - รอคนทำ เรียก
line_get_connectionทุกไม่กี่วินาที ถ้าคำตอบเป็น "Waiting for the person" ให้บอกคำอธิบายและลิงก์ของขั้นนั้น แล้วอ่านต่อ ขั้นนั้นจะเสร็จเอง ไม่ต้องถามว่าเสร็จหรือยัง - ขั้นของผู้ดูแล ถ้าคำตอบเป็น "The service's operator is handling" ให้บอกคนว่ากำลังดำเนินการ
- เผยแพร่ ถ้าคำตอบเป็น "Live" แสดงว่าข้อความ LINE แรกส่งถึงมือถือของคนแล้ว จากนั้นใช้
line_send_message
ถ้าจะลองโดยยังไม่มีบัญชีทางการ ใช้ line_start_sandbox ส่ง addFriendUrl และ joinText ให้คน แล้วรอด้วย line_get_sandbox
อย่าวางโทเค็นหรือข้อมูลรับรองในแชต
เครื่องมือ AI ต้องการแค่ URL และ Agent token จากตัวแปรสภาพแวดล้อม Channel Secret กรอกในหน้าแผงควบคุมเท่านั้น เครื่องมือ AI จะไม่ขอและไม่ได้รับ
ข้อผิดพลาด#
| สถานการณ์ | การตอบกลับ | ต้องทำอย่างไร |
|---|---|---|
| ไม่มีโทเค็น โทเค็นผิด หรือถูกเพิกถอนแล้ว | HTTP 401 | ตรวจตัวแปรสภาพแวดล้อมและเฮดเดอร์ Authorization ถ้าจำเป็นให้สร้างใหม่ที่ /tokens |
| บริการยังตั้งค่าไม่เสร็จ หรือกำลังโหลดข้อมูล | HTTP 503 พร้อมเหตุผลใน error | ลองใหม่ภายหลัง ถ้าขาดตัวแปร ให้คนที่รันบริการเพิ่ม |
| ไม่พบการเชื่อมต่อ ยังไม่เผยแพร่ หรือข้อมูลไม่ถูกต้อง | เครื่องมือคืน isError พร้อมเหตุผล | ทำตามเหตุผลนั้น ถ้ายังไม่เผยแพร่ให้ทำขั้นถัดไปต่อ |