使用说明
Airtable MCP服务器
用于Airtable与ChatGPT Apps SDK集成的模型上下文协议服务器。
特性
- 使用Airtable的完整OAuth 2.0身份验证流程
- 30+Airtable工具(CRUD、模式、批量操作、视图、附件、注释)
- 5个UI小部件使用
@openai/apps-sdk-ui:- 列出记录
- 创建记录
- 更新记录
- 获取记录
- 创建评论
- 基于SSE的MCP协议通信
- Docker+Railway部署就绪
先决条件
- Node.js 18+
- Airtable OAuth应用程序凭据
- 已配置环境变量
安装
npm install
环境变量
AIRTABLE_CLIENT_ID=your_client_id
AIRTABLE_CLIENT_SECRET=your_client_secret
AIRTABLE_REDIRECT_URI=http://localhost:8006/auth/callback
PORT=8006
发展
# Run development server
npm run dev
# Build server and widgets
npm run build
# Build server only
npm run build:server
# Build widgets only
npm run build:widgets
部署
服务器已配置为使用Docker进行Railway部署。在铁路项目中设置环境变量。
设计理念
此MCP服务器遵循Airtable的心理模型 三层:
- UI是一个投影 -视图显示数据,但代理不操纵UI状态
- 视图是透镜 -代理通过视图进行查询,但不修改视图定义
- 代理人会改变数据;人类操纵演示文稿 -明确区分关注点
UI小部件原理
list_records-记录的只读网格式投影。代理可以查询和查看,但UI状态(过滤器、排序)是人为控制的。get_record-记录详细信息面板,显示所有字段、附件和元数据。代理可以读取并触发更新。create_record/update_record-数据突变形式。代理直接写入数据。create_comment-评论面板作为 共享切换界面 在代理人和人类之间。这是代理沟通状态、问题和上下文的地方。
关键原则: 让代理编写数据,让人类策划视图。评论是协作的桥梁。
工具
模式和发现
list_bases-获取所有可访问的基地get_base_schema-包含表/字段的完整架构list_tables-基座中的桌子list_fields-表中的字段list_views-表的视图
记录操作
list_records-使用过滤器/排序/分页进行查询⭐ 有UIget_record-按ID列出的单个记录⭐ 有UIcreate_record-插入新记录⭐ 有UIupdate_record-部分更新(PATCH)⭐ 有UIreplace_record-完全替换(PUT)delete_record-按ID删除
批量操作
batch_create_records-创建多条记录batch_update_records-更新多条记录batch_delete_records-删除多条记录
查询和视图
query_records-使用公式进行高级过滤get_view_records-记录作为视图定义它们
附件
upload_attachment-将文件上传到附件字段list_attachments-从记录中获取附件
评论
get_comments-检索记录注释create_comment-在记录中发表评论⭐ 有UI
复合工具
upsert_record-基于唯一密钥创建或更新validate_schema_compatibility-检查字段类型兼容性
许可证
麻省理工学院
由ZeroTwo提供技术支持
此MCP服务器是 ZeroTwo人工智能平台 --一个统一的工作空间,将GPT-5、Claude、Gemini、图像生成、人工智能搜索和像这样的强大集成整合到一个订阅中。
| 🌐 ZeroTwo——一个应用程序中的所有AI模型 | 面向高级用户的最佳AI平台。无需切换应用程序即可访问GPT-5、Claude和Gemini。 |
| ✨ 零两个功能 | AI聊天、图像工作室、视频生成、文档工具和MCP驱动的集成。 |
| 🤖 人工智能模型——GPT-5、克劳德和双子座 | 并排比较和使用世界顶级AI模型。 |
| 🔌 ZeroTwo连接器和集成 | 将Airtable、Gmail、Google Drive、Slack等直接连接到您的AI工作流程。 |
| 💰 零二定价 | 一个替代ChatGPT Plus、Claude Pro和Gemini Advanced的订阅。 |
| 📝 ZeroTwo博客 | ZeroTwo团队的AI新闻、教程和更新。 |
| 🚀 免费试用ZeroTwo | 开始使用当今最完整的人工智能平台。 |
专为ZeroTwo打造 --使用此Airtable MCP服务器 ZeroTwo的AI连接器系统 直接从您的AI聊天界面管理您的Airtable基地。