LINE OA MCP 工具

LINE OA MCP 的十個工具、連接方式與典型流程：讓 Claude Code、Codex、Cursor 建立 LINE 連線、追蹤每一步輪到誰，上線後傳訊息，碰不到任何密鑰。

最後更新 2026-10-24

連線網址#

LINE OA MCP 在你架設的專案底下，使用 Streamable HTTP：

text

https://line-oa-mcp--<組織>.hosting.agentlab.run/mcp

架設方式見在 Agent Lab 架設 LINE OA MCP。

連接方式#

每個請求都要帶 Authorization: Bearer <Agent 權杖>。用 Google 登入控制台後，在 Agent 權杖 頁（/tokens）產生，放進環境變數，不要寫進檔案，也不要貼進對話：

bash

export LINE_AGENT_SDK_TOKEN='<你的 Agent 權杖>'

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}" }
    }
  }
}

其他支援 Streamable HTTP 的 MCP 用戶端，填入同一個網址並加上 Authorization 標頭即可。

工具#

工具	用途
`line_connect_account`	建立一條連線，接上既有的 LINE 官方帳號。回傳要交給人的 `setupUrl`，人在那個頁面填 Channel ID 和 Channel Secret。
`line_get_connection`	讀一條連線目前的狀態：每一步輪到誰、怎麼算完成。讀取時也會順便檢查人在 LINE 那邊做完了沒有。
`line_list_connections`	列出所有連線和各自的狀態。
`line_send_message`	用推播傳一則文字給配對過的測試帳號。連線上線後才能用，推播會用到官方帳號的每月額度。
`line_start_sandbox`	還沒有官方帳號時，拿一組共用 Sandbox 的 join 碼。
`line_get_sandbox`	讀 Sandbox 的狀態，`live` 為 `true` 時第一則訊息已送到。
`line_configure_bot`	設定 AI 怎麼回答：角色、知道什麼、語氣、不能做什麼（最多 4,000 字），開關 AI 回覆，或把回答對象收回到測試帳號。下一則訊息就生效。
`line_request_go_live`	AI 預設只回配對過的測試帳號。這個工具請人同意讓 AI 回答所有好友，人登入後在 `approveUrl` 核准才會生效；只適用於已上線、`mode` 為 `direct` 的連線。
`line_get_messages`	讀最近的事件（新的在前）：測試帳號寫了什麼、每一則怎麼處理。其他好友只留遮蔽過的使用者 ID 和處理方式，不留訊息內容。
`line_new_account_steps`	開新官方帳號、啟用 Messaging API 的步驟。LINE 不開放這些用 API 做，所以由人操作。

每個工具都會先回一句該告訴人什麼，後面接著完整的 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 工具需要的只有連線網址和環境變數裡的 Agent 權杖。Channel Secret 只在控制台的頁面上填，AI 工具不會要，也拿不到。

錯誤#

情況	回應	要怎麼做
沒帶權杖、權杖不對或已撤銷	HTTP `401`	確認環境變數和 `Authorization` 標頭，需要時到 `/tokens` 重新產生。
服務還沒設定好或資料還在載入	HTTP `503`，`error` 說明原因	稍後再試；缺環境變數時請架設的人補上。
找不到連線、連線還沒上線、內容不對	工具回傳 `isError`，文字說明原因	依說明處理；還沒上線時照著下一步繼續。