Claude 整合
概觀
AI 整合讓您像平常聊天一樣,把 Claude 之類的 AI 工具連接到 3Min API,用自然語言運營端點。底層使用名為 MCP(Model Context Protocol) 的開放標準。AI 一旦連接到 3Min API 伺服器,就會從我們公開的工具中自行挑選合適的工具來回答您。
好處很明確。無需寫程式碼就能建立新端點、檢索昨天的呼叫日誌、邀請協作者、查看本月的使用量。不必親自點擊儀表板——一句「把上週失敗的 5 次呼叫整理一下」就夠了。
3Min API 同時支援兩種認證方式。ChatGPT 與 Claude 使用 OAuth(以 3Min API 帳號登入),無需另外管理 API 金鑰;Claude Code、Cursor 等 CLI/IDE 工具使用 API 金鑰,將金鑰放進本地設定檔即可使用。本頁介紹透過 Claude 的自訂連接器 連接的方式。
可以做的事
3Min API 的 MCP 伺服器將以下工具公開給 AI。AI 會檢視您的請求並挑選合適的工具。所有操作都 限定於您本人帳號的資料範圍,絕對無法存取其他使用者的資源。
查詢工具
| 工具名 | 說明 | 權限 |
|---|---|---|
help |
依主題回傳 3Min API 服務指南 | 公開 |
endpoints (list / get) |
查看端點清單 / 端點詳情 | 本人所有 |
logs (lookup / search / fetch archived) |
單筆日誌查看、文字搜尋、封存 Payload 遠端查看 | 本人所有 |
stats |
月度 / 日度 API 使用量統計 | 本人所有 |
subscription |
目前方案、使用量、帳單資訊 | 本人帳號 |
archives (list / download) |
封存檔案清單 + 暫時下載 URL | 本人所有 |
collaborators (list_keys / list_invitations) |
協作金鑰與協作者邀請清單 | 本人所有 |
建立 / 更新 / 部署工具
| 工具名 | 說明 | 權限 |
|---|---|---|
endpoints (create) |
建立新端點 | 本人帳號 |
endpoints (update) |
更新欄位定義、Webhook、通知設定 | 本人所有 |
endpoints (deploy) |
將沙箱設定部署到正式環境 | 本人所有 |
collaborators (create_key) |
建立新的協作金鑰 | 本人所有 |
collaborators (update_permissions) |
更新協作金鑰的 CRUD 權限 | 本人所有 |
collaborators (invite) |
寄送協作者邀請信 | 本人所有 |
執行工具
| 工具名 | 說明 | 權限 |
|---|---|---|
api_call (GET / POST / PUT / DELETE) |
對您本人已部署的端點發送 HTTP 請求(經由閘道) | 本人所有 |
api_call中的DELETE呼叫的是您自行定義的端點業務邏輯(例如「取消訂單」 API),並不會刪除端點本身。
安全與事故防護:不向 AI 公開的操作
以下操作 被刻意從 MCP 中排除,目的是防止 AI 誤動作或意外呼叫造成資料遺失、計費事故。需要時請直接登入 https://3minapi.com 執行。
| 不公開的操作 | 執行位置 |
|---|---|
| 刪除端點 | 儀表板 → APIs → 端點詳情 |
| 刪除 / 停用協作金鑰、重新產生 API 金鑰 | 儀表板 → APIs → 端點詳情 → 協作金鑰 |
| 撤銷協作者邀請 | 儀表板 → APIs → 端點詳情 → 協作者 |
| 方案變更 / 取消 | 儀表板 → 設定 → 訂閱 |
| MCP API 金鑰重新產生 / 刪除 | 儀表板 → 設定 → AI 整合 → CLI / IDE |
| 刪除封存檔案 | 儀表板 → APIs → 封存 |
| 刪除帳號 | 儀表板 → 設定 → 個人資料 |
整合方法
Claude 使用 OAuth 方式 連接。在自訂連接器中只需註冊伺服器 URL,後續認證透過 3Min API 帳號登入完成。無需手動輸入 API 金鑰。
步驟 1 — 進入 Claude 設定
開啟 Claude(https://claude.ai),透過右上角的帳號選單進入 設定。
步驟 2 — 進入連接器區段
在設定左側選單中選擇 連接器 區段。
步驟 3 — 新增自訂連接器
點擊 新增自訂連接器 按鈕,輸入以下資訊:
連接器名稱:
3minapi(可自由命名)伺服器 URL:
https://3minapi.com/api/mcp
步驟 4 — 連接後透過 OAuth 登入
點擊 連接 按鈕,會在新視窗中開啟 3Min API 的登入頁面。以您平常使用的 3Min API 帳號登入,系統會自動授予權限。
步驟 5 — 在新對話中使用
開啟新對話,立即開始使用。
Claude 免費方案 可註冊 1 個 自訂連接器。Pro 及以上 無限制。
使用範例
以下自然語言提示效果不錯:
- 「給我看我的 API 端點清單」
- 「幫我建立一個接收客戶詢問的端點。包含姓名、電子郵件、訊息欄位。」
- 「把昨天失敗的呼叫整理出 5 筆」
- 「把本月到昨天為止的使用量合計告訴我」
- 「把 chris@example.com 邀請為 user-signup 端點的協作者」
涉及建立、更新、部署的請求,AI 會再次向您確認後再執行。請仔細查看回覆,避免與意圖不符的請求被執行。
常見困擾
點了
連接但工具不出現Claude 的連接器有時會因為快取問題導致工具清單無法立即更新。先中斷連接再重新連接 即可。新對話中工具清單會正常顯示。
免費方案下無法新增連接器
您可能已經註冊了 1 個自訂連接器。免費方案上限為 1 個,請刪除已有的連接器或升級到 Pro 及以上方案。
擔心混入別人的資料
無需擔心。所有工具僅存取以 OAuth 登入的 本人帳號的資源。其他使用者的端點、日誌、封存絕對不會顯示。
AI 把端點刪除了!
無法刪除。MCP 排除了刪除等破壞性操作,無論 AI 怎麼嘗試,資料都不會消失。要真正刪除,請直接登入 https://3minapi.com 執行。
Claude Code(終端機)也用同樣的方式連接嗎?
不是。Claude 網頁 / 桌面 使用 OAuth 方式的自訂連接器,而 Claude Code(CLI)、Cursor 等本地工具使用 API 金鑰方式。後者請參考 MCP 整合 (CLI / IDE) 指南。