שימוש בשרת MCP מרוחק של Bigtable
במסמך הזה מוסבר איך להשתמש בשרת Model Context Protocol (MCP) מרוחק של Bigtable כדי להתחבר לאפליקציות AI, כולל Antigravity, ChatGPT, Claude ואפליקציות בהתאמה אישית שאתם מפתחים. שרתי ה-MCP המרוחקים של Bigtable מאפשרים לכם לנהל מכונות וטבלאות של Bigtable ולשלוח שאילתות לגבי הנתונים. משתמשים בשרת Admin MCP למשימות ניהול, ובשרת Data MCP כדי לשלוח שאילתות לטבלאות מאפליקציית ה-AI. שרת ה-MCP המרוחק של Bigtable מופעל כשמפעילים את ממשקי ה-API של Bigtable.Model Context Protocol (MCP) הוא תקן שמגדיר איך מודלים גדולים של שפה (LLM) ואפליקציות או סוכנים של AI מתחברים למקורות נתונים חיצוניים. שרתי MCP מאפשרים לכם להשתמש בכלים, במשאבים ובהנחיות שלהם כדי לבצע פעולות ולקבל נתונים מעודכנים משירות הקצה העורפי שלהם.
מה ההבדל בין שרתי MCP מקומיים לשרתי MCP מרוחקים?
- שרתי MCP מקומיים
- בדרך כלל פועלים במחשב המקומי ומשתמשים בזרמי הקלט והפלט הסטנדרטיים (stdio) לתקשורת בין שירותים באותו מכשיר.
- שרתי MCP מרוחקים
- הם פועלים בתשתית של השירות ומציעים נקודת קצה (endpoint) מסוג HTTP לאפליקציות AI, כדי לאפשר תקשורת בין לקוח ה-MCP של ה-AI לבין שרת ה-MCP. מידע נוסף על ארכיטקטורת MCP
ליבה ללא שמירת מצב
בגרסת MCP 2026-07-28, פרוטוקול MCP משתנה מפרוטוקול דו-כיווני עם שמירת מצב (stateful) לפרוטוקול ללא שמירת מצב (stateless).
כל בקשת MCP מתארת את עצמה ואפשר לנתב אותה באמצעות כותרות. אין צורך בלחיצת היד של initialize/initialized או ב-Mcp-Session-Id כי כל בקשה כוללת את כל המידע הנדרש בכותרות ה-HTTP או בפרמטר _meta. שרתי MCP יכולים לבקש מידע נוסף שנדרש לכלי באמצעות בקשות הלוך ושוב (MRTR).
כדי לנתב ולעבד בקשות בלי לנתח את גוף הבקשה, נדרשות כמה כותרות MCP, כולל:
- כותרות שנדרשות לפי מפרט ה-MCP, כמו כותרת גרסת הפרוטוקול וכותרות בקשה רגילות.
- כותרות בהתאמה אישית שמוגדרות על ידי שרת ה-MCP. הכותרות האלה משתקפות בכותרות HTTP מהסכימה של קלט הכלי באמצעות המאפיין
x-mcp-header. לדוגמה, שרת MCP יכול להגדיר כותרת מותאמת אישית כדי לציין את האזור או את מזהה הפרויקט ב- Google Cloud .
למידע נוסף על הארכיטקטורה של MCP, קראו את המפרט של MCP בגרסה 2026-07-28 ואת השינויים העיקריים.
לפני שמתחילים
- נכנסים לחשבון Google Cloud . אנחנו ממליצים למשתמשים חדשים ב- Google Cloud ליצור חשבון כדי שיוכלו להעריך את הביצועים של המוצרים שלנו בתרחישים מהעולם האמיתי. לקוחות חדשים מקבלים בחינם גם קרדיט בשווי 300$ להרצה, לבדיקה ולפריסה של עומסי העבודה.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
Enable the Bigtable Admin and Bigtable Data APIs, if any are not already enabled.
Roles required to enable APIs
To enable APIs, you need the
serviceusage.services.enablepermission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
Enable the Bigtable Admin and Bigtable Data APIs, if any are not already enabled.
Roles required to enable APIs
To enable APIs, you need the
serviceusage.services.enablepermission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.- מריצים את הפקודה הבאה כדי להתקין את ה-CLI של
cbt:gcloud components install cbt
התפקידים הנדרשים
כדי לקבל את ההרשאות שדרושות לשימוש בשרתי Bigtable MCP, בקשו מהאדמין להקצות לכם את התפקידים הבאים ב-IAM בפרויקט שבו אתם רוצים להשתמש בשרת Bigtable MCP:
-
לבצע קריאות API לכלי MCP:
משתמש בכלי MCP (
roles/mcp.toolUser) -
שימוש בשרת Admin MCP:
אדמין ב-Bigtable (
roles/bigtable.admin) -
משתמשים בשרת ה-MCP של הנתונים:
Bigtable Reader (
roles/bigtable.reader)
להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
התפקידים המוגדרים מראש האלה כוללים את ההרשאות שנדרשות כדי להשתמש בשרתי MCP של Bigtable. כדי לראות בדיוק אילו הרשאות נדרשות, אפשר להרחיב את הקטע ההרשאות הנדרשות:
ההרשאות הנדרשות
כדי להשתמש בשרתי MCP של Bigtable, נדרשות ההרשאות הבאות:
-
להפעיל קריאות API לכלי MCP:
mcp.tools.call -
משתמשים בשרת ה-MCP של האדמין:
-
bigtable.instances.create -
bigtable.instances.delete -
bigtable.instances.get -
bigtable.instances.list -
bigtable.tables.create -
bigtable.tables.delete -
bigtable.tables.get -
bigtable.tables.list
-
-
משתמשים בשרת MCP:
bigtable.instances.executeQuery
יכול להיות שתקבלו את ההרשאות האלה באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש אחרים.
אימות והרשאה
שרתי MCP של Bigtable משתמשים בפרוטוקול OAuth 2.0 עם ניהול זהויות והרשאות גישה (IAM) לאימות ולהרשאה. כל Google Cloud הזהויות נתמכות לאימות בשרתי MCP.
שרת ה-MCP המרוחק של Bigtable לא מקבל מפתחות API.
כדי שתוכלו לשלוט בגישה למשאבים ולעקוב אחריה, אנחנו ממליצים ליצור זהות נפרדת לסוכנים שמשתמשים בכלים של MCP. מידע נוסף על אימות בשרתי MCP
היקפי ההרשאות של Bigtable MCP OAuth
ב-OAuth 2.0 משתמשים בהיקפי הרשאות ובפרטי כניסה כדי לקבוע אם לחשבון משתמש מאומת מסוים מותר לבצע פעולה מסוימת במשאב. למידע נוסף על היקפי ההרשאות של OAuth 2.0 ב-Google, קראו את המאמר שימוש ב-OAuth 2.0 לגישה ל-Google APIs.
ל-Bigtable יש את היקפי ההרשאות הבאים ל-OAuth של כלי MCP:
| URI של היקף ההרשאות ל-CLI של gcloud | תיאור |
|---|---|
https://www.googleapis.com/auth/bigtable.admin |
גישה מלאה למשאבי Bigtable ואפשרות להקצות תפקידי IAM ב-Bigtable. |
https://www.googleapis.com/auth/bigtable.data |
הרשאת קריאה וכתיבה של נתונים שמאוחסנים בטבלאות של Bigtable. |
יכול להיות שיידרשו היקפי הרשאות נוספים במשאבים שאליהם ניגשים במהלך קריאת API לכלי. במאמר היקפי ההרשאות של Bigtable ב-OAuth מפורטת רשימת היקפי ההרשאות שנדרשים ל-Bigtable.
הגדרת לקוח MCP לשימוש בשרתי Bigtable MCP
אפליקציות וסוכני AI, כמו Claude או Antigravity, יכולים ליצור מופע של לקוח MCP שמתחבר לשרת MCP יחיד. לאפליקציית AI יכולים להיות כמה לקוחות שמתחברים לשרתי MCP שונים. אם האפליקציה שלכם לא מופיעה בהנחיות הספציפיות ללקוח, תוכלו להשתמש במידע הבא כדי להתחבר מרוב האפליקציות.באפליקציית ה-AI, מחפשים דרך להוסיף שרת MCP מרוחק או להתחבר אליו. בשרתי Bigtable MCP, מזינים את הפרטים הבאים, לפי הצורך:
- שם השרת:
- שרת MCP לניהול Bigtable
- שרת MCP של Bigtable Data
- כתובת ה-URL של השרת או נקודת הקצה (endpoint):
- Admin API: https://bigtableadmin.googleapis.com/mcp
- Data API: https://bigtable.googleapis.com/mcp
- תעבורה: HTTP שניתן להעביר בסטרימינג
- פרטי אימות: בהתאם לשיטת האימות שאתם רוצים להשתמש בה, אתם יכולים להזין את Google Cloud פרטי הכניסה, את מזהה הלקוח והסוד של OAuth או את פרטי הכניסה והזהות של הנציג. מידע נוסף על אימות זמין במאמר אימות בשרתי MCP.
- היקף הרשאות OAuth: היקף הרשאות OAuth של Bigtable שבו רוצים להשתמש כשמתחברים לשרתי MCP של Bigtable.
URI של הפניה אוטומטית
באפליקציות מבוססות-אינטרנט ובחלק מהאפליקציות למחשב, צריך להוסיף לרשימת ההיתרים URI להפניה אוטומטית כשיוצרים מזהה לקוח וסוד לאימות. שרת ההרשאות משתמש בכתובות URI להפניה אוטומטית כדי לשלוח אסימונים לאפליקציה. במסמכי התיעוד של האפליקציה צריך לציין את כתובת ה-URI להפניה אוטומטית שבה צריך להשתמש. אי אפשר להשתמש בכתובות URI מותאמות אישית להפניה אוטומטית.
במאמר הנחיות ספציפיות ללקוח מוסבר איך להגדיר שרת MCP ולהתחבר אליו באפליקציות ספציפיות.למידע כללי נוסף, אפשר לעיין במקורות המידע הבאים:
באילו כלים אפשר להשתמש
בחומר העזר בנושא Bigtable MCP מפורטים כלי ה-MCP הזמינים לשרת Bigtable MCP והתיאורים שלהם.
כלים לרשימות
משתמשים ב-MCP inspector כדי להציג רשימה של כלים, או שולחים בקשת HTTP מסוג tools/list ישירות לשרת MCP מרוחק של Bigtable. השיטה tools/list לא דורשת אימות.
לשרת Admin MCP, שולחים את הבקשה אל:
curl -X POST https://bigtableadmin.googleapis.com/TOOLSET_ENDPOINT \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'MCP-Protocol-Version: MCP_PROTOCOL_VERSION' \
-H 'Mcp-Method: tools/list' \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list",
"params": {
"_meta": {
"io.modelcontextprotocol/protocolVersion": "MCP_PROTOCOL_VERSION",
"io.modelcontextprotocol/clientCapabilities": {
"extensions": {
"io.modelcontextprotocol/ui": {
"mimeTypes": ["text/html;profile=mcp-app"]
}
}
}
}
}
}'
לשרת ה-MCP של הנתונים, שולחים את הבקשה אל:
curl -X POST https://bigtable.googleapis.com/TOOLSET_ENDPOINT \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'MCP-Protocol-Version: MCP_PROTOCOL_VERSION' \
-H 'Mcp-Method: tools/list' \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list",
"params": {
"_meta": {
"io.modelcontextprotocol/protocolVersion": "MCP_PROTOCOL_VERSION",
"io.modelcontextprotocol/clientCapabilities": {
"extensions": {
"io.modelcontextprotocol/ui": {
"mimeTypes": ["text/html;profile=mcp-app"]
}
}
}
}
}
}'
מחליפים את מה שכתוב בשדות הבאים:
-
TOOLSET_ENDPOINT: החלק שנותר בנקודת הקצה של ה-MCP אחרי שם השירות. לדוגמה, ב-Bigtable זה יכול להיותmcp/toolset-name. -
MCP_PROTOCOL_VERSION: גרסת פרוטוקול ה-MCP. לדוגמה,2026-07-28.
פרומפטים לדוגמה
אתם יכולים להשתמש בהנחיות לדוגמה הבאות כדי ליצור או למחוק משאבים ב-Bigtable ולקבל מידע עליהם.
הנחיות לדוגמה לאדמינים
- "צור מכונה INSTANCE_ID בפרויקט PROJECT_ID באזור ZONE_ID עם NODES צמתים".
- "הצגת רשימה של המכונות בפרויקט PROJECT_ID".
- "Get instance INSTANCE_ID in project PROJECT_ID."
- "מחיקת המכונה INSTANCE_ID בפרויקט PROJECT_ID".
- "צור טבלה TABLE_ID במכונה INSTANCE_ID בפרויקט PROJECT_ID".
- "הצגת רשימת הטבלאות במכונה INSTANCE_ID בפרויקט PROJECT_ID".
- "הצגת הטבלה TABLE_ID בפרויקט PROJECT_ID ב-INSTANCE_ID".
- "מחיקת הטבלה TABLE_ID במכונה INSTANCE_ID בפרויקט PROJECT_ID".
בהנחיות, מחליפים את מה שכתוב בשדות הבאים:
- PROJECT_ID במזהה הפרויקט ב- Google Cloud .
- INSTANCE_ID במזהה המכונה של Bigtable.
- ZONE_ID באזור שבו האשכול פועל.
- TABLE_ID במזהה הטבלה ב-Bigtable.
- אם רוצים לשלוט במספר הצמתים באשכול, מחליפים את NODES במספר הצמתים שרוצים באשכול. אם לא מציינים ערך, ברירת המחדל היא
1.
הנחיות לדוגמה לשאילתות על נתונים
- "הפעל שאילתה כדי לאחזר עד 10 שורות מהטבלה TABLE_ID במכונה INSTANCE_ID בפרויקט PROJECT_ID".
- "הפעלת שאילתת SQL במכונה INSTANCE_ID בפרויקט PROJECT_ID:
SELECT _key, column_family, value FROM TABLE_ID WHERE row_key LIKE USER_ID". - "אחזור נתונים ממכונה INSTANCE_ID של Bigtable, פרויקט PROJECT_ID באמצעות פרופיל האפליקציה APP_PROFILE_ID עם השאילתה:
SELECT * FROM TABLE_ID WHERE cf1['status'] = 'ERROR'".
בהנחיות, מחליפים את מה שכתוב בשדות הבאים:
- TABLE_ID במזהה הטבלה ב-Bigtable.
- INSTANCE_ID במזהה המכונה של Bigtable.
- PROJECT_ID במזהה הפרויקט ב- Google Cloud .
- USER_ID עם התבנית או מפתח השורה של המשתמש שרוצים לשלוח לגביו שאילתה.
- APP_PROFILE_ID במזהה של פרופיל האפליקציה.
הגדרות אופציונליות של אבטחה ובטיחות
בגלל המגוון הרחב של הפעולות שאפשר לבצע באמצעות כלי MCP, הוא מביא איתו סיכוני אבטחה ושיקולים חדשים. כדי לצמצם ולנהל את הסיכונים האלה,Google Cloud מציע הגדרות ברירת מחדל וכללי מדיניות שניתן להתאים אישית כדי לשלוט בשימוש בכלי MCP בארגון או בפרויקט ב- Google Cloud.
מידע נוסף על אבטחה ופיקוח ב-MCP זמין במאמר אבטחה ובטיחות ב-AI.
שימוש ב-Model Armor
הגנה מוגברת על המודל היא שירות שלGoogle Cloud שנועד לשפר את האבטחה והבטיחות של אפליקציות ה-AI שלכם. הוא פועל באופן יזום כדי לסנן הנחיות ותשובות של מודלי LLM, להגן מפני סיכונים שונים ולתמוך בשיטות לפיתוח אחראי של AI. לא משנה אם אתם פורסים את ה-AI בסביבת הענן שלכם או אצל ספקי שירותי ענן חיצוניים, אתם יכולים להשתמש ב"הגנה מוגברת על המודל" כדי למנוע קלט זדוני, לוודא שהתוכן בטוח, להגן על מידע אישי רגיש, לשמור על תאימות ולאכוף את מדיניות הבטיחות והאבטחה של ה-AI באופן עקבי בכל סביבת ה-AI המגוונת שלכם.
כשהתכונה "הגנה מוגברת על המודל" מופעלת והרישום ביומן מופעל, התכונה מתעדת ביומן את כל המטען הייעודי (payload). זה עלול לחשוף מידע רגיש ביומנים.
ניתוב בקשות של MCP ל-Model Armor
התכונה "הגנה מוגברת על המודל" זמינה באזורים מסוימים. אם אתם מפעילים את Model Armor ומשתמשים בשרת MCP בסמכות שיפוט שלא נתמכת על ידי Model Armor, יכול להיות שהניתוב של הקריאה יהיה שונה בשרתי MCP שונים, ושהוא יפר את התאימות של מיקום אחסון הנתונים לנתונים שנמצאים בשימוש ובמעבר. מידע נוסף על ההתנהגות של שרתי MCP ספציפיים זמין במאמר מוצרים שנתמכים ב-Model Armor.הפעלת Model Armor
כדי להשתמש ב-Model Armor, צריך להפעיל את ממשקי ה-API של Model Armor.
המסוף
מפעילים את Model Armor API, אם הוא עדיין לא מופעל.
התפקידים שנדרשים כדי להפעיל ממשקי API
כדי להפעיל ממשקי API, צריך את ההרשאה
serviceusage.services.enable. אם אתם יצרתם את הפרויקט, סביר להניח שכבר יש לכם את ההרשאה הזו דרך התפקיד "בעלים" (roles/owner). אחרת, אתם יכולים לקבל את ההרשאה הזו דרך התפקיד "אדמין בממשק 'שימוש בשירות'" (roles/serviceusage.serviceUsageAdmin). איך מקצים תפקידים?בוחרים את הפרויקט שבו רוצים להפעיל את Model Armor.
gcloud
לפני שמתחילים, מבצעים את השלבים הבאים באמצעות Google Cloud CLI עם Model Armor API:
מפעילים את Cloud Shell במסוף Google Cloud .
בחלק התחתון של מסוף Google Cloud יתחיל סשן של Cloud Shell ותופיע הודעה של שורת הפקודה. Cloud Shell היא סביבת מעטפת שבה ה-CLI של Google Cloud מותקן ומוגדרים ערכים לפרויקט הקיים. הסשן יופעל תוך כמה שניות.
-
מריצים את הפקודה הבאה כדי להגדיר את נקודת הקצה ל-API של שירות Model Armor.
gcloud config set api_endpoint_overrides/modelarmor "https://modelarmor.LOCATION.rep.googleapis.com/"
מחליפים את
LOCATIONבאזור שבו רוצים להשתמש ב-Model Armor.
הגדרת הגנה לשרתי MCP של Google ו Google Cloud שרתי MCP מרוחקים
כדי להגן על קריאות ה-API לכלי והתשובות של כלי ה-MCP, אתם יכולים להשתמש בהגדרות אבטחה מינימליות של הגנה מוגברת על המודל. הגדרת רצפה קובעת את מסנני האבטחה המינימליים שחלים על הפרויקט. ההגדרה הזו מחילה קבוצה עקבית של מסננים על כל הקריאות לכלים של MCP והתשובות שלהם בפרויקט.
מגדירים את הסף של Model Armor כשהסרת תוכן זדוני או רגיש ב-MCP מופעלת. מידע נוסף זמין במאמר הגדרת רמות הסינון של Model Armor.
דוגמה לפקודה:
gcloud model-armor floorsettings update \ --full-uri='projects/PROJECT_ID/locations/global/floorSetting' \ --enable-floor-setting-enforcement=TRUE \ --add-integrated-services=GOOGLE_MCP_SERVER \ --google-mcp-server-enforcement-type=INSPECT_AND_BLOCK \ --enable-google-mcp-server-cloud-logging \ --malicious-uri-filter-settings-enforcement=ENABLED \ --add-rai-settings-filters='[{"confidenceLevel": "MEDIUM_AND_ABOVE", "filterType": "DANGEROUS"}]'
מחליפים את PROJECT_ID במזהה הפרויקט ב- Google Cloud .
שימו לב להגדרות הבאות:
-
INSPECT_AND_BLOCK: סוג האכיפה שבודק את התוכן בשרת MCP של Google וחוסם הנחיות ותשובות שתואמות למסננים. -
ENABLED: ההגדרה שמפעילה סינון או אכיפה. -
MEDIUM_AND_ABOVE: רמת הסמך של הגדרות הסינון של Responsible AI - Dangerous. אפשר לשנות את ההגדרה הזו, אבל ערכים נמוכים יותר עלולים לגרום ליותר תוצאות חיוביות כוזבות. מידע נוסף מופיע במאמר רמות הסמך של Model Armor.
השבתת הסריקה של תנועת MCP באמצעות Model Armor
כדי להפסיק את הסריקה האוטומטית של הגנה מוגברת על המודל לתעבורת נתונים אל שרתי MCP וממנה, על סמך הגדרות אבטחה מינימליות של הפרויקט, מריצים את הפקודה הבאה:
gcloud model-armor floorsettings update \
--full-uri='projects/PROJECT_ID/locations/global/floorSetting' \
--remove-integrated-services=GOOGLE_MCP_SERVER
מחליפים את PROJECT_ID במזהה הפרויקט ב- Google Cloud . התכונה "הגנה מוגברת על המודל" לא מחילה באופן אוטומטי את הכללים שמוגדרים בהגדרות המינימום של הפרויקט הזה על תנועה בשרת MCP של Google.
הגדרות הסף וההגדרות הכלליות של Model Armor יכולות להשפיע על יותר מאשר רק MCP. מכיוון שהגנה מוגברת על המודל משתלבת עם שירותים כמו Vertex AI, כל שינוי שתבצעו בהגדרות של רף הסינון יכול להשפיע על סריקת התנועה ועל התנהגויות הבטיחות בכל השירותים המשולבים, ולא רק ב-MCP.
שליטה בשימוש ב-MCP באמצעות מדיניות IAM
כללי מדיניות הדחייה וכללי מדיניות ההרשאה של ניהול זהויות והרשאות גישה (IAM) עוזרים לכם לאבטח את Google Cloud ואת שרתי Google MCP.
אתם יכולים לשלב כמה קריטריונים כדי ליצור מדיניות אבטחה ופיקוח בהתאמה אישית, על ידי מתן גישה או דחיית גישה על סמך:
- חשבון המשתמש.
- מאפייני כלים כמו המאפיין "לקריאה בלבד".
- שם השירות או שם הכלי.
- מזהה הלקוח ב-OAuth של האפליקציה.
מידע נוסף זמין במאמר שליטה בשימוש ב-MCP באמצעות ניהול זהויות והרשאות גישה.
המאמרים הבאים
- מאמרי העזרה של Bigtable MCP
- מידע נוסף על שרתי MCP של Google Cloud
- שיטות מומלצות לאבטחת האינטראקציות של הנציגים באמצעות Model Context Protocol