Flatfile MCP Server

平面文件MCP服务器

Flatfile MCP服务器使Claude Desktop、Claude Code、Cursor等AI助手能够直接与您的Flatfile数据交互。此MCP服务器在AI助手和Flatfile之间创建了一个无缝的桥梁。

✨ 特性

• 支持100多个Flatfile API端点
• 查看和管理图纸、工作簿、空间等
• 添加、编辑和删除记录
• 询问有关数据的问题
• 从自然语言生成工作表
• 从头开始创建新工作簿
• 还有更多！

🛠️ 设置

您需要Flatfile个人访问令牌或Flatfile API密钥。

API密钥

通过以下方式访问API密钥 遵循以下说明.

个人访问令牌

通过以下方式创建Flatfile个人访问令牌 遵循以下说明.

筛选工具

Flatfile提供了100多个API端点，并提供了与每个端点交互的工具。强烈建议过滤工具，只包括您需要的工具。这可以通过传递 --enabled-tools 标记到MCP服务器，并附上要启用的工具的逗号分隔列表。如果 --enabled-tools 标志未传递，所有工具都将启用。

例子：

{
  "mcpServers": {
      // ...
      "mcp-server-flatfile": {
         "command": "npx",
         "args": ["-y", "@flatfile/mcp-server", "--enabled-tools", "getRecords,updateRecords"],
         // ...
      }
      // ...
  }
}

使用Claude Desktop

将以下内容添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "mcp-server-flatfile": {
      "command": "npx",
      "args": ["-y", "@flatfile/mcp-server", "--enabled-tools", "..."], // Replace with the tools you want to enable
      "env": {
        "FLATFILE_BEARER_TOKEN": "pat_your_token_here",
        "FLATFILE_API_URL": "https://platform.flatfile.com/api/v1" // Optional, for non-US regions or self-hosting
      }
    }
  }
}

使用Claude代码

将以下内容添加到您的 .claude/code/config.json:

claude mcp add mcp-server-flatfile -e FLATFILE_API_URL=https://platform.flatfile.com/api/v1 -e FLATFILE_BEARER_TOKEN=pat_your_token_here -- npx -y @flatfile/mcp-server --enabled-tools ... // Replace with the tools you want to enable

克劳德代码说明 关于如何添加MCP服务器。

使用游标

将以下内容添加到您的 .cursor/mcp.json:

{
  "mcpServers": {
    "mcp-server-flatfile": {
      "command": "npx",
      "args": ["-y", "@flatfile/mcp-server", "--enabled-tools", "..."], // Replace with the tools you want to enable
      "env": {
        "FLATFILE_BEARER_TOKEN": "pat_your_token_here",
        "FLATFILE_API_URL": "https://platform.flatfile.com/api/v1" // Optional, for non-US regions or self-hosting
      }
    }
  }
}

🔧 可用工具

• ack事件 -确认事件：确认事件
• ackJob -确认工作：确认工作并返回工作
• AckoutComeJob -确认工作成果：确认工作成果并返回工作
• 建筑空间 -存档空间：在空间上设置archivedAt时间戳
• assignAgent角色 -为代理分配角色：为代理分配一个角色。
• 分配访客角色 -为客人分配角色：为客人分配一个角色。
• 分配用户角色 -为用户分配角色：为用户分配一个角色。
• bulkCreateActions -创建几个操作：创建几个操作
• bulk删除空间 -删除空格：按id删除多个空格
• cancelJob -取消作业：取消作业并返回作业
• \_其他组织者职位 -完成工作：完成工作并返回工作
• createAction -创建动作：创建动作
• createAgent -创建代理：创建代理
• createandinviteuser -创建并邀请用户：创建并邀请新用户到您的帐户。
• 创建应用程序 -创建应用程序：创建应用程序
• 创建助手 -创建提示：创建提示
• 创建画布区域 -创建画布区域：创建新的画布区域
• createConstraintApp -创建约束：为应用程序创建新约束
• createDataRetentionPolicy -创建数据保留策略：向空间添加新的数据保留策略
• 创建文档 -创建文档：向空间添加新文档
• createDraftSpace -创建空间草图：创建空间草图
• 创建环境 -创建环境：创建新环境
• createEvent -创建事件：创建事件
• createGuidanceSpace -创建新指南：创建新指南
• 创建指南环境 -创建指南：创建指南
• createIdVersion - createId: createId
• createJob -创建作业：创建作业
• createMapping程序 -在两个模式之间创建映射：基于提供的两个模式创建映射规则列表
• 创建例程 -创建例程：创建新例程
• 创建规则映射 -向程序中添加映射规则：向程序添加映射规则
• 创建Runbook -创建runbook：创建新的runbook
• 创建快照 -创建快照：创建工作表的快照
• createSpace -创建空间：基于现有空间配置创建新空间
• 创建视图 -创建视图：向空间添加新视图
• 创建工作簿 -创建工作簿：创建工作簿并将其添加到空间中
• deleteAction -删除操作：删除操作
• deleteAgent -删除代理：删除单个代理
• deleteAgent导出 -删除代理导出：删除代理导出
• 删除代理角色 -从代理中移除角色：从代理中删除角色。
• 删除用户映射的所有历史记录 -删除已验证用户的所有历史记录
• 删除应用程序 -删除应用程序：删除应用程序
• 删除助手 -删除提示：删除提示
• 删除CanvasArea -删除画布区域：删除特定的画布区域
• deleteConstraintApp -删除约束：删除特定约束
• deleteDataRetentionPolicy -删除数据保留策略：删除单个数据保留策略
• 删除文档 -删除文档：删除单个文档
• 删除环境 -删除环境：删除单个环境
• 删除文件 -删除文件：删除文件
• 删除访客 -删除访客：删除单个访客
• deleteGuestRole -从来宾中移除角色：从来宾中删除角色。
• 删除GuidanceSpace -删除指南：按id删除指南
• deleteGuide环境 -删除指南：删除指南
• 删除作业 -删除作业：删除作业
• deleteMapping程序 -删除映射程序：删除映射程序
• 删除多重规则映射 -删除多个映射规则：从程序中删除多个贴图规则
• 删除记录 -删除记录：从工作簿工作表中删除记录
• deleteRoutine -删除例程：删除例程
• deleteRuleMapping -删除映射规则：从程序中删除映射规则
• 删除Runbook -删除runbook：删除runbook
• 删除机密 -删除一个秘密
• deleteSheet -删除工作表：从工作簿中删除特定工作表
• deleteSnapshot -删除快照：删除工作表的快照
• deleteSpace -删除空格：删除空格
• 删除用户 -删除用户：删除用户
• 把手放在上面 -从用户中移除角色：从用户中删除角色。
• deleteView -删除视图：删除单个视图
• 删除工作簿 -删除工作簿：永久删除工作簿及其所有记录数据
• 下载代理导出 -下载代理导出：下载代理导出
• 下载文件 -下载文件：下载文件
• 复制表格 -复制工作表：创建工作表的副本，包括同一工作簿中的所有数据
• executeJob -执行作业：执行作业并返回作业
• failJob -作业失败：作业失败后返回作业
• getAction -采取行动：采取行动
• getAgent -找个代理人：找个代理人
• getAgent 导出 -获取代理导出：获取代理导出
• Getagentlog -获取代理日志：获取代理日志
• getAgentLogs -获取代理日志：获取代理日志
• getAllActions -获取空间的所有操作：获取空间的全部操作
• getApp -获取应用程序：返回应用程序
• getAssistant -获取提示：返回提示
• getCalculationsSheet -列表计算：返回工作表的所有计算结果
• getCanvasArea -获取画布区域：按ID返回特定的画布区域
• getCellvalues表 -按字段获取记录单元格：返回按工作表中所有字段分组的记录单元格值
• getCommit -获取提交版本：返回提交版本的详细信息
• getConstraintByIdApp -按ID获取约束：返回特定约束
• Getrence -获取约束：返回应用程序的约束
• getConstraintVersionApp -获取约束版本：返回特定约束的指定版本
• getConstraintVersionsApp -获取约束版本：返回特定约束的版本
• getCurrentAccounts -获取当前帐户：获取当前帐户
• getDataRetentionPolicy -获取数据保留策略：返回单个数据保留策略
• getDocument -获取文档：返回单个文档
• getEnvironment -获取环境：返回单个环境
• getEnvironmentAgent执行代理 -获取环境中的所有执行：获取环境中所有执行
• getEnvironmentAgent日志代理 -获取环境中的所有代理日志：获取环境中所有代理日志
• getEvent -获取事件：获取事件
• getEventTokenEvents -获取订阅凭据：获取可用于订阅此空间事件的令牌
• getExecutionPlanJob -找份工作
• getFile -获取文件：获取文件
• getGuest -接待客人：只接待一位客人
• getGuestToken -获取访客令牌：返回单个访客令牌
• getGuidanceSpace -获取指南：通过id检索指南
• 获取环境指南 -获取指南：返回指南
• getGuideVersionEnvironment -获取指南版本：返回特定指南的指定版本
• 获得工作。 -找工作：找工作
• getMapping程序 -获取映射程序：获取映射程序
• 获取记录计数表 -获取记录计数：返回工作表中的记录计数
• 获取记录 -获取记录：从工作簿中的工作表返回记录
• getRecordsAsCsvSheet -将记录下载为CSV文件：将工作簿中工作表中的记录作为CSV文件返回
• getRoutine -获取例程：返回例程
• getRule映射 -获取映射规则：从程序中获取映射规则
• getRunbook -获取runbook：返回runbook
• 获取身份验证 -获取Space的SFTP凭据：获取Space的TFTP凭据
• getSheet -获取工作表：返回工作簿中的工作表
• getSheetCommits -获取工作表的提交版本：返回工作表的承诺版本
• getSnapshot -获取快照：获取工作表的快照
• getSnapshotRecords -从快照获取记录：从工作表的快照获取记录
• 获取空间 -获取空格：返回一个空格
• get用户 -获取用户：获取用户
• getView -获取视图：返回单个视图
• getWorkbook -获取工作簿：返回单个工作簿
• get工作簿提交 -获取工作簿的提交：返回工作簿的提交
• 标记记录 -获取记录索引：返回工作簿中工作表中记录的索引
• 插入记录 -插入记录：将记录添加到工作簿工作表中
• listAgent出口 -列表代理导出：列表代理导出
• list代理角色 -列出代理角色：列出分配给代理的角色。
• listAgent -列出代理：列出代理
• listApps -列出应用程序：返回帐户中的应用程序
• 列表助理 -列表提示：返回用户创建的提示
• listCanvasAreas -列出画布区域：返回按画布、空间或环境筛选的画布区域列表
• list文档 -列出文档：返回一个空间的所有文档
• 列表权利 -列出权限：返回与resourceId筛选器匹配的所有权限
• list环境 -列出环境：获取所有环境
• listEvents -列出事件：Flatfile平台发出的事件主题。
• list文件 -列出文件：列出文件
• list访客角色 -列出来宾角色：列出分配给来宾的角色。
• list客人 -列出客人：返回所有客人
• listGuidanceSpace -列出指南：列出指南
• 列表指南环境 -列表指南：返回帐户中的指南
• listJobs -列出作业：列出作业
• listMapping程序 -列出映射程序：列出所有映射程序
• list角色 -列出角色：列出帐户的所有角色
• list例程 -列出例程：返回例程列表
• list规则映射 -列出映射规则：列出程序中的所有映射规则
• listRunbooks -列出Runbook：返回Runbook列表
• list秘密 -列出机密：获取给定环境ID的所有机密，并可选择应用空间覆盖
• 列表表 -列表工作表：返回工作簿中的工作表
• 列表快照 -列出快照：列出工作表的所有快照
• listSpace草稿 -列出空间草稿：列出空间草稿
• listSpaces -列出空格：返回帐户或环境的所有空格
• 列表用户角色 -列出用户角色：列出分配给用户的角色。
• 列表用户 -列出用户：获取用户列表
• listVersionsAgent -列出代理版本：列出代理的代理版本
• list浏览次数 -按图纸列出视图：返回图纸的所有视图
• list工作簿 -列出工作簿：返回与帐户或空间的筛选器匹配的所有工作簿
• 锁具 -锁定工作表：锁定工作表
• 预览修改作业 -预览突变：预览突变的结果
• ResendinviteUser -重新发送用户邀请：为您的帐户向用户重新发送邀请。
• restoreSnapshot -还原快照：还原工作表的快照
• 重试作业 -重试失败作业：重试失败作业并返回作业
• revertAgent -恢复到特定代理版本：恢复到特定的代理版本
• splitJob -拆分作业：拆分作业并返回作业
• 无架构空间 -取消空间存档：将空间上的archivedAt时间戳设置为null
• 解锁表 -解锁工作表：从工作表中删除锁
• updateAction -更新操作：更新操作
• 更新应用程序 -更新应用程序：更新应用程序
• 更新助手 -更新提示：更新提示
• 更新canvaea -更新画布区域：更新现有画布区域
• Updateconstraintapp -更新约束：更新特定约束
• 更新当前帐户 -更新当前帐户：更新当前帐户
• updateDataRetentionPolicy -更新数据保留策略：更新单个数据保留策略
• update文档 -更新文档：仅更新单个文档的正文和标题
• updateEnvironment -更新环境：更新单个环境，例如更改名称
• updateExecutionPlanFieldsJob -更新作业
• updateExecutionPlanJob -替换作业
• updateFile -更新文件：更新文件，例如更改工作簿id
• 更新访客 -更新访客：更新单个访客，例如更改姓名或电子邮件
• 更新指南空间 -更新指南：使用给定的id更新指南
• 更新指南环境 -更新指南：更新指南
• 更新作业 -更新作业：更新作业
• updateMapping程序 -更新映射程序：更新映射程序
• updateRecords -更新记录：更新工作簿工作表中的现有记录
• updateRoutine -更新例程：更新例程
• updateRuleMapping -更新映射规则：更新程序中的映射规则
• 更新规则映射 -更新映射规则列表：更新程序中的映射规则列表
• 更新Runbook -更新runbook：更新runbook
• updateSheet -更新工作表：更新工作表
• 更新 -更新空间：更新空间，例如更改名称
• 更新用户 -更新用户：更新用户
• 更新视图 -更新视图：更新单个视图
• 上传文件 -上传文件：上传文件
• uprtSecret -Uperta Secret：按环境或空间的名称插入或更新Secret
• validateSheet -验证工作表：触发数据挂钩和验证以在工作表上运行