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参数，则所有工具都将启用。

例子：

与 Claude Desktop 一起使用

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

与 Claude Code 一起使用

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

关于如何添加 MCP 服务器的Claude Code 说明。

与游标一起使用

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

🔧 可用工具

• ackEvent - 确认事件：确认事件
• ackJob - 确认工作：确认工作并返回工作
• ackOutcomeJob - 确认工作结果：确认工作结果并返回工作
• archiveSpace - 归档空间：设置空间的 archivedAt 时间戳
• assignAgentRole - 为代理分配角色：为代理分配角色。
• assignGuestRole - 为客人分配角色：为客人分配角色。
• assignUserRole - 为用户分配角色：为用户分配角色。
• bulkCreateActions - 创建多个操作：创建多个操作
• bulkDeleteSpace - 删除空间：通过id删除多个空间
• cancellationJob - 取消工作：取消工作并返回工作
• completeJob - 完成一项工作：完成一项工作并返回该工作
• createAction - 创建动作：创建动作
• createAgent - 创建代理：创建代理
• createAndInviteUser - 创建并邀请用户：创建并邀请新用户加入您的帐户。
• createApp - 创建应用程序：创建应用程序
• createAssistant - 创建提示：创建提示
• createCanvasArea - 创建画布区域：创建一个新的画布区域
• createConstraintApp - 创建约束：为应用程序创建新的约束
• createDataRetentionPolicy - 创建数据保留策略：向空间添加新的数据保留策略
• createDocument - 创建文档：向空间添加新文档
• createDraftSpace - 创建空间草稿：创建空间草稿
• createEnvironment - 创建环境：创建一个新环境
• createEvent - 创建事件：创建事件
• createGuidanceSpace - 创建新的指导：创建新的指导
• createGuideEnvironment - 创建指南：创建指南
• createIdVersion - createId: createId
• createJob - 创建作业：创建作业
• createMappingProgram - 在两个模式之间创建映射：根据两个提供的模式创建映射规则列表
• createRoutine - 创建例程：创建一个新例程
• createRulesMapping - 向程序添加映射规则：向程序添加映射规则
• createRunbook - 创建 Runbook：创建一个新的 Runbook
• createSnapshot - 创建快照：创建工作表的快照
• createSpace - 创建空间：根据现有空间配置创建新空间
• createView - 创建视图：向空间添加新视图
• createWorkbook - 创建工作簿：创建工作簿并将其添加到空间
• deleteAction - 删除操作：删除操作
• deleteAgent - 删除代理：删除单个代理
• deleteAgentExport - 删除代理导出：删除代理导出
• deleteAgentRole - 从代理中删除角色：从代理中删除角色。
• deleteAllHistoryForUserMapping - 删除经过身份验证的用户的所有历史记录：删除经过身份验证的用户的所有历史记录
• deleteApp - 删除应用程序：删除应用程序
• deleteAssistant - 删除提示：删除提示
• deleteCanvasArea - 删除画布区域：删除特定的画布区域
• deleteConstraintApp - 删除约束：删除特定约束
• deleteDataRetentionPolicy - 删除数据保留策略：删除单个数据保留策略
• deleteDocument - 删除文档：删除单个文档
• deleteEnvironment - 删除环境：删除单个环境
• deleteFile - 删除文件：删除文件
• deleteGuest - 删除访客：删除单个访客
• deleteGuestRole - 从访客中删除角色：从访客中删除角色。
• deleteGuidanceSpace - 删除指导：通过 ID 删除指导
• deleteGuideEnvironment - 删除指南：删除指南
• deleteJob - 删除作业：删除作业
• deleteMappingProgram - 删除映射程序：删除映射程序
• deleteMultipleRulesMapping - 删除多个映射规则：从程序中删除多个映射规则
• deleteRecords - 删除记录：从工作簿表中删除记录
• deleteRoutine - 删除例程：删除例程
• deleteRuleMapping - 删除映射规则：从程序中删除映射规则
• deleteRunbook - 删除 Runbook：删除 Runbook
• deleteSecret - 通过它删除秘密
• deleteSheet - 删除工作表：从工作簿中删除特定工作表
• deleteSnapshot - 删除快照：删除工作表的快照
• deleteSpace - 删除空间：删除空间
• deleteUser - 删除用户：删除用户
• deleteUserRole - 从用户中删除角色：从用户中删除角色。
• deleteView - 删除视图：删除单个视图
• deleteWorkbook - 删除工作簿：永久删除工作簿及其所有记录数据
• downloadAgentExport - 下载代理导出：下载代理导出
• downloadFile - 下载文件：下载文件
• duplicateSheet - 复制工作表：在同一工作簿中创建包含所有数据的工作表副本
• 执行作业：执行作业并返回作业
• failJob - 任务失败：任务失败并返回任务
• getAction - 获取动作：获取动作
• getAgent - 获取代理：获取代理
• getAgentExport - 获取代理导出：获取代理导出
• getAgentLog - 获取代理日志：获取代理日志
• getAgentLogs - 获取代理的日志：获取代理的日志
• getAllActions - 获取空间的所有操作：获取空间的所有操作
• getApp - 获取应用程序：返回一个应用程序
• getAssistant - 获取提示：返回提示
• getCalculationsSheet - 列出计算：返回工作表的所有计算
• getCanvasArea - 获取画布区域：通过 ID 返回特定的画布区域
• getCellValuesSheet - 按字段获取记录单元格：返回按工作表中的所有字段分组的记录单元格值
• getCommit - 获取提交版本：返回提交版本的详细信息
• getConstraintByIdApp - 通过 ID 获取约束：返回特定约束
• getConstraintsApp - 获取约束：返回应用程序的约束
• getConstraintVersionApp - 获取约束版本：返回特定约束的指定版本
• getConstraintVersionsApp - 获取约束版本：返回特定约束的版本
• getCurrentAccounts - 获取当前账户：获取当前账户
• getDataRetentionPolicy - 获取数据保留策略：返回单个数据保留策略
• getDocument - 获取文档：返回单个文档
• getEnvironment - 获取环境：返回单个环境
• getEnvironmentAgentExecutionsAgents - 获取环境中的所有执行：获取环境中的所有执行
• getEnvironmentAgentLogsAgents - 获取环境中的所有代理日志：获取环境中的所有代理日志
• getEvent - 获取事件：获取事件
• getEventTokenEvents - 获取订阅凭证：获取可用于订阅此空间事件的令牌
• getExecutionPlanJob - 获取工作
• getFile - 获取文件：获取文件
• getGuest - 获取客人：返回单个客人
• getGuestToken - 获取访客令牌：返回单个访客令牌
• getGuidanceSpace - 获取指导：通过其 ID 检索指导
• getGuideEnvironment - 获取指南：返回指南
• getGuideVersionEnvironment - 获取指南版本：返回特定指南的指定版本
• getJob - 获得一份工作：获得一份工作
• getMappingProgram - 获取地图程序：获取地图程序
• getRecordCountsSheet - 获取记录数：返回工作表中的记录数
• getRecords - 获取记录：从工作簿中的工作表返回记录
• getRecordsAsCsvSheet - 将记录下载为 CSV 文件：将工作簿中工作表的记录作为 csv 文件返回
• getRoutine - 获取例程：返回例程
• getRuleMapping - 获取映射规则：从程序中获取映射规则
• getRunbook - 获取运行手册：返回运行手册
• getSftpCredentialsAuth - 获取空间的 SFTP 凭证：获取空间的 SFTP 凭证
• getSheet - 获取工作表：返回工作簿中的工作表
• getSheetCommits - 获取工作表的提交版本：返回工作表的提交版本
• getSnapshot - 获取快照：获取工作表的快照
• getSnapshotRecords - 从快照获取记录：从工作表的快照中获取记录
• getSpace - 获取空格：返回单个空格
• getUser - 获取用户：获取用户
• getView - 获取视图：返回单个视图
• getWorkbook - 获取工作簿：返回单个工作簿
• getWorkbookCommits - 获取工作簿的提交：返回工作簿的提交
• indicesRecords - 获取记录索引：返回工作簿中工作表的记录索引
• insertRecords - 插入记录：将记录添加到工作簿表
• listAgentExports - 列出代理出口：列出代理出口
• listAgentRoles - 列出代理角色：列出分配给代理的角色。
• listAgents - 列出代理：列出代理
• listApps - 列出应用程序：返回帐户中的应用程序
• listAssistant - 列表提示：返回用户创建的提示
• listCanvasAreas - 列出画布区域：返回按画布、空间或环境过滤的画布区域列表
• listDocuments - 列出文档：返回某个空间的所有文档
• listEntitlements - 列出权利：返回与 resourceId 过滤器匹配的所有权利
• listEnvironments - 列出环境：获取所有环境
• listEvents - 列出事件：Flatfile 平台发出的事件主题。
• listFiles - 列出文件：列出文件
• listGuestRoles - 列出来宾角色：列出分配给来宾的角色。
• listGuests - 列出客人：返回所有客人
• listGuidanceSpace - 列出指导：列出指导
• listGuidesEnvironment - 列出指南：返回帐户中的指南
• listJobs - 列出工作：列出工作
• listMappingPrograms - 列出映射程序：列出所有映射程序
• listRoles - 列出角色：列出帐户的所有角色
• listRoutines - 列出例程：返回例程列表
• listRulesMapping - 列出映射规则：列出程序中的所有映射规则
• listRunbooks - 列出运行手册：返回运行手册列表
• listSecrets - 列出机密：获取给定 environmentId 的所有机密，并选择性地应用空间覆盖
• listSheets - 列出工作表：返回工作簿中的工作表
• listSnapshots - 列出快照：列出工作表的所有快照
• listSpaceDrafts - 列出空间的草稿：列出空间的草稿
• listSpaces - 列出空间：返回帐户或环境的所有空间
• listUserRoles - 列出用户角色：列出分配给用户的角色。
• listUsers - 列出用户：获取用户列表
• listVersionsAgent - 列出代理的代理版本：列出代理的代理版本
• listViews - 按工作表列出视图：返回工作表的所有视图
• listWorkbooks - 列出工作簿：返回与帐户或空间的过滤器匹配的所有工作簿
• lockSheet - 锁定工作表：锁定工作表
• previewMutationJob - 预览突变：预览突变的结果
• resendInviteUser - 重新发送用户邀请：向您帐户的用户重新发送邀请。
• restoreSnapshot - 恢复快照：恢复工作表的快照
• retryJob - 重试失败的作业：重试失败的作业并返回作业
• revertAgent - 恢复到特定代理版本：恢复到特定代理版本
• splitJob - 拆分作业：拆分作业并返回作业
• unarchiveSpace - 取消存档空间：将空间上的 archivedAt 时间戳设置为空
• unlockSheet - 解锁工作表：从工作表中删除锁
• updateAction - 更新操作：更新操作
• updateApp - 更新应用程序：更新应用程序
• updateAssistant - 更新提示：更新提示
• updateCanvasArea - 更新画布区域：更新现有的画布区域
• updateConstraintApp - 更新约束：更新特定约束
• updateCurrentAccount - 更新当前账户：更新当前账户
• updateDataRetentionPolicy - 更新数据保留策略：更新单个数据保留策略
• updateDocument - 更新文档：仅更新单个文档的正文和标题
• updateEnvironment - 更新环境：更新单个环境，例如更改名称
• updateExecutionPlanFieldsJob - 更新作业
• updateExecutionPlanJob - 替换作业
• updateFile - 更新文件：更新文件，例如更改工作簿 ID
• updateGuest - 更新访客：更新单个访客，例如更改姓名或电子邮件
• updateGuidanceSpace - 更新指导：使用给定的 ID 更新指导
• updateGuideEnvironment - 更新指南：更新指南
• updateJob - 更新工作：更新工作
• updateMappingProgram - 更新地图程序：更新地图程序
• updateRecords - 更新记录：更新工作簿表中的现有记录
• updateRoutine - 更新例程：更新例程
• updateRuleMapping - 更新映射规则：更新程序中的映射规则
• updateRulesMapping - 更新映射规则列表：更新程序中的映射规则列表
• updateRunbook - 更新运行手册：更新运行手册
• updateSheet - 更新工作表：更新工作表
• updateSpace - 更新空间：更新空间，例如更改名称
• updateUser - 更新用户：更新用户
• updateView - 更新视图：更新单个视图
• uploadFile - 上传文件：上传文件
• upsertSecret - 插入 Secret：按名称为环境或空间插入或更新 Secret
• 验证工作表：触发数据挂钩和验证在工作表上运行