Skip to main content

AI 輔助串接工具 (MCP)

SHOPLINE Payments 提供了一套 Model Context Protocol (MCP) 橋接服務，可以無縫整合到像 Cursor 這類具備 AI 能力的 IDE，或是任何支援 MCP 的 AI 工具中。 完成整合後，你的 AI 助手就能透過此 MCP 服務，直接搜尋並取得 SHOPLINE Payments 的官方文件與相關 API 資訊。

什麼是 SHOPLINE Payments MCP？​

SHOPLINE Payments MCP 是一個專為 SHOPLINE Payments API 設計的橋接器（STDIO ↔ HTTP）。

它會在本機端（Localhost）啟動一個 MCP STDIO Server（供 Cursor、Claude Desktop 或 Cline 等 Client 端連線使用），並將接收到的 MCP JSON-RPC Request，轉發到你所設定的 HTTP MCP Endpoint（例如：https://ai.shoplinepayments.com/mcp）。

設定 MCP Client 端​

要與 SHOPLINE Payments MCP 橋接器進行通訊，你的 MCP Client 端需要進行對應的環境設定。

注意

此橋接器是透過 MCP STDIO（標準輸入/輸出）在本機執行，其本身不包含驗證機制（身份驗證將由你設定的 HTTP MCP Endpoint 負責處理）。

先決條件​

在 Cursor 中設定​

  1. 開啟 Cursor，進入 Cursor Settings > Tools & MCP > MCP > New MCP Server，新增以下設定：
{
  "mcpServers": {
    "slpayment-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@shoplinepayments/slpayment-developer-mcp@1.0.1"
      ],
      "env": {
        "SLPAYMENT_MCP_HTTP_URL": "https://ai.shoplinepayments.com/mcp",
        "SLPAYMENT_MCP_HTTP_TIMEOUT_MS": "30000"
      }
    }
  }
}
  1. 儲存設定後，關閉所有 Cursor 行程並重新啟動 Cursor，讓新設定生效。
  2. 你可以透過檢查 MCP server 的連線狀態，或直接向 AI 發問來確認是否連線成功。

在 Claude Desktop 中設定​

  1. 開啟 Claude Desktop，前往 Settings > Developer > Edit Config。
  2. 將以下設定加入 JSON 設定檔中：
{
  "mcpServers": {
    "slpayment-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@shoplinepayments/slpayment-developer-mcp@1.0.1"
      ],
      "env": {
        "SLPAYMENT_MCP_HTTP_URL": "[https://ai.shoplinepayments.com/mcp](https://ai.shoplinepayments.com/mcp)",
        "SLPAYMENT_MCP_HTTP_TIMEOUT_MS": "30000"
      }
    }
  }
}
  1. 儲存設定檔後，完全關閉所有 Claude Desktop 程序並重新啟動，使設定生效。
  2. 同樣可透過 MCP Server 的連線狀態，或直接發問來確認是否正常連線。

在 Cline 中設定​

  1. 開啟 Cline 擴充套件，前往 MCP Servers > Configure MCP Servers。
  2. 將與上方相同的 JSON 設定檔加入其中：
{
  "mcpServers": {
    "slpayment-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@shoplinepayments/slpayment-developer-mcp@1.0.1"
      ],
      "env": {
        "SLPAYMENT_MCP_HTTP_URL": "[https://ai.shoplinepayments.com/mcp](https://ai.shoplinepayments.com/mcp)",
        "SLPAYMENT_MCP_HTTP_TIMEOUT_MS": "30000"
      }
    }
  }
}
  1. 儲存設定後，重新啟動 IDE 讓設定生效。

使用 MCP​

完成上述設定後，AI 工具就能直接透過 MCP 存取所需的技術文件或 API 資訊。

你可以嘗試用以下 Prompt 向 AI 提問：

  • 「請幫我總結最新文件中的 SHOPLINE Payments API。」
  • 「整合 SHOPLINE Payments 需要哪些步驟？」
  • 「請說明 API 的認證與簽名（Signature）需求，以及 Callback 的驗證流程。」

可用工具​

目前此 MCP 提供了以下工具供 AI 呼叫：

Tool 名稱說明
get_slpayment_docs取得 SHOPLINE Payments 的相關開發文件與資訊。

環境參數​

你可以透過設定以下環境參數，來調整 MCP 的行為：

  • SLPAYMENT_MCP_HTTP_URL：HTTP MCP Endpoint 網址（預設為 https://ai.shoplinepayments.com/mcp）。
  • SLPAYMENT_MCP_HTTP_TIMEOUT_MS：每次 Request 的 Timeout 逾時時間（預設為 30000 毫秒）。