3Min API — MCP 服务器指南

3Min API MCP 服务器技术文档。本指南涵盖可用工具、认证方式、设置说明和使用示例。

1. 服务器说明

3Min API 是一项面向没有后端开发能力的小型企业的 API 中继服务。它采用 Schema-as-Data 设计，将 API 模式存储为结构化数据，无需为每个客户设置数据库。

MCP 服务器使 Claude 等 AI 助手能够通过自然语言对话管理 API 端点、发送测试请求、搜索日志、查看分析和管理协作者。

2. 功能

可用工具

help — 获取任何主题的引导帮助和服务参考
endpoints — 创建、配置、更新和部署 API 端点
api_call — 通过 API Gateway 发送 HTTP 请求（POST、GET、PUT、DELETE）
logs — 按文本、日期范围或记录 ID 搜索日志（支持归档载荷）
stats — 查看每个端点的月度使用分析和每日明细
collaborators — 管理协作密钥、权限和邀请
subscription — 查看套餐详情、使用量和账单信息
archives — 列出和下载归档数据文件（仅限 CLI）

使用场景

无需编写代码即可快速设置和测试 API 端点
通过日志和统计数据监控 API 使用情况并调查问题
通过创建协作密钥和发送邀请管理团队访问

3. 设置说明

MCP 服务器 URL:

https://3minapi.com/api/mcp

Claude.ai / Claude Desktop

打开设置 → 连接器
点击"添加自定义连接器"
输入上方显示的 MCP 服务器 URL
按提示完成 OAuth 登录

无需 API 密钥 — 通过 OAuth 自动完成认证。

Claude Code / CLI

从仪表板生成 MCP API 密钥（设置 → MCP 集成）
将服务器配置添加到您的 MCP 客户端：

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

将 YOUR_MCP_API_KEY 替换为步骤 1 中生成的密钥。

4. 认证

MCP 服务器支持面向浏览器客户端的 OAuth 2.1 + PKCE（S256）和面向 CLI 工具的 API 密钥认证。

OAuth 2.1（Claude.ai / Desktop）

完全自动化 — 用户只需在浏览器中登录。服务器实现的标准：

RFC 8414 — Authorization Server Metadata Discovery
RFC 7591 — Dynamic Client Registration
RFC 9728 — Protected Resource Metadata
PKCE (S256) — Proof Key for Code Exchange

API 密钥（CLI）

通过 x-api-key 请求头传递 MCP API 密钥，或在 MCP 客户端配置中设置为环境变量。

5. 使用示例

示例 1：创建沙盒 API 端点

"使用 3minapi，我想接收在线订单。我需要客户姓名、订单金额和电子邮件地址。姓名和邮件需要可搜索。"

Action: Claude 调用 endpoints(action: "create", endpoint_name: "orders", field_definitions: [...])

Result: 创建一个包含沙盒字段定义的新端点。响应包括端点 ID、带有沙盒/生产 API 密钥的默认协作密钥，以及用于接收 API 调用的端点 URL。

示例 2：沙盒 API 测试调用

"向刚才创建的端点发送一条 John Doe 150 美元的测试订单"

Action: Claude 调用 api_call(endpoint_id: "...", environment: "sandbox", method: "POST", body: [fields])，然后调用 logs(endpoint_id: "...", environment: "sandbox") 验证结果。

Result: API Gateway 异步处理请求（202 Accepted）。Claude 随后检索日志条目，显示记录已成功创建并存储了所有字段值。

示例 3：搜索沙盒日志

"显示上周所有提到 John 的订单"

Action: Claude 调用 logs(endpoint_id: "...", environment: "sandbox", search_text: "john", start_date: "...", end_date: "...")

Result: 返回匹配的日志条目，包含记录 ID、HTTP 方法、状态码、时间戳和载荷数据。结果按每页 10 条分页，并显示总数。

6. 隐私政策

我们的完整隐私政策可在以下地址查看：

https://3minapi.com/zh-CN/privacy

7. 支持

如有问题、故障或反馈：

邮箱：contact@3minapi.com