基本能力
产品定位
Airtable MCP 是一个连接 AI 工具与 Airtable 的服务，允许用户通过自然语言与 Airtable 数据进行交互。
核心功能
- 基础管理：列出和选择 Airtable 基础
- 表操作：浏览表、字段和记录
- 数据访问：读取、创建、更新和删除记录
- 模式管理：导出、比较和更新模式
- 自然语言接口：使用纯英语与 Airtable 数据交互
适用场景
- 需要快速查询和操作 Airtable 数据的场景
- 希望通过自然语言与数据库交互的场景
- 需要自动化数据迁移或更新的场景
工具列表
| 工具名称 | 描述 | 示例用法 |
|-----------|-------------|---------------|
| list_bases | 列出所有可访问的 Airtable 基础 | "显示我所有的 Airtable 基础" |
| list_tables | 列出当前基础中的所有表 | "这个基础中有哪些表？" |
| list_records | 列出记录，可选过滤 | "显示 Projects 表中的所有记录" |
| get_record | 获取特定记录 | "从 Tasks 表中获取记录 ABC123" |
| create_records | 创建新记录 | "在 Contacts 中创建一个名为 John 的新记录" |
| update_records | 更新现有记录 | "将记录 XYZ 的状态更新为 Complete" |
| set_base_id | 切换到不同的基础 | "切换到基础 appi7fWMQcB3BNzPs" |
常见问题解答
- 连接问题
- 确保 Node.js 已安装（
node -v应显示 v14 或更高版本） - 验证 API 令牌和基础 ID 是否正确
-
配置更改后重启 Claude Desktop
-
JSON 解析错误
- 仔细检查配置文件中的 JSON 格式
- 避免使用额外的反斜杠或转义字符
-
使用上面显示的简化配置格式
-
命令未找到
- 如果未安装 Node.js，请安装
- 运行
npm install -g npm@latest更新 npm - 尝试运行
npx @smithery/cli --version以验证安装
使用教程
使用依赖
- 安装 Node.js（v14 或更高版本）
```bash
# 在 macOS 或 Linux 上
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
nvm install --lts
nvm use --lts
# 在 Windows 上（使用 Chocolatey）
choco install nodejs
```
安装教程
- 获取 Airtable 凭证
- 从 账户页面 获取 Airtable API 令牌
-
从 Airtable 基础 URL 获取基础 ID（格式：
appi7fWMQcB3BNzPs） -
配置 Claude Desktop
- 打开
~/Library/Application Support/Claude/claude_desktop_config.json - 添加以下配置：
json
{
"mcpServers": {
"airtable-mcp": {
"command": "npx",
"args": [
"@smithery/cli",
"run",
"@rashidazarang/airtable-mcp",
"--token",
"YOUR_AIRTABLE_TOKEN",
"--base",
"YOUR_BASE_ID"
]
}
}
} - 替换
YOUR_AIRTABLE_TOKEN和YOUR_BASE_ID为实际凭证 -
保存并重启 Claude Desktop
-
开始使用 Airtable 工具
- 打开 Claude Desktop
- 等待 30 秒建立连接
- 开始使用自然语言命令
调试方式
- 验证 Node.js 安装
bash
node -v - 验证 npm 安装
bash
npm -v - 验证 Smithery CLI 安装
bash
npx @smithery/cli --version
