3Min API
選單路徑: 設定 > AI 整合 > CLI / IDE

MCP 整合 (CLI / IDE)

概觀

AI 整合讓您像平常聊天一樣,把 Claude Code、Cursor 之類的 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 金鑰,將金鑰放進本地設定檔即可使用。本頁介紹以 API 金鑰方式 連接本地工具的方法。

入口

  • 儀表板 → 設定 → AI 整合 → CLI / IDE 分頁

可以做的事

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 → 封存
刪除帳號 儀表板 → 設定 → 個人資料

整合方法

CLI/IDE 工具使用 API 金鑰方式 連接。在本地設定檔中放入一次 3Min API 的 MCP API 金鑰後,該工具就會一直以本人帳號身分認證。API 金鑰僅在產生時顯示一次,請產生後立即複製。

步驟 1 — 進入 CLI / IDE 分頁

尚未產生 MCP API 金鑰的 CLI / IDE 分頁畫面

從儀表板右上角的帳號選單 → 設定 → AI 整合 → CLI / IDE 分頁。

步驟 2 — 產生 MCP API 金鑰

點擊 產生 MCP API 金鑰 按鈕。以 tm_mcp_ 開頭的金鑰會顯示一次。

離開此畫面後將無法再次查看完整金鑰。 請立即用旁邊的複製按鈕複製並保存到安全位置。如果遺失,只能重新產生,而舊金鑰會立即失效。

已產生 MCP API 金鑰,顯示遮罩金鑰與中繼資料的 CLI / IDE 分頁畫面

步驟 3 — 複製設定程式碼

頁面下方 設定程式碼 卡片中顯示的 JSON 直接複製即可。已產生的金鑰會自動填入。

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

步驟 4 — 貼上到工具的 MCP 設定檔

把複製的程式碼片段加入您所用工具的 MCP 設定檔。各工具的設定檔位置請參考各自的官方文件:

  • Claude Code: 專案根目錄的 .mcp.json 或使用者設定
  • Cursor: 設定 → MCP Servers
  • 其他相容 MCP 的工具也使用相同的 JSON 形式

儲存設定後重新啟動工具,即可辨識 3minapi 工具。

步驟 5 — 金鑰管理

之後可以從同一畫面進行金鑰重新產生或刪除:

  • 重新產生金鑰 — 產生新金鑰的同時 舊金鑰會立即失效。遺失或懷疑外洩時使用。重新產生後,需要把所有工具的設定檔中的金鑰替換為新值。
  • 刪除金鑰 — 完全移除金鑰。刪除後,任何工具都無法以您的身分存取帳號。

使用範例

以下自然語言提示效果不錯:

  • 「給我看我的 API 端點清單」
  • 「幫我建立一個接收客戶詢問的端點。包含姓名、電子郵件、訊息欄位。」
  • 「把昨天失敗的呼叫整理出 5 筆」
  • 「把本月到昨天為止的使用量合計告訴我」
  • 「把 chris@example.com 邀請為 user-signup 端點的協作者」

涉及建立、更新、部署的請求,AI 會再次向您確認後再執行。請仔細查看回覆,避免與意圖不符的請求被執行。

常見困擾

  • 沒看清 API 金鑰就關閉了畫面

    出於安全考量,完整金鑰只在產生時顯示一次。無法再次查看是正常情況。在 CLI / IDE 分頁中點擊 重新產生金鑰 即可產生新金鑰(舊金鑰會立即失效,所以請同時替換所用工具的設定)。

  • 把金鑰填入工具後卻無法辨識

    需要 完全重新啟動 工具,MCP 伺服器才會重新連接。僅儲存設定檔可能不會生效。如果 JSON 中有拼字錯誤,工具可能會靜默忽略,請再次確認格式。

  • 擔心混入別人的資料

    無需擔心。MCP API 金鑰與產生它的本人帳號綁定,所有工具僅存取 本人帳號的資源。其他使用者的端點、日誌、封存絕對不會顯示。

  • AI 把端點刪除了!

    無法刪除。MCP 排除了刪除等破壞性操作,無論 AI 怎麼嘗試,資料都不會消失。要真正刪除,請直接登入 https://3minapi.com 執行。

  • tm_test_*、tm_live_* 與之有什麼區別?

    完全不同的金鑰。tm_test_*(沙箱)、tm_live_*(正式)是外部呼叫您的 API 端點 時使用的 協作金鑰,而 tm_mcp_* 是 AI 工具存取您的 3Min API 帳號 時使用的金鑰。混用會導致認證失敗。

上一篇
Claude 整合