用途：airtable-mcp 是一个命令行工具，用于在 Airtable 中列出基数、读写记录、管理表和字段、过滤与搜索数据。适合在脚本或智能体中自动化操作 Airtable 数据。
主要能力：工具列表在运行时从 MCP 服务器获取，CLI 不含硬编码命令清单，因此工具名称、参数和输出格式可能随服务器版本变化，需先用 airtable-mcp tools 查看可用工具。
安装：npm install -g @airtable/mcp-cli。
认证：需要 Airtable 个人访问令牌（PAT）。可设置环境变量 export AIRTABLE_TOKEN=pat_xxx，或运行 airtable-mcp configure 交互式配置（令牌存于 ~/.airtable/cli.json，权限 0600）。令牌需具备所调用工具对应的 scopes。
常用命令：airtable-mcp configure、airtable-mcp tools、airtable-mcp <tool> --help、airtable-mcp <tool> --flagName value、echo '{"key":"val"}' | airtable-mcp <tool> --input -。工具名在 CLI 用连字符、在 MCP 用下划线，CLI 自动转换。
输出：默认输出格式化 JSON 到 stdout，状态消息到 stderr；--json 输出工具数组，-q 抑制状态消息，--output raw 返回原始响应文本。退出码：0 成功，1 错误，2 用法错误。
限制：写操作中创建/更新记录目前需要字段 ID，需先用 get-table-schema 解析；选择字段过滤需用 choice ID 而非显示名；批量写默认上限 10 条记录；排序键为 fieldId；布尔标志不带值；CLI 仅允许 HTTPS 且域名限 *.airtable.com。运行破坏性工具前应确认。
适用范围：任务涉及 Airtable 数据管理、记录读写、表结构查看和搜索过滤时可使用。