/ الدليل / الملعب / airtable-mcp-server
← كل الخوادم ↗ GitHub
● مجتمع domdomegg ⚡ فوري

airtable-mcp-server

بواسطة domdomegg · domdomegg/airtable-mcp-server

اقرأ وعدّل Airtable من المحادثة — برمز وصول شخصي دقيق يحدد بالضبط أي قواعد البيانات يمكن للذكاء الاصطناعي الوصول إليها.

airtable-mcp-server بقلم domdomegg هو معيار MCP لـ Airtable في المجتمع. يتحقق من الهوية باستخدام رمز الوصول الشخصي إلى Airtable، ويكشف 15+ أداة للسجلات/الجداول/الحقول/التعليقات، ويمكن تثبيتها للقراءة فقط عبر نطاقات PAT. يعمل مع أي قاعدة بيانات Airtable بما في ذلك مساحات عمل Enterprise.

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

airtable.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "airtable": {
      "command": "npx",
      "args": [
        "-y",
        "airtable-mcp-server"
      ],
      "_inferred": true
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "airtable": {
      "command": "npx",
      "args": [
        "-y",
        "airtable-mcp-server"
      ],
      "_inferred": true
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "airtable": {
      "command": "npx",
      "args": [
        "-y",
        "airtable-mcp-server"
      ],
      "_inferred": true
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "airtable": {
      "command": "npx",
      "args": [
        "-y",
        "airtable-mcp-server"
      ],
      "_inferred": true
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "airtable",
      "command": "npx",
      "args": [
        "-y",
        "airtable-mcp-server"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "airtable": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "airtable-mcp-server"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add airtable -- npx -y airtable-mcp-server

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: airtable-mcp-server

الإجابة على أسئلة اللغة الطبيعية حول Airtable CRM الخاص بك

👤 المؤسسون والأشخاص في العمليات الذين يستخدمون Airtable كـ CRM ⏱ ~10 min beginner

متى تستخدمه: تريد معرفة 'من لم يرد في آخر 30 يوماً؟' دون بناء عرض.

المتطلبات الأساسية
  • Airtable PAT مع schema.bases:read + data.records:read — airtable.com/create/tokens/new — اختر فقط قواعد البيانات التي تريد فضحها
الخطوات
  1. دع Claude يسرد قواعد البيانات واختر الصحيحة
    اسرد قواعد البيانات Airtable الخاصة بي. ابحث عن قاعدة البيانات التي تبدو وكأنها CRM مبيعات وصف جداولها.✓ تم النسخ
    → مخطط قاعدة البيانات CRM مع أغراض الجداول
  2. اسأل السؤال الحقيقي
    في جدول جهات الاتصال، ابحث عن الأشخاص حيث آخر جهة اتصال أكثر من 30 يوماً وحالة النشاط. جمّع حسب المالك.✓ تم النسخ
    → قائمة السجلات المفلترة حسب المالك
  3. ضع مسودة إجراءات المتابعة
    لكل جهة اتصال، صيّغ بريداً إلكترونياً تذكيرياً بسطر واحد يمكنني إرساله. تطابق نبرة محادثتهم الأخيرة.✓ تم النسخ
    → نص مسودة لكل جهة اتصال

النتيجة: قائمة الإجراء التالي مباشرة من CRM في دقيقتين.

المزالق
  • حقول السجلات المرتبطة تعيد معرّفات وليس أسماء — اطلب من Claude حل السجلات المرتبطة عبر جلب ثاني، أو استخدم list_records مع returnFieldsByFieldId=false
  • غالباً ما تحتوي قواعد البيانات Enterprise على قيود الأذونات لكل حقل — تحقق من أن وصول مساحة العمل الخاص بـ PAT يتطابق مع سياسة enterprise الخاصة بقاعدة البيانات
اجمعها مع: notion

تنظيف سجلات Airtable الفوضوية بكميات كبيرة

👤 مسؤولو العمليات الذين يرثون قاعدة بيانات فوضوية ⏱ ~45 min intermediate

متى تستخدمه: جدول يحتوي على 3 آلاف صف به حالات غير متسقة، حقول مفقودة، شركات مكررة.

المتطلبات الأساسية
  • PAT مع data.records:write — أضف النطاق عند إنشاء الرمز؛ اجعل نطاق قاعدة البيانات ضيقاً
الخطوات
  1. تدقيق الفوضى
    في جدول الشركات، ابحث عن التكرارات حسب الاسم المطبع، السجلات المفقودة في Domain، والسجلات التي يبدأ موقع الويب فيها بـ http:// بدلاً من https://.✓ تم النسخ
    → العد لكل مشكلة
  2. تشغيل جاف لخطة إصلاح
    لكل مشكلة، اقترح إصلاحاً وأرِ لي 3 تغييرات مثال قبل الكتابة.✓ تم النسخ
    → معاينة مع بوابة موافقة المستخدم
  3. تطبيق الإصلاحات المعتمدة
    موافق. طبّق الإصلاحات في دفعات من 50 مع update_records.✓ تم النسخ
    → عدد النجاحات لكل دفعة

النتيجة: جدول نظيف مع قائمة قابلة للتدقيق لما تغيّر.

المزالق
  • التحديثات الجماعية تشغل حصص أتمتة Airtable لكل رمز — دفعة بحد أقصى 10/ث؛ أوقف الأتمتة للجدول المتأثر أثناء العمليات الضخمة
  • نمط تحديث سيء واحد يفسد 500 صف — التقط لقطة من الجدول (تصدير CSV) قبل الكتابة الأولى
اجمعها مع: filesystem

استخدم Airtable كـ CMS بدون رأس لموقع ويب

👤 مطورو استقلاليون وفرق المحتوى ⏱ ~30 min intermediate

متى تستخدمه: تريد محررين في Airtable ومنطق نشر يقوده وكيل.

الخطوات
  1. اسحب السجلات الجاهزة للنشر
    من جدول Blog، اسرد السجلات حيث الحالة 'جاهزة' وتاريخ النشر اليوم أو قبله.✓ تم النسخ
    → قائمة انتظار النشر
  2. تحويل وإصدار
    لكل منها، حول حقل Body الغني بالنصوص إلى Markdown واكتب إلى /site/content/posts/<slug>.md.✓ تم النسخ
    → تظهر الملفات على القرص
  3. اقلب الحالة للخلف
    حدّث حالة كل سجل إلى 'منشور' وعيّن PublishedAt إلى الآن.✓ تم النسخ
    → صفوف معكوسة

النتيجة: تدفق نشر أمر واحد مع Airtable كمصدر الحقيقة.

اجمعها مع: filesystem · github

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

airtable + notion

تحويل تقرير Airtable إلى ملخص Notion

اسحب صفقات هذا الأسبوع الجديدة من CRM، ثم أنشئ صفحة Notion في /Sales مع جدول ملخص.✓ تم النسخ
airtable + filesystem

استخدم Airtable كـ CMS، أصدر ملفات Markdown

لكل سجل Blog مع Status=Ready، اكتب ملف .md تحت ./content/posts/ واقلب السجل إلى Published.✓ تم النسخ
airtable + github

إنشاء تلقائي لمشاكل GitHub من قائمة انتظار أخطاء Airtable

لكل خطأ في عرض Triage مع Severity=High، افتح مشكلة GitHub في acme/api بعنوان وخطوات إعادة الإنتاج.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
list_bases (none) اكتشاف المرة الأولى استدعاء API واحد
list_tables baseId: str, detailLevel?: str اعرض قاعدة بيانات قبل الاستعلام استدعاء API واحد
describe_table baseId: str, tableId: str اعرف الحقول قبل الفلترة استدعاء API واحد
list_records baseId, tableId, view?, filterByFormula?, sort?, pageSize? اقرأ البيانات مع المرشحات/الفرز استدعاء API واحد (يصفحة)
search_records baseId, tableId, searchTerm, fieldIds? البحث بالنص الحر عبر الحقول استدعاء API واحد
get_record baseId, tableId, recordId جلب سجل واحد معروف استدعاء API واحد
create_record baseId, tableId, fields إدراج سجل واحد استدعاء API واحد (كتابة)
update_records baseId, tableId, records[] التحديثات الجماعية استدعاء API واحد لكل 10 سجلات
delete_records baseId, tableId, recordIds تدميري — تأكد أولاً استدعاء API واحد (كتابة)
create_table baseId, name, fields[] إقلاع نموذج بيانات جديد استدعاء API واحد (كتابة schema)
list_comments baseId, tableId, recordId, offset?, pageSize? اقرأ سجل الخيط استدعاء API واحد

التكلفة والحدود

تكلفة التشغيل

حصة API
5 طلبات/ثانية لكل قاعدة بيانات (Team)، 50/ثانية على Enterprise Scale
الرموز لكل استدعاء
Schema: ~500 رمز. استجابات السجل: 200 رمز لكل صف حسب الحقول.
التكلفة المالية
Airtable مجاني/Team/Enterprise — وصول API على جميع الخطط المدفوعة؛ الخطة المجانية أيضاً تفضح API
نصيحة
استخدم pageSize و filterByFormula من جانب الخادم؛ سحب جدول كامل إلى السياق مضيعة.

الأمان

الصلاحيات والأسرار ونطاق الأثر

الحد الأدنى من الصلاحيات: schema.bases:read data.records:read
تخزين بيانات الاعتماد: استخدم PAT دقيق في متغير البيئة AIRTABLE_API_KEY؛ لا تستخدم أبداً رموز المستخدمين الكلاسيكية
نقل البيانات الخارجي: جميع الاستدعاءات إلى api.airtable.com عبر HTTPS
لا تمنح أبدًا: وصول كل قواعد البيانات عندما تكون قاعدة واحدة فقط ضرورية webhook:manage ما لم تكن مطلوبة

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

401 INVALID_API_KEY

PAT مفقود أو منتهي الصلاحية. أعد إنشاؤه على airtable.com/create/tokens.

تحقق: curl -H 'Authorization: Bearer $AIRTABLE_API_KEY' https://api.airtable.com/v0/meta/bases
403 NOT_AUTHORIZED

PAT لا يتضمن تلك القاعدة. عدّل قائمة نطاق الرمز وأضف القاعدة.

تحقق: curl يعيد القواعد التي تتوقعها
422 INVALID_REQUEST_UNKNOWN_FIELD

اسم الحقل لا يطابق schema. أعد وصف الجدول — Airtable يغير معرفات الحقول إذا تمت إعادة تسميتها.

تحقق: استدعِ describe_table مرة أخرى
429 rate limit

بطّئ إلى 5 طلبات/ثانية لكل قاعدة بيانات؛ عمليات كتابة جماعية.

تحقق: أعد المحاولة بعد 30 ثانية

البدائل

airtable-mcp-server مقابل البدائل

البديلمتى تستخدمهاالمقايضة
Notion MCPفريقك يعيش في قواعد بيانات Notion بدلاً من AirtableNotion أقل جدولياً؛ أسوأ للعمليات الضخمة للبيانات
Google Sheets MCPالبيانات موجودة في Sheetsلا يوجد schema منظم أو سجلات مرتبطة
Direct Airtable REST via fetch MCPتريد استدعاءات فردية ولا تريد MCP آخرأنت تكتب كل URL يدوياً

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills