از «حالت توسعه‌دهنده برنامه‌های Gemini» برای آزمایش تعاملی سرور «پروتکل زمینه مدل» (MCP)، تشخیص خطاهای طرح‌واره یا زمان اجرا، و محک زدن کیفیت ابزار قبل‌از ارسال برنامه متصل‌شده برای بازبینی در کنسول متصل‌شده Google استفاده کنید.
این راهنما شامل کارهای زیر است:
- «حالت توسعه‌دهنده برنامه‌های Gemini» را در Gemini فعال کنید، یک برنامه MCP سفارشی ایجاد کنید، و شناسایی اولیه ابزار را تأیید کنید.
- اشکال‌زدایی فراخوانی‌های ناموفق ابزار، همگام‌سازی طرح‌واره‌های به‌روزشده، و آزمایش اصالت‌سنجی.
- شبیه‌سازی بافت محیط کاربر و پیکربندی اصالت‌سنجی کارخواه.
برای آشنایی با چیدمان فضای کاری و برگه‌های بازرس، نمای کلی «حالت توسعه‌دهنده برنامه‌های Gemini» را ببینید.
فعال کردن «حالت توسعه‌دهنده برنامه‌های Gemini»
اگر سرور MCP خود را در «کنسول یکپارچه Google» آماده‌سازی می‌کنید، برنامه ثبت‌شده شما ازقبل هنگام فعال کردن «حالت توسعه‌دهنده برنامه‌های Gemini» دردسترس است و می‌توانید از «مرحله ۲» رد شوید. اگر می‌خواهید نقطه پایانی سرور HTTPS MCP مستقرشده را قبل‌از ثبت کردن آن در کنسول مستقیماً در Gemini آزمایش کنید، هر دو مرحله را برای فعال کردن «حالت توسعه‌دهنده برنامه‌های Gemini» و متصل کردن سرور به‌عنوان برنامه MCP سفارشی دنبال کنید.
مرحله ۱: فعال کردن «حالت توسعه‌دهنده برنامه‌های Gemini»
- Gemini را در مرورگر وب باز کنید.
- روی تنظیمات > حالت توسعه‌دهنده برنامه‌های Gemini کلیک کنید (یا مستقیماً به gemini.google.com/devmode بروید).
(اختیاری) مرحله ۲: ایجاد و آزمایش کردن برنامه MCP سفارشی
برای متصل کردن سرور MCP به‌عنوان برنامه سفارشی در «حالت توسعه‌دهنده برنامه‌های Gemini»، کارهای زیر را انجام دهید:
- در کادر گفتگوی انتخاب برنامه، روی + ایجاد مورد جدید کلیک کنید.
- در کادر گفتگوی اتصال به سرور MCP، نقطه پایان HTTPS عمومی سرورتان را در نشانی وب سرور MCP وارد کنید (مطمئن شوید نشانی وب شما با
https://شروع شود، برای مثال،https://your-app-link.com/mcp). - اگر سرورتان به اعتبارنامه OAuth ازپیش ثبت‌شده نیاز دارد، روی تنظیمات بیشتر > نمایش بیشتر کلیک کنید تا شناسه کارخواه و رمز کارخواه OAuth را وارد کنید، سپس روی بعدی کلیک کنید.
- در کادر گفتگوی تأیید امنیت و حریم خصوصی، نحوه تعامل Gemini با سرور MCP سفارشی‌تان را مرور کنید:
- اجرای ابزار: Gemini ابزارهای سرور MCP شما را اجرا می‌کند تا توابع دردسترس را برای رسیدگی به درخواست‌های شما راه‌اندازی و اجرا کند.
- بازیابی و هم‌رسانی داده‌ها: Gemini منابع، طرح‌واره‌ها، و بافت‌هایی را که نقاط پایانی سرور MCP شما افشا کرده‌اند بازیابی و مدیریت می‌کند و ممکن است اطلاعاتی را که به آن‌ها دسترسی دارد براساس تنظیمات «حساب Google» شما یا هنگام تعامل با سایر برنامه‌های متصل‌شده هم‌رسانی کند.
- اعتماد و قطع اتصال: مطمئن شوید که به سرور MCP اعتماد دارید و قبل‌از ادامه دادن، خط‌مشی رازداری آن را مرور کنید. هرزمان بخواهید می‌توانید اتصال سرور را از صفحه «برنامه‌های متصل‌شده» قطع کنید یا پیوند آن را از اتصال‌های «حساب Google» خود حذف کنید.
- خطرات امنیتی و حریم خصوصی مربوط به متصل کردن این برنامه سفارشی را درک می‌کنم و می‌پذیرم را انتخاب کنید. سپس روی متصل کردن کلیک کنید.
- در کادر گفتگوی ذخیره کردن برنامه سفارشی، نام نمایشی برای برنامه سفارشی‌تان وارد کنید، بررسی کنید که ابزارهای سرورتان در فهرست کنش‌های دردسترس نشان داده شود، و روی اتصال کلیک کنید.
- در پانل کناری «حالت توسعه‌دهنده برنامه‌های Gemini»، برگه طرح‌واره‌های ابزار را انتخاب کنید تا اطلاعات مربوط به هر ابزار در برنامه متصل‌شده‌تان را مرور کنید، ازجمله تعاریف پارامتر، نشان‌های ایمنی (فقط خواندنی، مخرب، نیاز به اصالت‌سنجی)، طرح‌واره خام، و ساختار پاسخ.
- در قاب گپ سمت راست، پیام‌واره‌های
@mentionیا زبان طبیعی (برای مثال،@MyApp show my profile) را وارد کنید و برگه گزارش رویداد را پایش کنید تا ببینید ابزارتان چگونه کار می‌کند.
اشکال‌زدایی فراخوانی‌های ابزار
وقتی فراخوانی ابزار ناموفق است یا آرگومان‌های غیرمنتظره‌ای تولید می‌کند، می‌توانید دورسنجی تشخیصی را بررسی کنید، سرور MCP باک‌اند خود را به‌روز کنید، و طرح‌واره را بدون پاک کردن سابقه مکالمه‌تان بارگیری مجدد کنید.
برای اشکال‌زدایی فراخوانی ناموفق ابزار، کارهای زیر را انجام دهید:
- در قاب سمت چپ، برگه گزارش رویداد را انتخاب کنید.
- روی رویداد ناموفق در فهرست دورسنجی کلیک کنید تا جزئیات آن گسترش یابد و
بار داده درخواست
Tool callو پاسخTool resultرا بررسی کنید:- خطاهای اتصال و شبکه: پیام‌های خطا و تأخیر را بررسی کنید تا مطمئن شوید نقطه پایانی‌تان دردسترس است.
- خطاهای اصالت‌سنجی: اگر رویداد
401یا403را برمی‌گرداند، وضعیت کد OAuth یا اطلاعات اعتباری مشتری را در برگه اصالت‌سنجی درستی‌سنجی کنید. - عدم تطابق اعتبارسنجی طرح‌واره: اگر سرور خطای پارامترهای نامعتبر MCP (
-32602) را برگرداند، آرگومان‌های JSON تولیدشده توسط مدل درTool callرا با انواع پارامترها، ویژگی‌های الزامی، و دستورالعمل‌های قالب در برگه طرح‌واره‌های ابزار مقایسه کنید. - استثناهای زمان اجرای سرور: کد خطا و پیام JSON-RPC را در
Tool resultبررسی کنید تا استثناهای پس‌نهایی را تشخیص دهید.
- برای حل کردن این مشکل، پیاده‌سازی سرور MCP خود را به‌روز کنید یا شرح ابزار و پارامتر را اصلاح کنید. برای راهنمایی درباره نوشتن طرح‌واره‌های واضح ابزار و پاسخ‌های خطا، به استانداردهای ادغام برنامه متصل‌شده MCP مراجعه کنید.
- در برگه طرح‌واره‌های ابزار، روی همگام‌سازی طرح‌واره کلیک کنید. Gemini دوباره
tools/listرا از سرور MCP شما واکشی می‌کند و تعاریف ابزار فعال را به‌روز می‌کند درحالی‌که رشته گپ فعلی حفظ می‌شود. - پُرسمانتان را دوباره امتحان کنید. در برگه گزارش رویداد، تأیید کنید که فراخوانی ابزار بازپخش‌شده
200 OKرا برمی‌گرداند و پاسخ موردانتظار را در پیش‌نمایش گپ ارائه می‌دهد.
شبیه‌سازی بافت محیط و اصالت‌سنجی
می‌توانید نحوه پاسخ ابزارهای MCP به مکان‌های کاربر، مناطق زمانی، زبان‌های مختلف، و روش‌های اصالت‌سنجی را مستقیماً در قاب بازرس آزمایش کنید.
ملغی کردن بافت محیط
برای شبیه‌سازی بافتار کاربر برای ابزارهای حساس به تاریخ، زمان، یا زبان، کارهای زیر را انجام دهید:
- در قاب سمت چپ، برگه محیط را انتخاب کنید.
- در بخش تاریخ و زمان، تاریخ شبیه‌سازی‌شده و زمان شبیه‌سازی‌شده را انتخاب کنید تا عبارت‌های زمانی نسبی (مثل «فردا صبح» یا «شنبه بعدازظهر») را آزمایش کنید.
- در بخش اولویت‌ها، زبان را برای شبیه‌سازی منطقه کاربر انتخاب کنید
(برای مثال،
en-US). - یک پیام‌واره آزمایشی در قاب گپ اجرا کنید تا ابزارتان را با بافت شبیه‌سازی‌شده ارزیابی کنید.
- برای بازیابی تنظیمات پیش‌فرض محیط، روی بازنشانی کلیک کنید.
پیکربندی اصالت‌سنجی کارخواه
برای پیکربندی یا تغییر روش اصالت‌سنجی مورداستفاده درطول جلسه «حالت توسعه‌دهنده» در «برنامه‌های Gemini»، کارهای زیر را انجام دهید:
- در قاب سمت چپ، برگه اصالت‌سنجی را انتخاب کنید.
- در بخش پیکربندی اصالت‌سنجی کارخواه، یکی از حالت‌های اصالت‌سنجی زیر را انتخاب کنید:
- Dynamic Client Registration: از جریان OAuth برای مذاکره خودکار اعتبارنامه‌ها با سرور مجوز شما استفاده می‌کند. برای اطلاعات بیشتر، راهنمای پیاده‌سازی OAuth 2.1 را ببینید. درصورت لزوم، نقطه پایانی‌تان را در افزودن پیوند برنامه سفارشی وارد کنید.
- ثبت‌نام دستی کارخواه: به شما امکان می‌دهد «شناسه کارخواه» و «رمز کارخواه» پیش‌ثبت‌شده را به‌صورت دستی ارائه دهید. تنظیمات پیشرفته را ازهم باز کنید تا لغوهای جریان اضافی را پیکربندی کنید.
- روی ذخیره کلیک کنید و منتظر بمانید تا پیام ذخیره شد ظاهر شود. سپس، پیام‌واره آزمایشی اجرا کنید تا مطمئن شوید ابزارهای اصالت‌سنجی‌شده موفق می‌شوند.