שרת MCP מאומת: Airtable

שרת ה-MCP ל-Airtable, אומת בריצה חיה על Mac אמיתי.

  • הכלים נספרו2026-08-03macOS 15.7.7
  • חבילהairtable-mcp-server 1.14.0
  • מדווח על עצמוairtable-mcp-server 1.14.0
  • פרוטוקול MCP2024-11-05
  • סביבת ריצהv24.18.0

רשימת הכלים למטה היא לכידה חיה מהשרת הרץ; קריאת כלי מאומתת עדיין ממתינה להרשאות.

התשובה הקצרה

אומת לאחרונה 2026-08-03

שרת ה-MCP ל-Airtable נותן לעוזר AI גישת קריאה וכתיבה ל-bases שלכם ב-Airtable: להציג bases וטבלאות, לחפש ולסנן רשומות, ליצור ולעדכן שורות, להוסיף שדות ולהשאיר תגובות. זהו פרויקט קהילתי של מפתח יחיד בשם domdomegg, ולא מוצר של חברת Airtable, והוא רושם כ-8,000 הורדות בשבוע ב-npm. הוא רץ על ה-Mac שלכם על גבי stdio ודורש בדיוק אישור גישה אחד: personal access token של Airtable במשתנה סביבה בשם AIRTABLE_API_KEY. הרצנו אותו ודיברנו איתו בפרוטוקול עם אישור גישה מדומה, כך שכל 16 הכלים שלמטה נספרו בריצה חיה מבלי שנגענו באף base אמיתי. קריאת הכלי היחידה שביצענו חזרה עם שגיאת האימות המדויקת ש-Airtable מחזירה בלי אישור גישה תקין, והשגיאה הזו מודפסת בהמשך, מילה במילה. קריאה מאומתת עדיין פתוחה: היא ממתינה לאישור גישה אמיתי. [1][3][2][4]

  • כלים

    16, נספרו בריצה חיה

  • אישורי גישה

    נדרש AIRTABLE_API_KEY [4][5]

  • ערוץ תקשורת

    stdio, רץ על ה-Mac שלכם [4]

  • מתחזק

    domdomegg, קהילתי [3][1]

  • הורדות

    8,168 בשבוע האחרון [2]

  • רישיון

    MIT [3][1]

אימות

איך שרת ה-MCP הזה אומת.

השיטה

הרצנו את השרת עם npx על גבי stdio, השלמנו את לחיצת היד של MCP, קראנו ל-tools/list והרצנו קריאת כלי אמיתית אחת, list_bases. הערך שהעברנו ב-AIRTABLE_API_KEY היה מדומה ולא אישור גישה תקין, ולכן 16 הכלים שלמטה נספרו באמת בזמן שקריאת הכלי חזרה עם שגיאת האימות של Airtable, המודפסת מילה במילה בקריאת הדוגמה ובקטע פתרון התקלות. השרת הזה אינו כותב דבר לפלט השגיאה בהפעלה, ולכן מה שמוצג למטה בשדה הבאנר הוא תשובת ה-initialize ששלח על גבי החיבור. קריאה מאומתת אינה חלק מהריצה הזו: היא דורשת personal access token אמיתי של Airtable.

הודעת הפתיחה של השרת

{"result":{"protocolVersion":"2024-11-05","capabilities":{"tools":{"listChanged":true}},"serverInfo":{"name":"airtable-mcp-server","version":"1.14.0"}},"jsonrpc":"2.0","id":1}

קריאת כלי אמיתית אחת

tools/call list_bases {}
Airtable API Error: Unauthorized. Response: {"error":{"type":"AUTHENTICATION_REQUIRED","message":"Authentication required"}}Suggestions: Expected one dot (.) in the API key, but found 0. Make sure you've copied the entire API key, not just the token ID. API key seems too short (13 characters). Personal Access Tokens are typically around 82 characters long. Make sure you've copied the API key correctly. Verify that the token hasn't expired or been revoked. You can view and create Personal Access Tokens at https://airtable.com/create/tokens.

שורות אמיתיות מהתוצאה שנלכדה: מספיק כדי להוכיח שהקריאה נענתה.

כלים

הכלים, כפי שנספרו מהשרת הרץ.

השרת ענה ל-tools/list עם 16 כלים בתאריך 2026-08-03. השמות, התיאורים והפרמטרים למטה הם המילים שלו עצמו, מועתקים מהתשובה הזו וללא עריכה.

כלימה הוא עושה
list_recordsbaseId*tableId*viewmaxRecordsfilterByFormulasortfields

List records from a table

search_recordsbaseId*tableId*searchTerm*fieldIdsmaxRecordsview

Search for records containing specific text

list_bases

List all accessible Airtable bases

list_tablesbaseId*detailLevel

List all tables in a specific base

describe_tablebaseId*tableId*detailLevel

Get detailed information about a specific table

get_recordbaseId*tableId*recordId*

Get a specific record by ID

create_recordbaseId*tableId*fields*

Create a new record in a table

update_recordsbaseId*tableId*records*

Update up to 10 records in a table

delete_recordsbaseId*tableId*recordIds*

Delete records from a table

create_tablebaseId*name*fields*description

Create a new table in a base

update_tablebaseId*tableId*namedescription

Update a table's name or description

create_fieldbaseId*tableId*nested*

Create a new field in a table

update_fieldbaseId*tableId*fieldId*namedescription

Update a field's name or description

create_commentbaseId*tableId*recordId*text*parentCommentId

Create a comment on a record

list_commentsbaseId*tableId*recordId*pageSizeoffset

List comments on a record

upload_attachmentbaseId*recordId*attachmentFieldIdOrName*file*filename*contentType*

Upload a file directly to an attachment field on an existing record using Airtable's upload API. Supports files up to 5 MB. For larger files, use create_record or update_records with a public URL. The record must already exist.

פרמטרים המסומנים ב-* הם חובה.

התקנה

הגדרות שעובדות, אחת לכל אפליקציה.

העתיקו את הבלוק של האפליקציה שלכם. כל אחד מהם הוא ההגדרה המדויקת שאיתה אימתנו את השרת.

Claude Desktop

פתחו את הקובץ ‎~/Library/Application Support/Claude/claude_desktop_config.json (בתוך Claude Desktop: Settings, אחר כך Developer, אחר כך Edit Config) והוסיפו:

{
  "mcpServers": {
    "airtable": {
      "command": "npx",
      "args": [
        "-y",
        "airtable-mcp-server"
      ],
      "env": {
        "AIRTABLE_API_KEY": "pat123.abc123"
      }
    }
  }
}

החליפו את pat123.abc123 באישור הגישה האישי שלכם מ-Airtable, ואז סגרו ופתחו מחדש את Claude Desktop. הערך המדומה הזה הוא זה שמופיע בתיעוד של המתחזק, והוא אינו אישור גישה עובד. [6][5]

Claude Code

פקודה אחת בטרמינל:

claude mcp add airtable --env AIRTABLE_API_KEY=pat123.abc123 -- npx -y airtable-mcp-server

כל מה שאחרי המקף הכפול הוא הפקודה המדויקת ש-Claude Code יריץ, והדגל ‎--env מעביר אליה את אישור הגישה שלכם. החליפו את pat123.abc123 בשלכם. [7][5]

Cursor

הוסיפו ל-‎~/.cursor/mcp.json עבור כל הפרויקטים, או ל-‎.cursor/mcp.json בתוך פרויקט אחד:

{
  "mcpServers": {
    "airtable": {
      "command": "npx",
      "args": [
        "-y",
        "airtable-mcp-server"
      ],
      "env": {
        "AIRTABLE_API_KEY": "pat123.abc123"
      }
    }
  }
}

Cursor קורא את הקובץ מחדש אחרי הפעלה מחדש. העדיפו את הקובץ בתיקיית הבית: אישור גישה שנכתב בתוך קובץ של פרויקט נמצא קומיט אחד מלהיות פומבי. [8][5]

Routines

בלי קובץ JSON ובלי טרמינל. ב-Routines: Settings, אחר כך Assistant, אחר כך Connections, אחר כך Add MCP Server. העבירו את הטופס ל-Command (stdio) והזינו:

Name                   Airtable
Command                npx
Arguments              -y airtable-mcp-server
Environment Variables  AIRTABLE_API_KEY=pat123.abc123

השדה Environment Variables מקבל שורה אחת בפורמט KEY=value, לכן הדביקו את אישור הגישה שלכם במקום pat123.abc123. לחצו קודם על Test Connection: שרת תקין עונה עם מספר הכלים שלו. [9][5]

בלי טרמינל

איך מגדירים את שרת ה-MCP‏ Airtable בלי טרמינל.

אם מעולם לא פתחתם את הטרמינל ואין לכם כוונה להתחיל, זה המסלול שלכם. Routines היא אפליקציית Mac שמריצה שרתי MCP בשבילכם: ממלאים כמה שדות פעם אחת, והכלים של השרת זמינים ל-AI שלכם בצ׳אט ובשגרות מתוזמנות.

  1. 01

    התקינו את Routines

    הורידו את האפליקציה מ-getroutines.ai/download, גררו אותה ל-Applications והתחברו.

  2. 02

    פתחו את הגדרות ה-MCP

    לחצו על החשבון שלכם בתחתית סרגל הצד ובחרו Settings. פתחו את הקטע Assistant, אחר כך את הלשונית Connections, גללו אל MCP Servers ולחצו על Add MCP Server.

  3. 03

    בחרו Command (stdio)‎

    השרת הזה הוא פקודה, לא כתובת אינטרנט, לכן העבירו את הטופס ל-Command (stdio). Name: Airtable. Command: npx. Arguments: ‎-y airtable-mcp-server. זו כל הפקודה; אין תיקיות או אפשרויות נוספות להוסיף.

  4. 04

    צרו אישור גישה ב-Airtable והדביקו אותו

    היכנסו ל-airtable.com/create/tokens וצרו personal access token. תנו לו את ההרשאות schema.bases:read ו-data.records:read כדי לקרוא את הנתונים, ובנוסף schema.bases:write ו-data.records:write אם תרצו שה-AI ישנה אותם, וסמנו רק את ה-bases שהוא אמור להגיע אליהם. העתיקו את אישור הגישה, ואז ב-Routines הוסיפו שורה אחת ל-Environment Variables: AIRTABLE_API_KEY מצד אחד, אישור הגישה מהצד השני.

  5. 05

    בדקו, ואז הוסיפו

    לחצו Test Connection: Routines מפעילה את השרת ומדווחת כמה כלים היא מצאה, שישה עשר עבור השרת הזה. אם המספר חוזר, לחצו Add Server.

  6. 06

    השתמשו בו

    הכלים עובדים בצ׳אט מיד. כדי לתת לשגרה מתוזמנת להשתמש בהם, פתחו את השגרה, מצאו את הכרטיס Tools & connections וסמנו את השרת תחת Apps.

רעיונות לשגרות

שגרות ששווה לתזמן.

אחרי שהשרת מחובר, שגרה מתוזמנת יכולה להשתמש בכלים שלו גם כשאתם לא מול המסך. העתיקו פרומפט, הדביקו אותו ב-Routines ובחרו שעה. הפרומפטים כתובים באנגלית בכוונה, מדביקים אותם בדיוק כפי שהם.

תקציר צנרת מכירות ליום שני

פרומפט

Every Monday at 8:30, search my Sales base for deals that are not closed, group them by owner, and give me a short digest of what moved last week and what has not been touched in more than two weeks.

תזכורת למשימות תקועות

פרומפט

Every weekday at 17:00, list the records in my Projects base with a due date in the past and no completion date, show me the owner and the due date for each, and add a comment on the three oldest asking for an update.

בדיקת תוכן ליום שישי

פרומפט

Every Friday at 15:00, look at the rows in my Content base scheduled for next week, tell me which ones still have an empty Status or no owner, and set the empty ones to Draft so nothing goes out unassigned.

פתרון תקלות

השגיאות שנתקלנו בהן, ומה פתר אותן.

שגיאות אמיתיות שנלכדו בריצת האימות, מודפסות בדיוק כפי שהשרת החזיר אותן.

הכלים מופיעים אבל כל קריאה חוזרת כלא מאומתת

מה רואים

Airtable API Error: Unauthorized. Response: {"error":{"type":"AUTHENTICATION_REQUIRED","message":"Authentication required"}}Suggestions: Expected one dot (.) in the API key, but found 0. Make sure you've copied the entire API key, not just the token ID. API key seems too short (13 characters). Personal Access Tokens are typically around 82 characters long. Make sure you've copied the API key correctly. Verify that the token hasn't expired or been revoked. You can view and create Personal Access Tokens at https://airtable.com/create/tokens.

הפתרון

זו השגיאה שהריצה שלנו הפיקה בכוונה, כי הפעלנו את השרת עם ערך מדומה ב-AIRTABLE_API_KEY. השרת בודק את הצורה של מה שנתתם לו עוד לפני ש-Airtable עונה: personal access token אמיתי הוא ארוך, כ-82 תווים, ומכיל נקודה אחת. אם שלכם קצר או בלי נקודה, העתקתם את מזהה אישור הגישה במקום את אישור הגישה עצמו, או שההעתקה נקטעה. צרו אישור גישה חדש ב-airtable.com/create/tokens, העתיקו את כל המחרוזת בפעם אחת, הדביקו אותה לערך של AIRTABLE_API_KEY והפעילו מחדש את השרת.

base שבבעלותכם לא מופיע

הפתרון

personal access token מגיע רק ל-bases שסימנתם בזמן היצירה שלו, ולכן base שחסר ברשימת list_bases הוא כמעט תמיד אישור גישה שמעולם לא קיבל גישה אליו. פתחו את אישור הגישה ב-airtable.com/create/tokens, הוסיפו את ה-base לרשימת הגישה שלו, שמרו והפעילו מחדש את השרת. הוספת base אינה דורשת אישור גישה חדש.

הקריאה עובדת אבל אי אפשר לשנות דבר

הפתרון

ההרשאות נפרדות מהגישה. אישור גישה עם הרשאות קריאה בלבד יציג ויחפש בשמחה ועדיין יסרב לכל כתיבה, וזו דרך התחלה הגיונית. כשתרצו שה-AI ייצור או יעדכן שורות, ערכו את אישור הגישה והוסיפו את הרשאות הכתיבה, ואז הפעילו מחדש את השרת כדי שיקרא אותו שוב.

לקוח ה-MCP לא מצליח להפעיל את השרת בכלל

הפתרון

הפקודה npx שייכת ל-Node.js. אם Node לא מותקן על ה-Mac, כל לקוח בעמוד הזה ייכשל בשלב ההפעלה עוד לפני שהשרת מספיק לומר משהו. התקינו Node מ-nodejs.org, הפעילו מחדש את לקוח ה-MCP ונסו שוב.

שאלות נפוצות

שאלות שאנשים שואלים.

מה זה שרת ה-MCP ל-Airtable?

זו תוכנה קטנה שמחברת עוזר AI לחשבון ה-Airtable שלכם. ברגע שהיא רצה, העוזר יכול להציג את ה-bases והטבלאות שלכם, לקרוא ולחפש רשומות, וליצור, לעדכן או למחוק אותן, הכל דרך ה-API של Airtable עצמה. הוא רץ כתהליך מקומי על ה-Mac שלכם ומדבר עם אפליקציית ה-AI על גבי stdio. [1][4]

אילו כלים כלולים בשרת ה-MCP ל-Airtable?

השרת הרץ חושף 16 כלים: איתור (list_bases, list_tables, describe_table, list_records, search_records, get_record), שינוי רשומות (create_record, update_records, delete_records, upload_attachment), שינוי מבנה (create_table, update_table, create_field, update_field) ותגובות (create_comment, list_comments). הטבלה למעלה היא פלט ה-tools/list החי, מילה במילה.

האם שרת ה-MCP ל-Airtable בטוח?

הטווח שלו הוא בדיוק הטווח של אישור הגישה שתיתנו לו, ולא יותר. זה חותך לשני הכיוונים: אישור גישה שמוגבל לשני bases ולהרשאות קריאה בלבד הוא חיבור צר ובסיכון נמוך, ואילו אישור גישה עם הרשאות כתיבה על כל סביבת העבודה מוסר לעוזר AI את היכולת לעדכן ולמחוק רשומות בכולה. delete_records הוא כלי אמיתי ברשימה שלמעלה. צרו אישור גישה נפרד לכל מטרה, סמנו רק את ה-bases שהמשימה צריכה, והוסיפו הרשאות כתיבה רק כשאתם באמת רוצים שיבוצעו שינויים. [4]

צריך טרמינל כדי להגדיר אותו?

לא. ב-Routines ממלאים כמה שדות בהגדרות, מדביקים את אישור הגישה בשדה Environment Variables ולוחצים Test Connection; המדריך למעלה מראה כל לחיצה. Claude Desktop דורש עריכה חד-פעמית של קובץ JSON קטן. רק Claude Code הוא כלי טרמינל מטבעו. [9][6]

הוא דורש מפתח API או חשבון?

כן, וזה שלב ההתקנה האמיתי היחיד. צריך חשבון Airtable ו-personal access token שנוצר ב-airtable.com/create/tokens, לפחות עם ההרשאות schema.bases:read ו-data.records:read וגישה ל-bases שתרצו להשתמש בהם. אישור הגישה נכנס למשתנה סביבה בשם AIRTABLE_API_KEY. בלעדיו השרת עדיין עולה ועדיין מציג את הכלים שלו, וזה בדיוק מה שהריצה שלנו מראה, אבל כל קריאה ל-Airtable חוזרת כלא מאומתת. [4][5]

האם זה שרת רשמי של Airtable?

לא. הוא מתוחזק בידי מפתח יחיד בשם domdomegg, בחשבון GitHub אישי, ומפורסם ל-npm תחת רישיון MIT. לא מצאנו שום קשר לחברת Airtable במידע של החבילה או של המאגר. זו אינה ביקורת על הקוד, שרושם כ-8,000 הורדות בשבוע ב-npm, אבל היא כן אומרת שהתמיכה והעדכונים מגיעים ממתנדב אחד ולא מספק. [3][1][2]

אילו אפליקציות יכולות להשתמש בשרת ה-MCP ל-Airtable?

כל לקוח MCP שמסוגל להפעיל שרת stdio מקומי: Claude Desktop, Claude Code, Cursor ו-Routines כולם יכולים, וההגדרה המדויקת לכל אחד נמצאת למעלה. השרת עצמו זהה בכל לקוח; רק המקום שבו מדביקים את ההגדרה ואת אישור הגישה משתנה. [6][7][8][9]

מקורות

כל טענה חיצונית, עם קבלה.

כל מה שבעמוד הזה שלא ראינו בעצמנו בריצה מקושר כאן, עם התאריך שבו קראנו אותו. לגבי השאר, הריצה עצמה היא הקבלה.

  1. [1]

    npm registry: airtable-mcp-serverנקרא בתאריך 2026-08-03

    Latest version 1.14.0, published 2026-07-27; license MIT; maintainer domdomegg.

  2. [2]

    npm downloads API: last weekנקרא בתאריך 2026-08-03

    8,168 downloads for the week 2026-07-26 to 2026-08-01.

  3. [3]

    GitHub API: domdomegg/airtable-mcp-serverנקרא בתאריך 2026-08-03

    455 stars, pushed 2026-07-27, license MIT, owner domdomegg is an individual account, default branch master.

  4. [4]

    airtable-mcp-server README (master branch)נקרא בתאריך 2026-08-03

    Source of the description, the token scopes, the install link and the documented tool list. Read from master: the same path on a main branch returns 404, because the repository default branch is master.

  5. [5]

    Client config encoded in the README install linkנקרא בתאריך 2026-08-03

    The README links to a generator instead of printing a config. We decoded its base64 config parameter locally: command npx, args -y airtable-mcp-server, env AIRTABLE_API_KEY set to the placeholder pat123.abc123.

  6. [6]

    modelcontextprotocol.io: Connect to local MCP serversנקרא בתאריך 2026-08-03

    The official Claude Desktop quickstart: config file location and mcpServers shape.

  7. [7]

    Claude Code docs: MCPנקרא בתאריך 2026-08-03

    The claude mcp add syntax for local stdio servers, including --env.

  8. [8]

    Cursor docs: Model Context Protocolנקרא בתאריך 2026-08-03

    The mcp.json shape and file locations.

  9. [9]

    Routines: Connectorsנקרא בתאריך 2026-08-03

    How Routines runs one-click OAuth connectors and any MCP server.

העמוד הזה מתאר את Airtable כפי שהתנהג בריצה מתוארכת אחת על Mac אחד. גרסאות משתנות: אם משהו כאן כבר לא תואם למה שאתם רואים, תאריך הלכידה בראש העמוד אומר בן כמה הצילום.

מאחורי המדריך הזה

Routines, האפליקציה שמאחורי המדריך הזה, מריצה שרתי MCP כמו זה בלי טרמינל: כך עובדים המחברים. הפתקים שלכם נשארים קובצי markdown על ה-Mac שלכם, אין חשבון ענן לשלם, והיא עובדת גם בלי אינטרנט. להורדת Routines