平面文件 MCP 服务器
Flatfile MCP 服务器使 Claude Desktop、Claude Code、Cursor 等 AI 助手能够直接与您的 Flatfile 数据交互。该 MCP 服务器在 AI 助手和 Flatfile 之间搭建了无缝的桥梁。
✨ 特点
支持 100 多个 Flatfile API 端点
查看和管理工作表、工作簿、空间等
添加、编辑和删除记录
询问有关您的数据的问题
通过自然语言生成表格
从头开始创建新的工作簿
还有更多！
Related MCP server: Azure AI Search MCP Server
🛠️ 设置
您将需要一个 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
验证工作表：触发数据挂钩和验证在工作表上运行