适合谁
- 已在使用 Airtable 管理项目、任务或客户数据，并希望通过 AI 助手直接操作的团队
- 需要将 Airtable 数据自动化流程集成进 Claude、Codex、Cursor 等 MCP 客户端的开发者
- 希望利用治理与 PII 屏蔽功能对 AI 访问数据进行合规控制的场景
A
61FMRS · C
一个功能全面的第三方 Airtable MCP 服务器，覆盖记录、架构、批量操作、Webhook、评论和治理控制共42个工具，并支持 stdio 与流式 HTTP 两种传输方式及新旧协议版本客户端；适合已使用 Airtable 且需要 AI 深度集成的团队，但作为社区维护项目，需自行关注令牌安全与写操作风险。
Airtable MCP Server 是一个基于 Model Context Protocol 的服务器，为 Claude、Codex、Cursor、Windsurf、VS Code 等任意 MCP 客户端提供对 Airtable 的完整集成。它支持记录的增删改查、表和字段的架构管理、批量操作（每次最多10条记录）、Webhook 管理、记录评论、治理与合规控制（允许列表、PII 屏蔽），以及10个用于数据分析的 AI 提示模板。服务器同时支持 stdio 本地传输和可流式的 HTTP 远程传输，并兼容新旧两代 MCP 协议客户端。
工具能力
list_bases
列出所有可访问的 Airtable 基地及权限
describe
描述基地或表的架构（支持不同详细程度）
query
按条件筛选、排序和分页查询记录
search_records
使用 Airtable 公式进行高级搜索
list_records
列出记录，支持字段选择和分页
get_record
通过 ID 获取单条记录
create
创建新记录（需要 dryRun 差异预览确认）
update
更新现有记录（需要 dryRun 差异预览确认）
delete_record
从表中删除一条记录
upsert
根据合并字段更新或创建记录
batch_upsert_records
基于合并字段批量更新或创建记录
list_tables
获取基地内所有表及其架构信息
get_base_schema
获取任意基地的完整架构
list_field_types
可用字段类型参考指南
get_table_views
列出某个表的所有视图
create_table
使用自定义字段定义创建表
update_table
修改表名称和描述
delete_table
删除表（需要确认）
create_field
向现有表添加字段
update_field
修改字段属性和选项
delete_field
删除字段（需要确认）
batch_create_records
一次性创建最多10条记录
batch_update_records
同时更新最多10条记录
batch_delete_records
一次操作删除最多10条记录
list_webhooks
查看所有已配置的 Webhook
create_webhook
设置实时数据变更通知
delete_webhook
移除 Webhook 配置
get_webhook_payloads
获取通知历史记录
refresh_webhook
延长 Webhook 过期时间
create_view
创建视图（表格、表单、日历等）
get_view_metadata
获取视图详情，包括筛选条件
upload_attachment
通过 URL 附加文件
create_base
创建具有初始结构的新基地
list_collaborators
查看协作者及其权限
list_shares
列出共享视图及其配置
list_comments
列出记录上的评论
create_comment
为记录添加评论
update_comment
编辑现有评论
delete_comment
删除评论
whoami
获取当前用户身份和权限范围
list_governance
返回治理允许列表和 PII 屏蔽策略
list_exceptions
列出近期异常和修复建议
安装接入
- 在 airtable.com/create/tokens 创建 Airtable 个人访问令牌，并授予文档中列出的所有 Token Scopes。
- 获取 Base ID（可从查看基地时的 URL 中获取，也可省略并用 list_bases 工具动态发现）。
- Claude Desktop：编辑配置文件（macOS: ~/Library/Application Support/Claude/claude_desktop_config.json；Windows: %APPDATA%\Claude\claude_desktop_config.json），添加 mcpServers 中的 airtable 配置块，填入 AIRTABLE_TOKEN（和可选的 AIRTABLE_BASE_ID），保存后重启 Claude Desktop。
- Claude Code：运行一键安装脚本
curl -fsSL https://raw.githubusercontent.com/rashidazarang/airtable-mcp/main/setup.sh | bash，或手动编辑 ~/.claude.json。 - Codex/Cursor/Windsurf/VS Code：按各自客户端的 MCP 配置文件添加相同的 npx 启动命令和环境变量。
- 如客户端限制可启用工具数量（如 Cursor 上限40个），设置 AIRTABLE_TOOLSET=core 或指定工具白名单。
claude_desktop_config.json
{"mcpServers":{"airtable":{"command":"npx","args":["-y","@rashidazarang/airtable-mcp"],"env":{"AIRTABLE_TOKEN":"YOUR_AIRTABLE_TOKEN","AIRTABLE_BASE_ID":"YOUR_BASE_ID"}}}}
选型与风险
不适合谁
- 不使用 Airtable 的用户
- 需要绝对官方支持保证的企业（本项目为第三方社区维护，非 Airtable 官方产品）
- 无法接受通过 npx 每次拉取远程 npm 包运行的安全策略环境
所需权限
- data.records:read — 读取记录
- data.records:write — 创建、更新、删除记录
- data.recordComments:read — 读取记录评论
- data.recordComments:write — 创建、更新、删除评论
- schema.bases:read — 查看表结构
- schema.bases:write — 创建和修改表与字段
- user.email:read — 读取用户身份（whoami）
- webhook:manage — 管理 Webhook（可选）
风险与副作用
- 该服务器可对 Airtable 数据和结构进行写入、修改乃至删除操作，误操作或提示注入可能导致数据丢失或损坏，尽管 create/update 要求 dryRun 差异预览
- Personal Access Token 以明文形式存放在客户端配置文件的环境变量中，需妥善保管配置文件访问权限
- 该服务器为第三方维护（非 Airtable 官方），通过 npx 每次运行时从 npm 拉取最新包，存在供应链更新引入非预期行为的风险
- delete_table、delete_field、batch_delete_records 等操作具有破坏性，虽部分需要确认，但仍应谨慎审查授权范围
常见排障
- 连接问题：确认 MCP 服务器正在运行，重启 MCP 客户端
- 令牌无效：检查 Personal Access Token 是否正确、拥有所需权限范围，并确认凭据中没有多余空格
- 找不到 Base：确认 Base ID 正确，验证令牌有权访问该基地，或使用 list_bases 工具动态发现可访问的基地
- Cursor 等限制工具数量的客户端：设置 AIRTABLE_TOOLSET=core 或使用逗号分隔的工具白名单以控制启用的工具数
使用场景
用自然语言查询、筛选和更新 Airtable 表中的记录
通过对话创建和修改表结构、字段与视图
批量创建、更新或删除记录以提升自动化效率
为数据变更设置 Webhook 实时通知
对记录添加、编辑和管理评论
使用内置 AI 提示模板做数据洞察、质量审计和预测分析
支持客户端
Claude Desktop完整支持
Claude Code完整支持
Codex完整支持
Cursor部分支持
Windsurf完整支持
VS Code完整支持