---
title: LINE OA MCP 工具
description: LINE OA MCP 的十個工具、連接方式與典型流程：讓 Claude Code、Codex、Cursor 建立 LINE 連線、追蹤每一步輪到誰，上線後傳訊息，碰不到任何密鑰。
url: https://agentlab.cresclab.com/docs/zh-tw/line/mcp-tools
language: zh-Hant
updated: 2026-10-24
---

# LINE OA MCP 工具

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

## 連線網址

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

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

架設方式見[在 Agent Lab 架設 LINE OA MCP](https://agentlab.cresclab.com/docs/zh-tw/line/quickstart.md)。

## 連接方式

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

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

Claude Code 在專案的 `.mcp.json` 加上（`${LINE_AGENT_SDK_TOKEN}` 會在啟動時從環境變數展開）：

```json .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 的連線物件](https://agentlab.cresclab.com/docs/zh-tw/line/api.md#connection-object)一樣。

## 典型流程

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` 等到上線。

> [!WARNING] 不要把權杖或密鑰貼進對話
> AI 工具需要的只有連線網址和環境變數裡的 Agent 權杖。Channel Secret 只在控制台的頁面上填，AI 工具不會要，也拿不到。

## 錯誤

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