SHOPLINE MCP 串接方式

透過 SHOPLINE MCP（Model Context Protocol）串接 AI Agent 後，您可以透過對話方式管理商店，例如查詢訂單狀態、更新商品資訊及建立優惠活動等，提升日常營運效率。

＊注意：此功能僅適用於擁有「OpenAPI 功能」的店家，包含使用「全通路領航員」方案，或另外加購 OpenAPI 功能的店家。

本篇文章將分別介紹：

設定步驟
支援功能
應用方式
注意事項

一、設定步驟

開始串接前

前往 SHOPLINE 後台「設定 > 管理員及安全設定」，點選「增加」或「編輯」管理員權限。進入「API Auth」頁籤，開啟「MCP 權限」開關，勾選所需權限後，點選「更新」。

＊備註：

「店長」帳號不支援設定「MCP 權限」。若要使用 MCP，請另外新增「管理員」帳號進行設定。
若希望於後台活動紀錄中辨識是否由 AI Agent 操作，建議為各員工的 AI Agent 另外新增管理員帳號，並使用該帳號完成授權。
MCP 與 OpenAPI 使用相同的權限設定，惟 MCP 有特別設計開放能力權限，故即使開啟指定 OpenAPI 權限，AI Agent 仍有可能無法透過 MCP 使用此功能。

確認權限後即可進行串接，以下將分別介紹 Grok、Claude、Codex 串接步驟。若欲查看詳細資訊，請參考：SHOPLINE MCP 串接文件。

使用 Grok 串接

步驟一

於 Grok 頁面，前往「技能與連接器（Skills and Connectors）> 連接器（Connectors）」，點選「新增連接器（New Connector）」。

步驟二

點選「自訂（Custom）」。

步驟三

輸入「名稱」及「伺服器 URL（Server URL）」欄位後，點選「新增連接器（Add Connect）」。

名稱：可自行命名，例如：SHOPLINE。
伺服器 URL（Server URL）：請輸入 https://shopline-open.shopline.io/mcp

步驟四

將跳轉至 SHOPLINE 後台登入頁面，輸入您的帳號與密碼，並選擇一個要串接的商店後，點選「Authorize」同意授權。

步驟五

系統將自動跳轉回 Grok 頁面，顯示「連接器新增成功」提示，並可在「已安裝」列表中查看。於 Grok 輸入相關指令，即可透過 SHOPLINE MCP 執行相關操作。

使用 Claude 串接

步驟一

於 Claude Desktop，點選「Customize」。

＊備註：使用 Claude 網頁版進行串接可能發生渲染問題，建議改用 Claude Desktop。

步驟二

前往「Connectors」，點選「Add」，於下拉選單中點選「Add custom connector」。

步驟三

輸入「Name」及「Remote MCP server URL」欄位後，點選「Add」。

Name：可自行命名，例如：SHOPLINE。
Remote MCP server URL：請輸入 https://shopline-open.shopline.io/mcp/on-demand

步驟四

完成上述設定後，狀態為「Disconnect」，此時尚未完成商店授權與串接。首次使用 SHOPLINE MCP 執行需要商店權限的操作時（例如查詢商品庫存），Claude 將於對話中詢問是否要連接商店。點選「Connect」進行授權。

步驟五

將跳轉至 SHOPLINE 後台登入頁面，輸入您的帳號與密碼，並選擇一個要串接的商店後，點選「Authorize」同意授權，即完成串接，後續於 Claude 輸入相關指令即可正常執行。

使用 Codex 串接

步驟一

於 Codex，點選左下角「帳號名稱」，於下拉選單中點選「設定」。

步驟二

前往「外掛程式 > MCP」，點選「＋新增伺服器」。

步驟三

切換為「可串流 HTTP」，輸入「名稱」及「URL」，再點選「儲存」。

名稱：可自行命名，例如：SHOPLINE。
URL：請輸入 https://shopline-open.shopline.io/mcp

步驟四

儲存後，剛才新增的 MCP 會顯示於列表中，點選「驗證」。

步驟五

將跳轉至 SHOPLINE 後台登入頁面，輸入您的帳號與密碼，並選擇一個要串接的商店後，點選「Authorize」同意授權，即完成串接。於 Codex 輸入指令，即可透過 SHOPLINE MCP 執行相關操作。

二、支援功能

SHOPLINE MCP 目前支援功能如下：

查詢商店中訂單、商品、庫存、顧客、優惠活動等資料
查詢已領取優惠券的顧客名單
建立顧客標籤
建立優惠活動（備註）
發送優惠券
查詢 SHOPLINE FAQ、Open API 及 Developer Center 相關文件

＊備註：

目前僅支援「滿額滿件優惠」、「免運費」類型的優惠活動。
透過 MCP 建立優惠活動時，基於權限管理考量，避免 AI Agent 設定有誤影響商店營運，以下設定須由管理員手動完成：
- 付款及送貨方式：預設為空白，請於 SHOPLINE 後台確認活動內容後，完成付款及送貨設定。
- 活動狀態：預設為下架，請於 SHOPLINE 後台確認活動內容後，手動上架。

三、應用方式

您可以在 AI Agent 中輸入相關指令，讓其透過 MCP 工具完成相關操作。以下以「篩選顧客名單、建立優惠活動及發送優惠券」為例，說明操作方式。

步驟一

於 AI Agent 輸入以下內容：幫我找出 2026/1/1 ～ 2026/7/10 期間「沒有消費的顧客」名單，並透過 SHOPLINE MCP 直接建立隱藏限量的加碼優惠券活動（活動細節）到後台。我確認名單沒問題後，再針對這批顧客名單發送這張隱藏加碼優惠券。

步驟二

確認名單及活動內容後，手動上架活動，再輸入以下內容：我已經上架活動，請透過 SHOPLINE MCP 針對名單中的顧客發送優惠券。

若要查看更多應用方式，請參考：SHOPLINE 電商教室。

四、注意事項

若要切換商店，可向 AI Agent 直接輸入切換商店的相關指令，或解除串接後重新串接。切換商店時，須重新完成商店授權。
Manus 串接時易發生使用中斷，不建議使用。
若使用 Claude 團隊或企業帳號，請向帳號管理員確認您的 Claude 帳號是否已開啟「Claude > Connector」權限。