Airtable MCP Server

什么是 Airtable MCP Server？

Airtable MCP Server 是 Airtable 官方托管的 airtable mcp 端点，地址为 https://mcp.airtable.com/mcp。Claude、ChatGPT、Cursor 等 AI 工具可以通过它查询、创建和更新记录，修改 base 结构，构建界面，以及起草自动化。

服务器由 Airtable 运行，无需安装任何东西。所有 Airtable 用户、所有套餐都能使用，Airtable 表示 MCP 不额外收费。所有操作都遵循你在 Airtable 中已有的权限。

如何使用 Airtable MCP Server？

前提条件： 一个支持 Streamable HTTP 的 MCP 客户端、存放在 Airtable base 中的数据，以及在所在 Airtable 组织中使用第三方集成的权限。企业管理员可能需要把该集成加入允许列表。

认证方式： 有两种。

• OAuth（推荐）： 客户端会打开浏览器登录页，你可以精确选择要连接的 base、界面和工作区。服务器支持动态客户端注册（DCR），无需额外配置客户端。
• 个人访问令牌（PAT）： 更适合 CLI、脚本和服务端场景。在 airtable.com/create/tokens 创建令牌，授予以下 scope：data.records:read data.records:write schema.bases:read schema.bases:write data.recordComments:read data.recordComments:write workspacesAndBases:read，不需要的可以去掉。以 Authorization: Bearer 请求头的形式发送。

适用于任意 MCP 客户端的通用配置：

{
  "mcpServers": {
    "airtable": {
      "type": "http",
      "url": "https://mcp.airtable.com/mcp"
    }
  }
}

Claude Code

Airtable 推荐使用官方插件，它把 MCP 服务器和 Airtable skills 打包在一起：

claude plugin install airtable@claude-plugins-official

重启 Claude Code，打开 /plugin，在 Installed 中找到 Airtable MCP，选择 Authenticate。如果想用 OAuth 手动添加服务器：

claude mcp add --transport http airtable https://mcp.airtable.com/mcp

然后运行 /mcp，选中 airtable，在浏览器中完成认证。如果已把 PAT 存进 AIRTABLE_PAT：

claude mcp add \
  --transport http airtable \
  https://mcp.airtable.com/mcp \
  --header "Authorization: Bearer ${AIRTABLE_PAT}"

Claude（网页版和桌面版）

在 Claude 连接器目录中打开 Airtable 连接器，点击 Connect，再通过 OAuth 授权。

Cursor

使用 Airtable 提供的安装深度链接，或在 ~/.cursor/mcp.json（或项目内的 .cursor/mcp.json）中添加：

{
  "mcpServers": {
    "airtable": {
      "type": "http",
      "url": "https://mcp.airtable.com/mcp"
    }
  }
}

Cursor 默认通过 OAuth 认证。如果要用 PAT，添加 "headers": { "Authorization": "Bearer ${env:AIRTABLE_PAT}" }。

VS Code

VS Code 对远程 HTTP 服务器使用 servers 块：

{
  "servers": {
    "airtable": {
      "type": "http",
      "url": "https://mcp.airtable.com/mcp"
    }
  }
}

Airtable 还提供 ChatGPT 和 Google Gemini 的快速入门，以及可在终端直接调用 MCP 工具的 @airtable/mcp-cli 命令行工具。

Airtable MCP Server 的主要功能

• 由 Airtable 运营的官方托管远程 MCP 服务器，使用 Streamable HTTP 传输
• OAuth 可按 base、界面和工作区逐项授权，也可使用限定 scope 的个人访问令牌
• 读取、搜索、创建、更新和删除记录
• 创建 base、表和字段，并更新表和字段信息
• 构建界面和界面页面；即使只有界面访问权限，也能读取界面页面上的数据
• 创建和更新自动化草稿（开启自动化仍需在 Airtable 界面中操作）
• 填写并提交 Airtable 表单
• 所有套餐均包含，不额外收费，但受标准 Airtable API 速率限制约束

Airtable MCP Server 工具

• Base 与工作区： list_bases、search_bases、create_base、list_workspaces 和 list_external_accounts 用于查找资源。助手通常先从这里找到正确的 base。
• 表与字段： list_tables_for_base、get_table_schema、list_views_for_table、create_table、update_table、delete_table、create_field 和 update_field。不支持修改字段类型或单选/多选选项。
• 记录： list_records_for_table、search_records、create_records_for_table、update_records_for_table、delete_records_for_table 和 revert_action。每次请求最多创建 10 条记录。
• 界面与表单： create_interface、create_page、list_pages_for_base、list_records_for_page、get_record_for_page、get_form_schema 和 submit_form。
• 自动化： list_automations、get_automation、create_automation、update_automation 和 delete_automation（只能删除已关闭的自动化）。AI 工具通常会先调用 get_create_automation_instructions。

Airtable MCP Server 的使用场景

• 用自然语言查询 CRM：“Show me all customers from our CRM base who haven't been contacted in the last 30 days.”
• 在对话中记录工作：“Add these 5 new project tasks to my Project Tracker base.”
• 及时更新状态：“Update the status of task #123 to 'Complete'.”
• 快速搭建新结构：“Create a new base called 'Q3 Campaign Tracker' in my Marketing workspace.”
• 为团队搭建视图：“Create an interface page to track my open tasks.”
• 审查工作流：“What automations are configured in my Project Tracker base?”

Airtable MCP Server 与替代方案对比

Airtable 推出托管服务器之前，大多数人使用社区开发的本地服务器。比较流行的是 domdomegg/airtable-mcp-server，它通过 npx 运行，使用 AIRTABLE_API_KEY（个人访问令牌）。如果你想锁定版本，或让一切都留在本机，本地服务器仍然适用。官方 airtable mcp server 增加了 OAuth 授权、界面、表单和自动化工具，并由 Airtable 维护。其他无代码数据库和工作区工具可参考 Notion MCP Server (Official) 和 ClickUp MCP Server。

Airtable MCP Server 常见问题排查

• 企业组织中集成被拦截： 管理员需要在 Admin Panel → Settings → Integrations & development → Third party integration allowlist 中，用你提供的 client ID 放行该集成。
• 能读不能写： MCP 与你的 Airtable 角色保持一致，Commenter 和只读用户只能读取。PAT 或 OAuth 授权中也需要包含 data.records:write；修改结构还需要 schema.bases:write。
• 只能创建“Interface only”令牌： 说明你拥有的是界面的 Editor 权限，而不是 base 的权限。请让 base 的 owner 或 creator 授予你 base 级别的访问权限。
• Claude Code 使用 PAT 后又要求登录： 用 PAT 请求头添加服务器后，在 /mcp 中确认状态为 connected 和 authenticated。不要点 Re-authenticate，否则会启动 OAuth 流程。
• 自动化或界面受限： MCP 无法开启自动化、无法创建或编辑 Script 动作、无法给界面添加筛选器，也无法编辑已有界面。这些操作请在 Airtable 界面中完成。