Fillout.io MCP 服务器

Fillout.io API 的 MCP 服务器，支持表单管理、响应处理和分析。

令牌设置

1. 获取您的 Fillout.io API 密钥：

   • 登录您的 Fillout.io 帐户

   • 前往账户设置 → API 和 Webhook

   • 点击“创建新的 API 密钥”

   • 复制您的新 API 密钥

2. API密钥信息：

   • 生产密钥以fo_live_开头

   • 测试键以fo_test_开头

   • 测试键仅适用于测试表单

   • API 密钥提供对您帐户中所有资源的访问权限

3. 将配置中的your-fillout-api-key替换为您的 API 密钥。

⚠️ 安全注意事项：

• 确保您的 API 密钥的安全和私密性

• 使用测试密钥进行开发

• 将密钥存储在环境变量中

• 定期轮换密钥

• 永远不要将密钥提交到版本控制

令牌故障排除

常见错误消息

1. “提供的 API 密钥无效”或“身份验证失败”

   • 原因：API 密钥缺失、格式错误或无效

   • 解决方案：

     • 验证密钥是否以fo_live_或fo_test_开头

     • 检查是否有多余的空格或字符

     • 确保环境变量设置正确

     • 如果需要，创建新密钥

2. “与实时表单一起使用的测试模式键”

   • 原因：使用测试键（ fo_test_ ）和生产表单

   • 解决方案：

     • 使用实时密钥来制作表格

     • 创建开发测试表单

     • 切换到适当的键类型

3. “超出速率限制”

   • 原因：API 请求过多

   • 解决方案：

     • 实施请求限制

     • 在仪表板中检查使用情况

     • 优化请求模式

验证步骤

1. 检查 API 密钥格式：

   # Key should: - Start with 'fo_live_' or 'fo_test_' - Be approximately 50 characters - Contain only letters, numbers, and underscores

2. 测试 API 密钥：

   curl -H "Authorization: Bearer your-api-key" \ https://api.fillout.com/v1/api/forms

特征

表单管理

• 列出所有表格

• 获取表单详细信息

• 创建新表单

• 删除表单

• 更新表单设置

响应处理

• 提交表单回复

• 获取表单提交

• 过滤响应

• 导出响应

分析

• 回复率

• 完成时间

• 投稿趋势

工具

1. list_forms

   • 获取所有可访问的表单

   • 参数：

     • limit （可选）：要返回的表单数量

     • offset （可选）：分页偏移量

   • 返回：表单对象数组

2. get_form

   • 获取详细的表单信息

   • 参数：

     • formId （字符串）：表单标识符

   • 返回：表单详细信息，包括问题和设置

3. create_form

   • 创建新表单

   • 参数：

     • name （字符串）：表单名称

     • description （可选字符串）：表单描述

     • questions （数组）：问题对象数组

       • type ：问题类型（例如，“简答题”、“多项选择题”）

       • name ：问题文本

       • required ：问题是否必填

       • choices ：多项选择题的选项数组

   • 返回：创建的表单对象

4. get_form_responses

   • 获取表单提交

   • 参数：

     • formId （字符串）：表单标识符

     • filters （可选）：响应过滤器

     • pageSize （可选）：每页结果数

     • afterDate （可选）：按提交日期过滤

     • beforeDate （可选）：按提交日期过滤

     • status （可选）：按完成状态过滤

   • 返回：表单响应数组

5. submit_form_response

   • 提交新的回复

   • 参数：

     • formId （字符串）：表单标识符

     • responses （数组）：答案数组

       • questionId ：问题标识符

       • value ：响应值

     • calculations （可选）：自定义计算

   • 返回：提交确认

设置

与 Claude Desktop 一起使用

Docker 配置

NPX 配置

建筑

先决条件

• Node.js 18 或更高版本

• npm 或 yarn

• Docker（可选）

本地开发

Docker 构建

示例

创建表单

提交回复

错误处理

服务器提供了常见问题的详细错误消息：

执照

本项目遵循 MIT 许可证。详情请参阅 LICENSE 文件。