关于 Flatfile MCP Server
Flatfile MCP Server 通过 100 多个 API 工具,让 AI 助手查询和管理 Flatfile 数据,涵盖记录操作、数据问答及工作簿创建,并可筛选启用的工具。
主要功能
- 01访问 100 多个 Flatfile API 端点
- 02查看 Sheets、Workbooks 和 Spaces
- 03添加、编辑和删除 Records
- 04查询 Flatfile 数据
- 05根据自然语言生成 Sheets
- 06从头创建 Workbooks
适用场景
- 01检查 Flatfile 工作簿和记录
- 02更新或删除工作表中的记录
- 03根据自然语言请求创建工作表
MCP 相关
它将 Flatfile 操作作为工具提供给 MCP 客户端。可通过逗号分隔的 `--enabled-tools` 列表限制可用工具。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
Flatfile MCP 服务
Flatfile MCP 服务可让 Claude Desktop、Claude Code、Cursor 等 AI 助手直接与您的 Flatfile 数据交互。此 MCP 服务在 AI 助手与 Flatfile 之间搭建了无缝桥梁。
✨ 功能
- 支持 100 多个 Flatfile API 端点
- 查看和管理 Sheets、Workbooks、Spaces 等
- 添加、编辑和删除 Records
- 针对您的数据提问
- 根据自然语言生成 Sheets
- 从头创建新的 Workbooks
- 更多功能!
🛠️ 设置
您需要 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 Code 中使用
将以下内容添加到您的 .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 服务,请参阅 Claude Code 说明。
在 Cursor 中使用
将以下内容添加到您的 .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
}
}
}
}
🔧 可用工具
- ackEvent - 确认事件:确认事件
- ackJob - 确认作业:确认作业并返回该作业
- ackOutcomeJob - 确认作业结果:确认作业结果并返回该作业
- archiveSpace - 归档空间:设置空间的 archivedAt 时间戳
- assignAgentRole - 为 Agent 分配角色:为 Agent 分配角色。
- assignGuestRole - 为访客分配角色:为访客分配角色。
- assignUserRole - 为用户分配角色:为用户分配角色。
- bulkCreateActions - 创建多个操作:创建多个操作
- bulkDeleteSpace - 删除空间:按 ID 删除多个空间
- cancelJob - 取消作业:取消作业并返回该作业
- completeJob - 完成作业:完成作业并返回该作业
- createAction - 创建操作:创建操作
- createAgent - 创建 Agent:创建 Agent
- createAndInviteUser - 创建并邀请用户:在您的账户中创建并邀请新用户。
- createApp - 创建应用:创建应用
- createAssistant - 创建提示词:创建提示词
- createCanvasArea - 创建画布区域:创建新的画布区域
- createConstraintApp - 创建约束:为应用创建新约束
- createDataRetentionPolicy - 创建数据保留策略:向空间添加新的数据保留策略
- createDocument - 创建文档:向空间添加新文档
- createDraftSpace - 创建空间草稿:创建空间草稿
- createEnvironment - 创建环境:创建新环境
- createEvent - 创建事件:创建事件
- createGuidanceSpace - 创建新指导:创建新指导
- createGuideEnvironment - 创建指南:创建指南
- createIdVersion - createId:createId
- createJob - 创建作业:创建作业
- createMappingProgram - 创建两个架构之间的映射:根据提供的两个架构创建映射规则列表
- createRoutine - 创建例程:创建新例程
- createRulesMapping - 向程序添加映射规则:向程序添加映射规则
- createRunbook - 创建运行手册:创建新的运行手册
- createSnapshot - 创建快照:创建工作表的快照
- createSpace - 创建空间:根据现有空间配置创建新空间
- createView - 创建视图:向空间添加新视图
- createWorkbook - 创建工作簿:创建工作簿并将其添加到空间
- deleteAction - 删除操作:删除操作
- deleteAgent - 删除 Agent:删除单个 Agent
- deleteAgentExport - 删除 Agent 导出:删除 Agent 导出
- deleteAgentRole - 移除 Agent 的角色:移除分配给 Agent 的角色。
- deleteAllHistoryForUserMapping - 删除已认证用户的所有历史记录:删除已认证用户的所有历史记录
- deleteApp - 删除应用:删除应用
- deleteAssistant - 删除提示词:删除提示词
- deleteCanvasArea - 删除画布区域:删除指定的画布区域
- deleteConstraintApp - 删除约束:删除指定的约束
- deleteDataRetentionPolicy - 删除数据保留策略:删除单个数据保留策略
- deleteDocument - 删除文档:删除单个文档
- deleteEnvironment - 删除环境:删除单个环境
- deleteFile - 删除文件:删除文件
- deleteGuest - 删除访客:删除单个访客
- deleteGuestRole - 移除访客的角色:移除分配给访客的角色。
- deleteGuidanceSpace - 删除指导:按 ID 删除指导
- deleteGuideEnvironment - 删除指南:删除指南
- deleteJob - 删除作业:删除作业
- deleteMappingProgram - 删除映射程序:删除映射程序
- deleteMultipleRulesMapping - 删除多个映射规则:从程序中删除多个映射规则
- deleteRecords - 删除记录:从工作簿工作表中删除记录
- deleteRoutine - 删除例程:删除例程
- deleteRuleMapping - 删除映射规则:从程序中删除映射规则
- deleteRunbook - 删除运行手册:删除运行手册
- deleteSecret - 按名称删除密钥
- deleteSheet - 删除工作表:从工作簿中删除指定的工作表
- deleteSnapshot - 删除快照:删除工作表的快照
- deleteSpace - 删除空间:删除空间
- deleteUser - 删除用户:删除用户
- deleteUserRole - 移除用户的角色:移除分配给用户的角色。
- deleteView - 删除视图:删除单个视图
- deleteWorkbook - 删除工作簿:永久删除工作簿及其所有记录数据
- downloadAgentExport - 下载 Agent 导出:下载 Agent 导出
- downloadFile - 下载文件:下载文件
- duplicateSheet - 复制工作表:在同一工作簿中创建工作表副本,包括其所有数据
- executeJob - 执行作业:执行作业并返回该作业
- failJob - 将作业标记为失败:将作业标记为失败并返回该作业
- getAction - 获取操作:获取操作
- getAgent - 获取 Agent:获取 Agent
- getAgentExport - 获取 Agent 导出:获取 Agent 导出
- getAgentLog - 获取 Agent 日志:获取 Agent 日志
- getAgentLogs - 获取 Agent 的日志:获取 Agent 的日志
- getAllActions - 获取空间中的所有操作:获取空间中的所有操作
- getApp - 获取应用:返回一个应用
- getAssistant - 获取提示词:返回一个提示词
- getCalculationsSheet - 列出计算项:返回工作表的所有计算项
- getCanvasArea - 获取画布区域:按 ID 返回指定的画布区域
- getCellValuesSheet - 按字段获取记录单元格:返回工作表中按所有字段分组的记录单元格值
- getCommit - 获取提交版本:返回提交版本的详细信息
- getConstraintByIdApp - 按 ID 获取约束:返回指定的约束
- getConstraintsApp - 获取约束:返回应用的约束
- getConstraintVersionApp - 获取约束版本:返回指定约束的指定版本
- getConstraintVersionsApp - 获取约束版本:返回指定约束的所有版本
- getCurrentAccounts - 获取当前账户:获取当前账户
- getDataRetentionPolicy - 获取数据保留策略:返回单个数据保留策略
- getDocument - 获取文档:返回单个文档
- getEnvironment - 获取环境:返回单个环境
- getEnvironmentAgentExecutionsAgents - 获取环境中的所有执行记录:获取环境中的所有执行记录
- getEnvironmentAgentLogsAgents - 获取环境中的所有 Agent 日志:获取环境中的所有 Agent 日志
- 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 - 列出 Agent 导出:列出 Agent 导出
- listAgentRoles - 列出 Agent 角色:列出分配给 Agent 的角色。
- listAgents - 列出 Agent:列出 Agent
- 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 - 列出 Agent 的版本:列出 Agent 的版本
- listViews - 按工作表列出视图:返回工作表的所有视图
- listWorkbooks - 列出工作簿:返回符合账户或空间筛选条件的所有工作簿
- lockSheet - 锁定工作表:锁定工作表
- previewMutationJob - 预览变更:预览变更的结果
- resendInviteUser - 重新发送用户邀请:为您的账户重新向用户发送邀请。
- restoreSnapshot - 恢复快照:恢复工作表的快照
- retryJob - 重试失败的作业:重试失败的作业并返回该作业
- revertAgent - 恢复到指定的 Agent 版本:恢复到指定的 Agent 版本
- splitJob - 拆分作业:拆分作业并返回该作业
- unarchiveSpace - 取消归档空间:将空间的 archivedAt 时间戳设为 null
- 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 - 插入或更新密钥:按名称为环境或空间插入或更新密钥
- validateSheet - 验证工作表:触发工作表上的数据钩子和验证
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。