ChatGPT 整合
概觀
AI 整合讓您像平常聊天一樣,把 ChatGPT 之類的 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 金鑰,將金鑰放進本地設定檔即可使用。本頁介紹透過 ChatGPT 外掛程式 連接的方式。
可以做的事
3Min API 的 MCP 伺服器將以下工具公開給 AI。AI 會檢視您的請求並挑選合適的工具。所有操作都 限定於您本人帳號的資料範圍,絕對無法存取其他使用者的資源。
查詢工具
| 工具名 | 說明 | 權限 |
|---|---|---|
help |
依主題回傳 3Min API 服務指南 | 公開 |
endpoint_list |
查看端點清單 | 本人所有 |
endpoint_get |
查看端點詳情 | 本人所有 |
logs (lookup / search) |
單筆日誌查看、文字搜尋 | 本人所有 |
stats |
月度 / 日度 API 使用量統計 | 本人所有 |
subscription |
目前方案、使用量、帳單資訊 | 本人帳號 |
collaboration_key_list |
協作金鑰清單 | 本人所有 |
collaborator_invite_list |
協作者邀請清單 | 本人所有 |
record_get |
檢視一筆已儲存的記錄 | 本人所有 |
record_list |
最近記錄清單(依時間倒序) | 本人所有 |
record_search |
依文字搜尋記錄(最近 30 天) | 本人所有 |
record_poll |
取得某一時間點之後到達的記錄(依時間正序) | 本人所有 |
建立 / 更新 / 部署工具
| 工具名 | 說明 | 權限 |
|---|---|---|
endpoint_create |
建立新端點 | 本人帳號 |
endpoint_update |
更新欄位定義、Webhook | 本人所有 |
endpoint_deploy |
將沙箱設定部署到正式環境 | 本人所有 |
collaboration_key_create |
建立新的協作金鑰 | 本人所有 |
collaboration_key_set_permissions |
更新協作金鑰的 CRUD 權限 | 本人所有 |
collaborator_invite |
寄送協作者邀請信 | 本人所有 |
執行工具
| 工具名 | 說明 | 權限 |
|---|---|---|
record_create |
向端點儲存一筆新記錄(經由閘道) | 本人所有 |
record_update |
整體替換一筆已儲存的記錄 | 本人所有 |
record_delete |
刪除一筆已儲存的記錄 | 本人所有 |
record_delete會刪除一筆已儲存的記錄,且無法復原。它不會刪除端點本身(端點只能在儀表板中刪除)。
任務工具
| 工具名 | 說明 | 權限 |
|---|---|---|
worker_list |
你的 Worker 的名稱、描述與 kind（public、local）（看不到 URL 與金鑰） |
本人所有 |
task_create |
以 Worker 名稱與 input（JSON 物件，100 KB 以內）建立任務。repeat 可依固定間隔重複執行（僅限本機 Worker） |
本人所有 |
task_list |
最近的任務清單（不含結果內容） | 本人所有 |
task_get |
單一任務的狀態、訊息、delivery、結果或錯誤 |
本人所有 |
task_cancel |
取消執行中的任務（最多 100 個） | 本人所有 |
task_result_describe |
電腦上保存的結果的結構（路徑、型別、範圍） | 本人所有 |
task_result_query |
對電腦上保存的結果執行唯讀 SQL，只回傳答案 | 本人所有 |
task_result_read |
電腦上保存的結果的原始片段 | 本人所有 |
必須先有 Worker：公開 Worker 在儀表板中註冊（任務），本機 Worker 是你電腦上由 CLI 執行的檔案（本機 Worker (CLI)）。
安全與事故防護:不向 AI 公開的操作
以下操作 被刻意從 MCP 中排除,目的是防止 AI 誤動作或意外呼叫造成資料遺失、計費事故。需要時請直接登入 https://3minapi.com 執行。
| 不公開的操作 | 執行位置 |
|---|---|
| 刪除端點 | 儀表板 → APIs → 端點詳情 |
| 刪除 / 停用協作金鑰、重新產生 API 金鑰 | 儀表板 → APIs → 端點詳情 → 協作金鑰 |
| 撤銷協作者邀請 | 儀表板 → APIs → 端點詳情 → 協作者 |
| 方案變更 / 取消 | 儀表板 → 設定 → 訂閱 |
| MCP API 金鑰重新產生 / 刪除 | 儀表板 → 設定 → AI 整合 → CLI / IDE |
| 刪除帳號 | 儀表板 → 設定 → 個人資料 |
| 註冊 / 編輯 / 刪除公開任務 Worker，查看或輪換金鑰 | 儀表板 → 任務 → Worker |
| 為本機 CLI 新增主機、輪替其權杖、刪除主機 | 儀表板 → 任務 → 本機（本機 Worker (CLI)） |
整合方法
ChatGPT 使用 OAuth 方式 連接。無需在 ChatGPT 任何地方貼上 API 金鑰,只需以 3Min API 帳號登入一次即可。
想立即開始?在 ChatGPT 中開啟 3Min API 頁面,然後安裝外掛程式。
步驟 1 — 訪問 ChatGPT 外掛程式
訪問 ChatGPT 外掛程式。
步驟 2 — 搜尋 3min api
在搜尋框中輸入 3min api 並點擊搜尋結果。
步驟 3 — 點擊 Connect 後透過 OAuth 登入
點擊 Connect 按鈕,會在新視窗中開啟 3Min API 的登入頁面。以您平常使用的 3Min API 帳號登入,系統會自動授予權限。不會要求您手動輸入 API 金鑰。
步驟 4 — 在新對話中使用
開啟新對話,立即開始使用。
如果 ChatGPT 沒有自動辨識 3min api,在對話框中輸入 @ 叫出工具清單,從中直接選擇 3minapi 即可。
使用範例
以下自然語言提示效果不錯:
- 「給我看我的 API 端點清單」
- 「幫我建立一個接收客戶詢問的端點。包含姓名、電子郵件、訊息欄位。」
- 「把昨天失敗的呼叫整理出 5 筆」
- 「把本月到昨天為止的使用量合計告訴我」
- 「把 chris@example.com 邀請為 user-signup 端點的協作者」
涉及建立、更新、部署的請求,AI 會再次向您確認後再執行。請仔細查看回覆,避免與意圖不符的請求被執行。
常見困擾
ChatGPT 桌面 App 看不到外掛程式目錄
桌面、行動 App 不一定顯示外掛程式目錄。請使用 網頁瀏覽器(https://chatgpt.com/plugins)。
搜尋結果裡找不到 3min api
ChatGPT 的外掛程式目錄會依帳號地區與方案分階段公開部分外掛程式。過幾天再試試。如果仍然看不到,可以改用 Claude 整合 或 MCP 整合 (CLI / IDE)。
擔心混入別人的資料
無需擔心。所有工具僅存取以 OAuth 登入的 本人帳號的資源。其他使用者的端點、日誌絕對不會顯示。
AI 把端點刪除了!
無法刪除。MCP 排除了刪除等破壞性操作,無論 AI 怎麼嘗試,資料都不會消失。要真正刪除,請直接登入 https://3minapi.com 執行。
回應總是不呼叫工具,只給一般性回覆
在對話框中輸入
@直接選擇 3minapi 後再提問,可以強制使用工具。或在提示中明確寫出工具名,例如「用 3minapi 來…」。