MCP Reference: chatmcp.googleapis.com

API چت MCP، ویژگی‌های MCP از راه دور را برای گوگل چت فراهم می‌کند.

یک سرور پروتکل زمینه مدل (MCP) به عنوان یک پروکسی بین یک سرویس خارجی عمل می‌کند که زمینه، داده‌ها یا قابلیت‌هایی را برای یک مدل زبان بزرگ (LLM) یا برنامه هوش مصنوعی فراهم می‌کند. سرورهای MCP برنامه‌های هوش مصنوعی را به سیستم‌های خارجی مانند پایگاه‌های داده و سرویس‌های وب متصل می‌کنند و پاسخ‌های آنها را به فرمتی که برنامه هوش مصنوعی می‌تواند درک کند، ترجمه می‌کنند.

راه اندازی سرور

قبل از استفاده، باید سرور Chat MCP را پیکربندی کنید . برای اطلاعات بیشتر در مورد استفاده از سرورهای MCP از راه دور گوگل و گوگل کلود، به نمای کلی سرورهای Google Cloud MCP مراجعه کنید.

نقاط پایانی سرور

یک نقطه پایانی سرویس MCP، آدرس شبکه و رابط ارتباطی (معمولاً یک URL) سرور MCP است که یک برنامه هوش مصنوعی (میزبان برای کلاینت MCP) برای ایجاد یک اتصال امن و استاندارد از آن استفاده می‌کند. این نقطه تماس LLM برای درخواست زمینه، فراخوانی یک ابزار یا دسترسی به یک منبع است. نقاط پایانی Google MCP می‌توانند جهانی یا منطقه‌ای باشند.

سرور MCP مربوط به Chat API دارای نقطه پایانی MCP سراسری زیر است:

  • https://chatmcp.googleapis.com/mcp/v1

ابزارهای MCP

یک ابزار MCP یک تابع یا قابلیت اجرایی است که یک سرور MCP آن را در اختیار یک برنامه LLM یا هوش مصنوعی قرار می‌دهد تا عملی را در دنیای واقعی انجام دهد.

ابزارها

سرور chatmcp.googleapis.com MCP ابزارهای زیر را دارد:

ابزارهای MCP
لیست_پیام‌ها پیام‌ها را از یک مکالمه مشخص‌شده در گوگل چت (فضا، پیام مستقیم (DM) یا پیام گروهی) بازیابی می‌کند. امکان فیلتر کردن بر اساس موضوع، محدوده زمانی و تعداد پیام‌ها را فراهم می‌کند. علاوه بر این، صفحه بعدی پیام‌ها را می‌توان بازیابی کرد تا زمینه بیشتری فراهم شود. پیام‌های خصوصی (پیام‌هایی که فقط برای یک کاربر قابل مشاهده هستند) فیلتر می‌شوند.
جستجو_گفتگوها

مکالمات گوگل چت را بر اساس نام نمایشی جستجو می‌کند.

اگر فقط شرکت‌کنندگان ارائه شده باشند، این ابزار پیام‌های مستقیم ۱:۱ (اگر یک شرکت‌کننده ارائه شده باشد) یا چت‌های گروهی (اگر چندین شرکت‌کننده ارائه شده باشد) را که شامل شرکت‌کنندگان مشخص شده و کاربر تماس‌گیرنده هستند، پیدا می‌کند.

اگر فقط یک پرس‌وجو ارائه شده باشد، این ابزار مکالماتی را جستجو می‌کند که پرس‌وجو در آنها یک زیررشته‌ی غیرحساس به حروف بزرگ و کوچک از نام نمایشی مکالمه باشد.

اگر هم شرکت‌کنندگان و هم پرس‌وجو ارائه شده باشند، این ابزار مکالمات را بر اساس شرکت‌کنندگان پیدا کرده و سپس آنها را بر اساس نام نمایشی فیلتر می‌کند.

اگر نه شرکت‌کننده‌ای ارائه شود و نه پرسشی، این ابزار تمام مکالماتی را که کاربر تماس‌گیرنده عضوی از آن است، فهرست می‌کند.

این ابزار فقط مکالماتی را فهرست می‌کند که کاربر تماس‌گیرنده عضوی از آنها است.

مهم: خالی بودن فهرست «گفتگوها» به این معنی نیست که در کل هیچ نتیجه‌ای وجود ندارد. اگر «next_page_token» وجود داشته باشد، صفحات بیشتری قابل بازیابی هستند. اگر فهرستی خالی اما با «next_page_token» دریافت کردید، از کاربر بپرسید که آیا باید جستجو را ادامه دهد یا خیر.

مشخصات ابزار MCP را دریافت کنید

برای دریافت مشخصات ابزار MCP برای همه ابزارهای موجود در یک سرور MCP، از متد tools/list استفاده کنید. مثال زیر نحوه استفاده از curl برای فهرست کردن همه ابزارها و مشخصات آنها که در حال حاضر در سرور MCP موجود هستند را نشان می‌دهد.

درخواست کرل 
curl --location 'https://chatmcp.googleapis.com/mcp/v1' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'