Crescendo Lab เอกสาร ดีพลอย
ไทย
สมัครใช้งาน

เครื่องมือ LINE OA MCP

LINE OA MCP ทั้ง 10 เครื่องมือ วิธีเชื่อมต่อ และตัวอย่าง: Claude Code, Codex หรือ Cursor สร้างการเชื่อมต่อ LINE ติดตามแต่ละขั้น ส่งข้อความโดยไม่แตะข้อมูลรับรอง

อัปเดตล่าสุด
ดู Markdown เปิดใน Claude เปิดใน ChatGPT

URL ของเซิร์ฟเวอร์#

LINE OA MCP อยู่ใต้โปรเจกต์ที่คุณรันเอง และใช้ Streamable HTTP:

text
https://line-oa-mcp--<องค์กร>.hosting.agentlab.run/mcp

วิธีรันดูที่รัน LINE OA MCP บน Agent Lab

วิธีเชื่อมต่อ#

ทุกคำขอต้องมี Authorization: Bearer <Agent token> ลงชื่อเข้าใช้แผงควบคุมด้วย Google แล้วสร้างโทเค็นในหน้า Agent token (/tokens) ใส่ไว้ในตัวแปรสภาพแวดล้อม อย่าเขียนในไฟล์หรือวางในแชต:

bash
export LINE_AGENT_SDK_TOKEN='<Agent token ของคุณ>'

สำหรับ Claude Code ให้เพิ่มสิ่งนี้ใน .mcp.json ของโปรเจกต์ (${LINE_AGENT_SDK_TOKEN} จะถูกแทนค่าจากตัวแปรสภาพแวดล้อมตอนเริ่มทำงาน):

.mcp.json
{
  "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

ขั้นตอนทั่วไป#

  1. สร้างการเชื่อมต่อ เรียก line_connect_account แล้วส่ง setupUrl ที่ได้ให้คน
  2. รอคนทำ เรียก line_get_connection ทุกไม่กี่วินาที ถ้าคำตอบเป็น "Waiting for the person" ให้บอกคำอธิบายและลิงก์ของขั้นนั้น แล้วอ่านต่อ ขั้นนั้นจะเสร็จเอง ไม่ต้องถามว่าเสร็จหรือยัง
  3. ขั้นของผู้ดูแล ถ้าคำตอบเป็น "The service's operator is handling" ให้บอกคนว่ากำลังดำเนินการ
  4. เผยแพร่ ถ้าคำตอบเป็น "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 พร้อมเหตุผลทำตามเหตุผลนั้น ถ้ายังไม่เผยแพร่ให้ทำขั้นถัดไปต่อ