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 服务器: 部署到托管的 Streamable HTTP 运行时以获取生产 MCP 端点 URL（例如，https://your-subdomain.us-west.apitomcp.io/）。

10) 从 OpenAI Responses API 调用您的 MCP 服务器（集成测试）: 使用 Responses API，其中 MCP 工具定义指向您已部署的服务器 URL，并通过 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 到 stdio 的桥接器，例如 mcp-remote。