Quaflo

    MCP 使用指南

    如何在 Cursor、Claude Code、Trae、Windsurf 等 AI 编辑器中使用 Quaflo MCP 服务

    什么是 MCP?

    MCP (Model Context Protocol) 是一种开放协议，允许 AI 助手通过标准化的接口访问外部服务和数据源。通过 Quaflo MCP 服务，您可以在 Cursor、Claude Code 等 AI 编辑器中直接管理问卷数据，无需切换到网页界面。

    前置要求
    • 已注册 Quaflo 账号
    • 已创建 API 访问令牌（在 账户设置 → API 访问令牌 中创建）
    • 安装了支持 MCP 的 AI 编辑器（如 Cursor、Claude Code、Trae 或 Windsurf）
    配置步骤

    步骤 1: 打开 Cursor 设置

    点击左下角的齿轮图标，选择 "Settings" → "Features" → "MCP Servers"

    步骤 2: 添加 MCP 服务器

    在 MCP Servers 配置中，添加以下配置：

    {
  "mcpServers": {
    "quaflo": {
      "command": "npx",
      "args": [
        "-y",
        "@quaflo/mcp-server"
      ],
      "env": {
        "QUAFLO_API_TOKEN": "YOUR_API_TOKEN_HERE",
        "QUAFLO_API_URL": "https://api.quaflo.cn"
      }
    }
  }
}
    将 YOUR_API_TOKEN_HERE 替换为您在个人设置中创建的实际 API 令牌。

    步骤 3: 重启 Cursor

    保存配置后，重启 Cursor 使配置生效。

    步骤 4: 验证连接

    重启后，您可以在 AI 对话中询问："列出我的问卷"，如果配置成功，AI 将能够访问您的问卷数据。

    可用功能
    配置完成后，AI 助手可以帮您执行以下操作：

    问卷管理

    • 列出所有问卷
    • 查看问卷详细信息
    • 获取问卷结构
    • 查看问卷设置

    问卷校验

    • 验证问卷质量
    • 检查逻辑问题
    • 模拟答题流程

    数据查看

    • 查看回复列表
    • 获取统计摘要
    • 导出数据

    元数据管理

    • 更新问卷标题和描述
    • 查看问卷元信息
    使用示例
    列出我的所有问卷
    显示问卷 'customer-feedback' 的结构
    验证问卷 'survey-123' 的逻辑
    获取问卷 'nps-survey' 的回复统计
    帮我检查问卷 'abc' 是否有不可达的题目
    常见问题

    Q1AI 提示无法连接到 MCP 服务

    检查 API 令牌是否正确填写，确保令牌有效且未过期。在个人设置中查看令牌状态。

    Q2配置文件格式错误

    确保 JSON 格式正确，注意逗号、引号和大括号的匹配。可以使用 JSON 验证工具检查。

    Q3权限不足

    确保创建令牌时选择了必要的权限（scopes）。如需完整功能，建议选择所有相关权限。

    Q4服务器地址错误

    确认服务器地址正确，生产环境应使用 https://api.quaflo.cn，开发环境使用 http://localhost:3000

    安全提示
    • 不要将 API 令牌提交到版本控制系统（Git）中
    • 不要在公共场所分享您的配置文件截图
    • 定期更换 API 令牌，建议每 90 天更换一次
    • 如果令牌泄露，立即在个人设置中撤销它
    • 只授予必要的权限，遵循最小权限原则
    下一步
    1. 1在个人设置中创建您的第一个 API 令牌
    2. 2按照上述步骤配置您的 AI 编辑器
    3. 3尝试基本的问卷查询命令
    4. 4探索更多高级功能

    需要帮助？

    返回设置联系支持团队查看 API 文档