3Min API — MCP 伺服器指南

3Min API MCP 伺服器技術文件。本指南涵蓋可用工具、認證方式、設定說明和使用範例。

1. 伺服器說明

3Min API 是一項面向沒有後端開發能力的小型企業的 API 中繼服務。它採用 Schema-as-Data 設計，將 API 結構描述儲存為結構化資料，無需為每個客戶設定資料庫。

MCP 伺服器使 Claude 等 AI 助手能夠透過自然語言對話管理 API 端點、發送測試請求、搜尋日誌、檢視分析和管理協作者。

2. 功能

可用工具

help — 取得任何主題的引導幫助和服務參考
endpoints — 建立、設定、更新和部署 API 端點
api_call — 透過 API Gateway 發送 HTTP 請求（POST、GET、PUT、DELETE）
logs — 按文字、日期範圍或記錄 ID 搜尋日誌（支援歸檔載荷）
stats — 檢視每個端點的月度使用分析和每日明細
collaborators — 管理協作金鑰、權限和邀請
subscription — 查看方案詳情、使用量和帳單資訊
archives — 列出和下載歸檔資料檔案（僅限 CLI）

使用情境

無需撰寫程式碼即可快速設定和測試 API 端點
透過日誌和統計資料監控 API 使用情況並調查問題
透過建立協作金鑰和發送邀請管理團隊存取

3. 設定說明

MCP 伺服器 URL:

https://3minapi.com/api/mcp

Claude.ai / Claude Desktop

開啟設定 → 連接器
點擊「新增自訂連接器」
輸入上方顯示的 MCP 伺服器 URL
依提示完成 OAuth 登入

無需 API 金鑰 — 透過 OAuth 自動完成認證。

Claude Code / CLI

從儀表板產生 MCP API 金鑰（設定 → MCP 整合）
將伺服器設定新增至您的 MCP 用戶端：

{
  "mcpServers": {
    "3minapi": {
      "url": "https://3minapi.com/api/mcp",
      "headers": {
        "x-api-key": "YOUR_MCP_API_KEY"
      }
    }
  }
}

將 YOUR_MCP_API_KEY 替換為步驟 1 中產生的金鑰。

4. 認證

MCP 伺服器支援面向瀏覽器用戶端的 OAuth 2.1 + PKCE（S256）和面向 CLI 工具的 API 金鑰認證。

OAuth 2.1（Claude.ai / Desktop）

完全自動化 — 使用者只需在瀏覽器中登入。伺服器實作的標準：

RFC 8414 — Authorization Server Metadata Discovery
RFC 7591 — Dynamic Client Registration
RFC 9728 — Protected Resource Metadata
PKCE (S256) — Proof Key for Code Exchange

API 金鑰（CLI）

透過 x-api-key 請求標頭傳遞 MCP API 金鑰，或在 MCP 用戶端設定中設為環境變數。

5. 使用範例

範例 1：建立沙盒 API 端點

"使用 3minapi，我想接收線上訂單。我需要客戶姓名、訂單金額和電子郵件地址。姓名和郵件需要可搜尋。"

Action: Claude 呼叫 endpoints(action: "create", endpoint_name: "orders", field_definitions: [...])

Result: 建立一個包含沙盒欄位定義的新端點。回應包括端點 ID、帶有沙盒/生產 API 金鑰的預設協作金鑰，以及用於接收 API 呼叫的端點 URL。

範例 2：沙盒 API 測試呼叫

"向剛才建立的端點發送一筆 John Doe 150 美元的測試訂單"

Action: Claude 呼叫 api_call(endpoint_id: "...", environment: "sandbox", method: "POST", body: [fields])，然後呼叫 logs(endpoint_id: "...", environment: "sandbox") 驗證結果。

Result: API Gateway 非同步處理請求（202 Accepted）。Claude 隨後擷取日誌條目，顯示記錄已成功建立並儲存了所有欄位值。

範例 3：搜尋沙盒日誌

"顯示上週所有提到 John 的訂單"

Action: Claude 呼叫 logs(endpoint_id: "...", environment: "sandbox", search_text: "john", start_date: "...", end_date: "...")

Result: 傳回符合條件的日誌條目，包含記錄 ID、HTTP 方法、狀態碼、時間戳和載荷資料。結果按每頁 10 筆分頁，並顯示總數。

6. 隱私權政策

我們的完整隱私權政策可在以下地址查看：

https://3minapi.com/zh-TW/privacy

7. 支援

如有問題、故障或意見回饋：

電子郵件：contact@3minapi.com