API to MCP

1) 選擇您的建置路徑（視覺化建構器 vs 代理建構器）: 當您需要手動控制身份驗證、工具、測試和部署設定時，請使用視覺化建構器儀表板。當您希望 IDE 代理（Codex/Cursor/Claude Code 等）透過管理器 MCP 從聊天中建立、更新、測試、部署和檢查 MCP 伺服器時，請使用 AI 代理建構器。

2) (視覺化建構器) 在儀表板中建立新的 MCP 伺服器專案: 在引導流程中啟動新伺服器。您將首先配置 API 存取，然後定義工具、測試和部署。

3) 配置您的上游 API 基本 URL: 輸入您想要公開為 MCP 工具的 REST 或 GraphQL API 基本 URL（公共 SaaS、內部系統或開放數據 API）。

4) 選擇上游身份驗證（API To MCP 將如何呼叫您的 API）: 選擇您的 API 所需的身份驗證模型：無身份驗證（公共 API）、API 金鑰（標頭或查詢參數）、Bearer Token、基本身份驗證、OAuth 用戶端憑證（機器對機器）或 OAuth 授權碼（每個員工/終端用戶連接）。憑證和令牌在靜止時加密，並在 UI 中遮罩。

5) 配置 MCP 存取模式（AI 客戶端如何連接到 MCP 伺服器）: 獨立於上游 API 身份驗證選擇 MCP 伺服器存取策略：開放（公共/代理提供的上游憑證）、OAuth/Bearer Token（驗證 MCP 連接）或客戶端令牌（需要時的額外存取層）。

6) 從您的 API 操作定義 MCP 工具: 建立 API 工具（以及可選的工作流程工具）。提供清晰的工具名稱/描述並定義輸入模式（必填與可選欄位、類型）。保持公開的工具集集中，以避免模型不堪重負。

7) 整形並最小化工具輸出（可選但建議）: 使用 JMESPath 輸出映射僅返回 AI 客戶端所需的欄位，使響應緊湊且更易於模型理解。

8) 在建構器中測試和驗證工具: 在部署前執行端點/工具測試，以驗證連接性、身份驗證、參數推斷、響應處理和錯誤處理。

9) 部署託管的 MCP 伺服器: 部署到託管的可串流 HTTP 運行時以獲取生產 MCP 端點 URL（例如，https://your-subdomain.us-west.apitomcp.io/）。

10) 從 OpenAI Responses API 呼叫您的 MCP 伺服器（整合測試）: 使用 Responses API，其中包含指向您已部署伺服器 URL 的 MCP 工具定義，並透過 allowed_tools 限制工具。範例：curl https://api.openai.com/v1/responses -H "Content-Type: application/json" -H "Authorization: Bearer $OPENAI_API_KEY" -d '{"model":"gpt-4o","input":[{"role":"user","content":[{"type":"input_text","text":"Show me the last 3 orders"}]}],"tools":[{"type":"mcp","server_url":"https://your-server.us-west.apitomcp.io/","allowed_tools":["get_orders"]}]}'

11) (可選) 啟用廣泛的工具存取並跳過測試的批准: 在受控測試環境中適當時，您可以允許所有工具並禁用批准。範例模式：tools: [{ type: "mcp", server_label: "your-server", server_url: "https://your-subdomain.us-west.apitomcp.io/", allowed_tools: "*", require_approval: "never" }].

12) 對您的 MCP 伺服器進行負載測試（可選）: 使用 Apache Bench 等工具測試並發/吞吐量。範例：ab -n 100 -c 10 -T application/json -p test-payload.json https://your-server.us-west.apitomcp.io/ (其中 test-payload.json 包含 MCP JSON-RPC 請求)。

13) (代理建構器) 將管理器 MCP 連接到您的編碼代理: 將 API To MCP 管理器伺服器 URL 添加到您的 MCP 代理：https://mcp.apitomcp.io/ 並建立一個範圍管理器令牌。

14) (代理建構器) 要求您的代理建立和迭代 MCP 伺服器: 提示您的代理要建置什麼（API 基本 URL、身份驗證模型、所需的工具、輸出整形、測試）。範例提示：「使用 OAuth 授權碼為我們的內部支援平台建立一個 MCP 伺服器，以便每個員工連接自己的帳戶。添加票證查詢和工作流程工具，測試它們，然後返回 MCP URL。」

15) 將已部署的 MCP URL 連接到您偏好的 MCP 客戶端: 將託管的遠端 HTTP MCP 端點與支援 MCP 的客戶端（ChatGPT、Claude、Codex、Cursor、Claude Code、VS Code 或自訂代理）一起使用。對於偏好 stdio 的桌面客戶端，必要時使用 HTTP-to-stdio 橋接器，例如 mcp-remote。