在 WorkBuddy、Claude、ChatGPT 等 AI 助手，以及 Trae、Qoder、CodeBuddy、Cursor 等编辑器中连接 Quaflo MCP 服务
MCP (Model Context Protocol) 是一种开放协议，允许 AI 助手通过标准化的接口访问外部服务和数据源。通过 Quaflo MCP 服务，您可以在 Cursor、Claude Code 等 AI 编辑器中直接管理问卷数据，无需切换到网页界面。
| 对比项 | OAuth 连接器推荐 | 个人访问令牌 |
|---|---|---|
| 授权方式 | 浏览器登录授权,无需复制密钥 | 手动把令牌填进配置文件 |
| 令牌寿命 | 短时有效 + 自动刷新 | 长期有效(需手动轮换) |
| 权限控制 | 同意页按需勾选 scope | 创建令牌时设定 scope |
| 撤销 | 账户设置一键撤销该连接 | 删除或停用该令牌 |
| 适用客户端 | Claude、ChatGPT、WorkBuddy 等支持连接器的宿主 | Trae、Qoder、CodeBuddy、Cursor、Windsurf 等用配置文件的客户端 |
打开宿主的连接器设置,选择「添加自定义 / 远程连接器」。
粘贴下面的 MCP 服务地址并保存:
https://api.quaflo.cn/api/v1/mcp宿主会自动拉起授权页:登录 Quaflo → 勾选要授予的权限 → 点击同意,随后自动返回。
随时在 账户设置 → 已授权应用 查看每个连接的权限与最后使用时间,并一键撤销。
在 WorkBuddy 的 MCP 服务管理中,选择添加自定义 MCP(编辑 mcp.json)。
加入下方 mcpServers 配置(用固定令牌鉴权):
{
"mcpServers": {
"quaflo": {
"url": "https://api.quaflo.cn/api/v1/mcp",
"transport": "streamable-http",
"headers": {
"Authorization": "Bearer YOUR_PERSONAL_ACCESS_TOKEN"
}
}
}
}在 MCP 服务列表点击「信任」;修改 mcp.json 后需退出当前会话重新进入。WorkBuddy 也支持 OAuth 连接器(方式一),更推荐。
在对话中询问："列出我的问卷",成功即表示连接可用。
按 Ctrl+U（macOS 为 ⌘+U）打开 Agents 面板，点击齿轮图标进入「AI 管理」→「MCP」，选择「手动配置」。
在 MCP 配置中粘贴以下内容（也可在项目根目录创建 .trae/mcp.json 文件）：
{
"mcpServers": {
"quaflo": {
"url": "https://api.quaflo.cn/api/v1/mcp",
"transport": "streamable-http",
"headers": {
"Authorization": "Bearer YOUR_PERSONAL_ACCESS_TOKEN"
}
}
}
}保存配置后，重启 Trae 使配置生效。
在 AI 对话中询问："列出我的问卷"，如果配置成功，AI 将能够访问您的问卷数据。
在 Qoder（或 Qoder CN，原通义灵码）的 MCP 面板中选择「手动配置」/「添加 MCP 服务」，以你当前版本的界面为准。
类型选择 Streamable HTTP（旧版本为 SSE），URL 填写下方端点；若面板支持自定义请求头，填写 Authorization: Bearer <你的令牌>，如暂不支持自定义请求头，请改用上方的 OAuth 连接器方式或其他客户端。若你的版本支持直接粘贴 JSON，可粘贴下方配置：
{
"mcpServers": {
"quaflo": {
"url": "https://api.quaflo.cn/api/v1/mcp",
"transport": "streamable-http",
"headers": {
"Authorization": "Bearer YOUR_PERSONAL_ACCESS_TOKEN"
}
}
}
}保存后在 MCP 列表中确认服务状态为已连接；如未连接，检查令牌是否过期。
在对话中询问："列出我的问卷"，成功即表示连接可用。
在 CodeBuddy IDE 的设置中打开 MCP，选择「添加 MCP 服务」并编辑配置。
类型为 streamableHttp，加入下方 mcpServers 配置（headers 里用固定令牌鉴权）：
{
"mcpServers": {
"quaflo": {
"type": "streamableHttp",
"url": "https://api.quaflo.cn/api/v1/mcp",
"headers": {
"Authorization": "Bearer YOUR_PERSONAL_ACCESS_TOKEN"
}
}
}
}保存配置后重新开启一个对话，确认 MCP 服务已加载。
在对话中询问："列出我的问卷"，成功即表示连接可用。
点击左下角的齿轮图标，选择 "Settings" → "Features" → "MCP Servers"
在 MCP Servers 配置中，添加以下配置：
{
"mcpServers": {
"quaflo": {
"url": "https://api.quaflo.cn/api/v1/mcp",
"transport": "streamable-http",
"headers": {
"Authorization": "Bearer YOUR_PERSONAL_ACCESS_TOKEN"
}
}
}
}保存配置后，重启 Cursor 使配置生效。
重启后，您可以在 AI 对话中询问："列出我的问卷"，如果配置成功，AI 将能够访问您的问卷数据。
在 Claude Code 中打开 Settings → MCP Configuration
添加 Quaflo MCP 服务器配置：
{
"mcpServers": {
"quaflo": {
"url": "https://api.quaflo.cn/api/v1/mcp",
"transport": "streamable-http",
"headers": {
"Authorization": "Bearer YOUR_PERSONAL_ACCESS_TOKEN"
}
}
}
}保存配置并重新加载 MCP 服务器。
尝试询问 AI："显示我的问卷列表"，验证连接是否成功。
打开 Windsurf Settings（macOS 为 ⌘+,，Windows/Linux 为 Ctrl+,），搜索「MCP」找到 MCP Servers 部分。也可直接在 MCP Marketplace 中浏览。
点击「View raw config」打开配置文件（位于 ~/.codeium/windsurf/mcp_config.json），添加以下配置：
{
"mcpServers": {
"quaflo": {
"url": "https://api.quaflo.cn/api/v1/mcp",
"transport": "streamable-http",
"headers": {
"Authorization": "Bearer YOUR_PERSONAL_ACCESS_TOKEN"
}
}
}
}保存配置后，完全重启 Windsurf，然后在 MCP Servers 部分点击「Refresh」以加载新配置。
在 Cascade 对话中询问："列出我的问卷"，验证连接是否成功。
检查 API 令牌是否正确填写，确保令牌有效且未过期。在个人设置中查看令牌状态。
确保 JSON 格式正确，注意逗号、引号和大括号的匹配。可以使用 JSON 验证工具检查。
确保创建令牌时选择了必要的权限（scopes）。如需完整功能，建议选择所有相关权限。
确认服务器地址正确，当前环境的 MCP 地址为： https://api.quaflo.cn/api/v1/mcp
服务端通过 MCP_ALLOWED_ORIGINS 允许列表校验浏览器型客户端的 Origin 头：未配置该列表时，任何带 Origin 的请求都会被 403 拒绝。桌面编辑器（Cursor/Claude Code 等）通常不带 Origin 不受影响；浏览器型客户端需联系管理员配置允许列表。
MCP 按已认证用户限流（默认可由 MCP_RATE_LIMIT / MCP_RATE_WINDOW 调整），写入与发布另有更严格的按 scope 上限。收到 429 时请按响应头 Retry-After 等待后重试。