主要的使用场景有哪些？

在 CI/CD 流水线中自动校验 API 规范、文档质量保证、集成测试，以及让支持 AI 的编辑器或聊天机器人在你工作时即时校验 OpenAPI 文件。

如何保障我的 APIMatic API 密钥安全？

始终通过环境变量存储 API 密钥，不要直接写在配置文件里。每个设置示例都包含了如何安全传递 API 密钥的说明。

它支持提示词模板或 MCP 资源吗？

不支持，该 MCP 服务器专注于 OpenAPI 校验，不包含提示词模板或其它 MCP 资源的文档。

APIMatic Validator MCP 服务器是如何集成到 FlowHunt 中的？

在 FlowHunt 流程中添加 MCP 服务器，在 MCP 组件内配置其详细信息，并与 AI agent 连接。这样 agent 就可以将校验器作为工具使用，在流程中提供 OpenAPI 校验能力。

APIMatic Validator MCP 服务器

Q: APIMatic Validator MCP 服务器的作用是什么？

它通过 APIMatic API 校验 OpenAPI 2.0 和 3.0 规范文件（JSON 或 YAML），返回详细汇总，帮助确保 API 质量与合规性。可用于开发者工具、CI/CD 工作流，或被 AI 助手用于实时 API 规范校验。

“APIMatic Validator” MCP 服务器的作用是什么？

APIMatic Validator MCP 服务器 是一款基于 Model Context Protocol (MCP) 的服务器，用于通过 APIMatic API 校验 OpenAPI 2.0 和 3.0 规范文件。它作为 AI 助手与 APIMatic 校验服务之间的桥梁，使开发者和工具能够自动化验证 JSON 和 YAML 格式的 API 规范文件。通过为 LLM 与开发平台提供提交 OpenAPI 文件进行校验并获取详细汇总的能力，此集成简化了工作流，有助于确保 API 文档的质量与合规性。该服务器专为无缝基于 MCP 的集成而设计，便于嵌入现代开发环境和 AI 工具。

提示词列表

仓库中未记录或提及提示词模板。

资源列表

仓库文档中未列出或描述具体 MCP 资源。

工具列表

校验 OpenAPI 文件：服务器通过 APIMatic API 向客户端提供校验 OpenAPI 2.0 和 3.0 文件（JSON 和 YAML 格式）的工具，并返回校验汇总。

此 MCP 服务器的使用场景

API 规范校验
在开发流水线中自动校验 OpenAPI 2.0 和 3.0 文件，及早发现问题并确保符合标准。
持续集成（CI）自动化
将校验器集成进 CI/CD 工作流，在部署或发布前自动检查 API 规范。
文档质量保证
定期使用校验器审查 API 文档，确保其准确性与一致性。
AI 助手集成
让支持 AI 的代码编辑器或聊天机器人为开发者编写或编辑 OpenAPI 文件时提供上下文校验。
客户端/服务器集成测试
在集成测试阶段校验 API 契约，防止客户端与服务器实现不一致。

如何设置

Windsurf

确保已安装 Node.js v18+。
使用通用包名添加服务器为依赖项：
```
"@apimatic/apimatic-validator-mcp@latest"
```

编辑你的 mcpServers 配置，添加如下内容：

{
  "apimatic-validator": {
    "command": "npx",
    "args": ["@apimatic/apimatic-validator-mcp@latest"]
  }
}

保存配置并重启 Windsurf。
验证服务器是否已在你的平台上运行并可访问。

密钥安全

使用环境变量传递 APIMatic API 密钥：

{
  "apimatic-validator": {
    "inputs": {
      "apiKey": "${APIMATIC_API_KEY}"
    },
    "env": {
      "APIMATIC_API_KEY": "your-api-key-here"
    }
  }
}

Claude

安装 Node.js v18+。

添加服务器：

"@apimatic/apimatic-validator-mcp@latest"

编辑 Claude 配置文件，加入如下内容：

{
  "mcpServers": {
    "apimatic-validator": {
      "command": "npx",
      "args": ["@apimatic/apimatic-validator-mcp@latest"]
    }
  }
}

保存并重启 Claude。
提交 OpenAPI 文件进行校验，确认连接正常。

密钥安全

使用环境变量：

{
  "mcpServers": {
    "apimatic-validator": {
      "env": {
        "APIMATIC_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor

确保已安装 Node.js v18+。

添加 MCP 服务器：

"@apimatic/apimatic-validator-mcp@latest"

更新 Cursor 配置：

{
  "mcpServers": {
    "apimatic-validator": {
      "command": "npx",
      "args": ["@apimatic/apimatic-validator-mcp@latest"]
    }
  }
}

保存并重启 Cursor。
使用示例 OpenAPI 文件测试校验流程。

密钥安全

{
  "apimatic-validator": {
    "env": {
      "APIMATIC_API_KEY": "your-api-key-here"
    }
  }
}

Cline

安装 Node.js v18+。

将 MCP 服务器添加到项目中：

"@apimatic/apimatic-validator-mcp@latest"

更新 Cline 配置：

{
  "mcpServers": {
    "apimatic-validator": {
      "command": "npx",
      "args": ["@apimatic/apimatic-validator-mcp@latest"]
    }
  }
}

保存配置并重启 Cline。
上传 OpenAPI 规范文件进行校验。

密钥安全

{
  "apimatic-validator": {
    "env": {
      "APIMATIC_API_KEY": "your-api-key-here"
    }
  }
}

如何在流程中使用此 MCP

在 FlowHunt 中使用 MCP

要将 MCP 服务器集成进 FlowHunt 工作流，首先在流程中添加 MCP 组件，并将其连接至你的 AI agent：

点击 MCP 组件打开配置面板。在系统 MCP 配置部分，按如下 JSON 格式填入你的 MCP 服务器信息：

{
  "apimatic-validator": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

配置完成后，AI agent 即可将此 MCP 作为工具，使用其全部功能。请注意将 “apimatic-validator” 替换为你自己 MCP 服务器的实际名称，并将 URL 替换为你自己的 MCP 服务器地址。

一览表

模块	是否可用	说明/备注
概览	✅	通过 APIMatic API 提供 OpenAPI 校验
提示词列表	⛔	未记录提示词模板
资源列表	⛔	未列出具体资源
工具列表	✅	OpenAPI 校验工具
密钥安全	✅	已记录环境变量用法
采样支持（评估时不重要）	⛔	未提及