Fillout.io MCP Server

基本能力

产品定位

Fillout.io MCP Server 是一个用于 Fillout.io API 的服务，提供表单管理、响应处理和数据分析功能。

核心功能

1. 表单管理：
2. 列出所有表单
3. 获取表单详情
4. 创建新表单
5. 删除表单

6. 更新表单设置

7. 响应处理：

8. 提交表单响应
9. 获取表单提交
10. 过滤响应

11. 导出响应

12. 数据分析：

13. 响应率
14. 完成时间
15. 提交趋势

适用场景

• 在线表单创建和管理
• 表单响应收集和分析
• 客户反馈调查
• 数据收集和分析

工具列表

1. list_forms：获取所有可访问的表单。
2. get_form：获取详细的表单信息。
3. create_form：创建新表单。
4. get_form_responses：获取表单提交。
5. submit_form_response：提交新响应。

常见问题解答

1. "Invalid API key provided" 或 "Authentication failed"：
2. 原因：API 密钥缺失、格式错误或无效。

3. 解决方案：验证密钥格式，确保环境变量设置正确。

4. "Test mode key used with live form"：

5. 原因：测试密钥用于生产表单。

6. 解决方案：使用生产密钥或创建测试表单。

7. "Rate limit exceeded"：

8. 原因：API 请求过多。
9. 解决方案：实施请求节流，优化请求模式。

使用教程

使用依赖

• Node.js 18 或更高版本
• npm 或 yarn
• Docker（可选）

安装教程

本地开发

# 安装依赖
npm install

# 开发模式运行
npm run dev

# 生产环境构建
npm run build

Docker 构建

# 构建镜像
docker build -t mcp/fillout .

# 运行容器
docker run -e FILLOUT_API_KEY=your-key mcp/fillout

调试方式

1. 检查 API 密钥格式： ```bash # 密钥应：
2. 以 'fo_live_' 或 'fo_test_' 开头
3. 大约 50 个字符

4. 仅包含字母、数字和下划线 ```

5. 测试 API 密钥： bash curl -H "Authorization: Bearer your-api-key" \ https://api.fillout.com/v1/api/forms

许可证

该项目遵循 MIT 开源许可条款。