mcpField
F
Flatfile MCP Server

Flatfile MCP Server

本地服务
github.com/FlatFilers数据与分析078 周前更新

关于 Flatfile MCP Server

Flatfile MCP Server 通过 100 多个 API 工具,让 AI 助手查询和管理 Flatfile 数据,涵盖记录操作、数据问答及工作簿创建,并可筛选启用的工具。

主要功能

  1. 01访问 100 多个 Flatfile API 端点
  2. 02查看 Sheets、Workbooks 和 Spaces
  3. 03添加、编辑和删除 Records
  4. 04查询 Flatfile 数据
  5. 05根据自然语言生成 Sheets
  6. 06从头创建 Workbooks

适用场景

  1. 01检查 Flatfile 工作簿和记录
  2. 02更新或删除工作表中的记录
  3. 03根据自然语言请求创建工作表

MCP 相关

它将 Flatfile 操作作为工具提供给 MCP 客户端。可通过逗号分隔的 `--enabled-tools` 列表限制可用工具。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"flatfile": {
"command": "npx",
"args": [
"-y",
"@flatfile/mcp-server"
]
}
}
}
启动命令npx -y @flatfile/mcp-server

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npm@flatfile/mcp-server

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

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 - 验证工作表:触发工作表上的数据钩子和验证

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。