תקציר צנרת מכירות ליום שני
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.
שרת MCP מאומת: Airtable
רשימת הכלים למטה היא לכידה חיה מהשרת הרץ; קריאת כלי מאומתת עדיין ממתינה להרשאות.
התשובה הקצרה
אומת לאחרונה 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]
אימות
השיטה
הרצנו את השרת עם 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. |
פרמטרים המסומנים ב-* הם חובה.
התקנה
העתיקו את הבלוק של האפליקציה שלכם. כל אחד מהם הוא ההגדרה המדויקת שאיתה אימתנו את השרת.
פתחו את הקובץ ~/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 mcp add airtable --env AIRTABLE_API_KEY=pat123.abc123 -- npx -y airtable-mcp-server
כל מה שאחרי המקף הכפול הוא הפקודה המדויקת ש-Claude Code יריץ, והדגל --env מעביר אליה את אישור הגישה שלכם. החליפו את pat123.abc123 בשלכם. [7][5]
הוסיפו ל-~/.cursor/mcp.json עבור כל הפרויקטים, או ל-.cursor/mcp.json בתוך פרויקט אחד:
{
"mcpServers": {
"airtable": {
"command": "npx",
"args": [
"-y",
"airtable-mcp-server"
],
"env": {
"AIRTABLE_API_KEY": "pat123.abc123"
}
}
}
}Cursor קורא את הקובץ מחדש אחרי הפעלה מחדש. העדיפו את הקובץ בתיקיית הבית: אישור גישה שנכתב בתוך קובץ של פרויקט נמצא קומיט אחד מלהיות פומבי. [8][5]
בלי קובץ 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]
בלי טרמינל
אם מעולם לא פתחתם את הטרמינל ואין לכם כוונה להתחיל, זה המסלול שלכם. Routines היא אפליקציית Mac שמריצה שרתי MCP בשבילכם: ממלאים כמה שדות פעם אחת, והכלים של השרת זמינים ל-AI שלכם בצ׳אט ובשגרות מתוזמנות.
01
הורידו את האפליקציה מ-getroutines.ai/download, גררו אותה ל-Applications והתחברו.
02
לחצו על החשבון שלכם בתחתית סרגל הצד ובחרו Settings. פתחו את הקטע Assistant, אחר כך את הלשונית Connections, גללו אל MCP Servers ולחצו על Add MCP Server.
03
השרת הזה הוא פקודה, לא כתובת אינטרנט, לכן העבירו את הטופס ל-Command (stdio). Name: Airtable. Command: npx. Arguments: -y airtable-mcp-server. זו כל הפקודה; אין תיקיות או אפשרויות נוספות להוסיף.
04
היכנסו ל-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 מצד אחד, אישור הגישה מהצד השני.
05
לחצו Test Connection: Routines מפעילה את השרת ומדווחת כמה כלים היא מצאה, שישה עשר עבור השרת הזה. אם המספר חוזר, לחצו Add Server.
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 והפעילו מחדש את השרת.
הפתרון
personal access token מגיע רק ל-bases שסימנתם בזמן היצירה שלו, ולכן base שחסר ברשימת list_bases הוא כמעט תמיד אישור גישה שמעולם לא קיבל גישה אליו. פתחו את אישור הגישה ב-airtable.com/create/tokens, הוסיפו את ה-base לרשימת הגישה שלו, שמרו והפעילו מחדש את השרת. הוספת base אינה דורשת אישור גישה חדש.
הפתרון
ההרשאות נפרדות מהגישה. אישור גישה עם הרשאות קריאה בלבד יציג ויחפש בשמחה ועדיין יסרב לכל כתיבה, וזו דרך התחלה הגיונית. כשתרצו שה-AI ייצור או יעדכן שורות, ערכו את אישור הגישה והוסיפו את הרשאות הכתיבה, ואז הפעילו מחדש את השרת כדי שיקרא אותו שוב.
הפתרון
הפקודה npx שייכת ל-Node.js. אם Node לא מותקן על ה-Mac, כל לקוח בעמוד הזה ייכשל בשלב ההפעלה עוד לפני שהשרת מספיק לומר משהו. התקינו Node מ-nodejs.org, הפעילו מחדש את לקוח ה-MCP ונסו שוב.
שאלות נפוצות
זו תוכנה קטנה שמחברת עוזר AI לחשבון ה-Airtable שלכם. ברגע שהיא רצה, העוזר יכול להציג את ה-bases והטבלאות שלכם, לקרוא ולחפש רשומות, וליצור, לעדכן או למחוק אותן, הכל דרך ה-API של Airtable עצמה. הוא רץ כתהליך מקומי על ה-Mac שלכם ומדבר עם אפליקציית ה-AI על גבי stdio. [1][4]
השרת הרץ חושף 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 החי, מילה במילה.
הטווח שלו הוא בדיוק הטווח של אישור הגישה שתיתנו לו, ולא יותר. זה חותך לשני הכיוונים: אישור גישה שמוגבל לשני bases ולהרשאות קריאה בלבד הוא חיבור צר ובסיכון נמוך, ואילו אישור גישה עם הרשאות כתיבה על כל סביבת העבודה מוסר לעוזר AI את היכולת לעדכן ולמחוק רשומות בכולה. delete_records הוא כלי אמיתי ברשימה שלמעלה. צרו אישור גישה נפרד לכל מטרה, סמנו רק את ה-bases שהמשימה צריכה, והוסיפו הרשאות כתיבה רק כשאתם באמת רוצים שיבוצעו שינויים. [4]
לא. ב-Routines ממלאים כמה שדות בהגדרות, מדביקים את אישור הגישה בשדה Environment Variables ולוחצים Test Connection; המדריך למעלה מראה כל לחיצה. Claude Desktop דורש עריכה חד-פעמית של קובץ JSON קטן. רק Claude Code הוא כלי טרמינל מטבעו. [9][6]
כן, וזה שלב ההתקנה האמיתי היחיד. צריך חשבון Airtable ו-personal access token שנוצר ב-airtable.com/create/tokens, לפחות עם ההרשאות schema.bases:read ו-data.records:read וגישה ל-bases שתרצו להשתמש בהם. אישור הגישה נכנס למשתנה סביבה בשם AIRTABLE_API_KEY. בלעדיו השרת עדיין עולה ועדיין מציג את הכלים שלו, וזה בדיוק מה שהריצה שלנו מראה, אבל כל קריאה ל-Airtable חוזרת כלא מאומתת. [4][5]
לא. הוא מתוחזק בידי מפתח יחיד בשם domdomegg, בחשבון GitHub אישי, ומפורסם ל-npm תחת רישיון MIT. לא מצאנו שום קשר לחברת Airtable במידע של החבילה או של המאגר. זו אינה ביקורת על הקוד, שרושם כ-8,000 הורדות בשבוע ב-npm, אבל היא כן אומרת שהתמיכה והעדכונים מגיעים ממתנדב אחד ולא מספק. [3][1][2]
מקורות
כל מה שבעמוד הזה שלא ראינו בעצמנו בריצה מקושר כאן, עם התאריך שבו קראנו אותו. לגבי השאר, הריצה עצמה היא הקבלה.
[1]
Latest version 1.14.0, published 2026-07-27; license MIT; maintainer domdomegg.
[2]
8,168 downloads for the week 2026-07-26 to 2026-08-01.
[3]
455 stars, pushed 2026-07-27, license MIT, owner domdomegg is an individual account, default branch master.
[4]
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]
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]
The official Claude Desktop quickstart: config file location and mcpServers shape.
[7]
The claude mcp add syntax for local stdio servers, including --env.
[8]
[9]
How Routines runs one-click OAuth connectors and any MCP server.
העמוד הזה מתאר את Airtable כפי שהתנהג בריצה מתוארכת אחת על Mac אחד. גרסאות משתנות: אם משהו כאן כבר לא תואם למה שאתם רואים, תאריך הלכידה בראש העמוד אומר בן כמה הצילום.
מאחורי המדריך הזה
Routines, האפליקציה שמאחורי המדריך הזה, מריצה שרתי MCP כמו זה בלי טרמינל: כך עובדים המחברים. הפתקים שלכם נשארים קובצי markdown על ה-Mac שלכם, אין חשבון ענן לשלם, והיא עובדת גם בלי אינטרנט. להורדת Routines