یک سرور پروتکل زمینه مدل (MCP) به عنوان یک پروکسی بین یک سرویس خارجی عمل میکند که زمینه، دادهها یا قابلیتهایی را برای یک مدل زبان بزرگ (LLM) یا برنامه هوش مصنوعی فراهم میکند. سرورهای MCP برنامههای هوش مصنوعی را به سیستمهای خارجی مانند پایگاههای داده و سرویسهای وب متصل میکنند و پاسخهای آنها را به فرمتی که برنامه هوش مصنوعی میتواند درک کند، ترجمه میکنند.
راه اندازی سرور
قبل از استفاده، باید سرورهای MCP را فعال کرده و احراز هویت را تنظیم کنید . برای اطلاعات بیشتر در مورد استفاده از سرورهای MCP از راه دور گوگل و گوگل کلود، به نمای کلی سرورهای MCP گوگل کلود مراجعه کنید.
نقاط پایانی سرور
یک نقطه پایانی سرویس MCP، آدرس شبکه و رابط ارتباطی (معمولاً یک URL) سرور MCP است که یک برنامه هوش مصنوعی (میزبان برای کلاینت MCP) برای ایجاد یک اتصال امن و استاندارد از آن استفاده میکند. این نقطه تماس LLM برای درخواست زمینه، فراخوانی یک ابزار یا دسترسی به یک منبع است. نقاط پایانی Google MCP میتوانند جهانی یا منطقهای باشند.
سرور MCP توسعهدهنده Google Pay & Wallet دارای نقطه پایانی MCP جهانی زیر است:
- https://paydeveloper.googleapis.com/mcp
ابزارهای MCP
یک ابزار MCP یک تابع یا قابلیت اجرایی است که یک سرور MCP آن را در اختیار یک برنامه LLM یا هوش مصنوعی قرار میدهد تا عملی را در دنیای واقعی انجام دهد.
ابزارها
سرور MCP مربوط به paydeveloper.googleapis.com ابزارهای زیر را دارد:
| ابزارهای MCP | |
|---|---|
search_documentation | مرتبطترین و بهروزترین بخشها را از مستندات رسمی توسعهدهندگان و نمونههای کد Google Pay و Google Wallet جستجو و بازیابی میکند. |
list_merchants | فهرستی از تمام نمایههای تجاری فروشندهی Google Pay مرتبط با حساب احراز هویتشده را بازیابی میکند. |
list_google_pay_integrations | وضعیت فعلی و جزئیات پیکربندی را برای همه ادغامهای Google Pay مرتبط با یک شناسه فروشنده خاص برمیگرداند. این تابع بازخورد فوری در مورد وضعیت ادغام و بررسی اسناد ارائه میدهد. |
create_merchant | یک تاجر جدید با حساب احراز هویت شده ایجاد میکند. شما باید از کاربر بخواهید اطلاعات مورد نیاز برای ایجاد تاجر را ارائه دهد. تا زمانی که تلاش نکردهاید اطلاعات مورد نیاز برای ایجاد تاجر را جمعآوری کنید، این ابزار را فراخوانی نکنید. پس از ایجاد تاجر، باید URL شرایط خدمات کنسول تجاری را به کاربر ارائه دهید و به آنها دستور دهید قبل از انجام هرگونه عملیاتی روی این تاجر، آن را بپذیرند. |
create_google_pay_integration | یک ادغام Google Pay برای یک فروشنده خاص ایجاد میکند. این عملیات مستلزم آن است که کاربر شرایط خدمات کنسول تجاری و شرایط خدمات API Google Pay را پذیرفته باشد. نیازی به بررسی پیشگیرانه این موارد نیست. اگر آنها پذیرفته نشده باشند، فراخوانی ابزار با شکست مواجه میشود و پیام خطا حاوی URL های خاص شرایط خدمات خواهد بود که باید پذیرفته شوند. در این صورت، URL ها را برای پذیرش به کاربر ارائه دهید و به آنها دستور دهید که پس از پذیرش دوباره امتحان کنند. قبل از فراخوانی ابزار، برای تعامل با کاربر، این ترتیب را دنبال کنید: ۱. ابتدا، از کاربر مورد ادغام را بپرسید (در حال حاضر فقط ادغام وب پشتیبانی میشود). - آدرس اینترنتی وبسایت را بپرسید. # - اگر مورد ادغام ادغام برنامه است، نام بسته برنامه اندروید را بپرسید. ۲. سپس، نوع ادغام را از کاربر بپرسید: - به کاربر بگویید اگر از یکی از ارائه دهندگان خدمات پرداخت پشتیبانی شده ما (PSP ها: https://developers.google.com/pay/api#participating-processors ) استفاده میکند، Gateway را انتخاب کند، در غیر این صورت Direct را انتخاب کنید. ۳. برای همه انواع ادغام (مستقیم یا دروازه): - به کاربر بگویید که اسکرینشاتهایی (حداکثر ۱ مگابایت) از جریان خرید خود که با API گوگل پی یکپارچه شده است را آپلود کند. جریان خرید آنها باید قبل از دسترسی کامل به محصول، بررسی و تأیید شود. مثالها: https://developers.google.com/pay/api/web/guides/brand-guidelines#put-it-all-together . - باید از کاربر بخواهید ۵ اسکرینشات پشتیبان ارائه دهد. برای اطمینان از نگاشت صحیح، آنها را یکی یکی درخواست کنید. هنگام درخواست، فقط از توضیحات کاربرپسند enum استفاده کنید. ۴. اگر نوع ادغام مستقیم است: - همچنین باید از کاربر بخواهید سند گواهی PCI را با فرمت PDF ارائه دهد. هنگام درخواست، فقط از توضیحات کاربرپسند enum استفاده کنید. ۵. برای هر فایل ارائه شده، از کاربر بخواهید که مسیر یا نام سند را در صورت وجود در دایرکتوری فعلی ارائه دهد. آن را به DocumentType صحیح نگاشت کنید و فیلد نام را در درخواست روی یک نام توصیفی (مثلاً item_selection.png یا pci_attestation.pdf) تنظیم کنید. تا زمانی که برای جمعآوری اسناد مورد نیاز برای نوع ادغام انتخاب شده تلاش نکردهاید، این ابزار را فراخوانی نکنید. |
list_pass_issuers | فهرست جامعی از تمام صادرکنندگان کارتهای اعتباری ثبتشده در کنسول تجاری گوگل والت مرتبط با کاربر احراز هویتشده را بازیابی میکند. این ابزار اطلاعات ضروری را برای توسعهدهندگانی که کارتهای اعتباری والت مانند کارتهای وفاداری، کارتهای هدیه یا بلیط هواپیما را مدیریت میکنند، فراهم میکند. |
list_pass_classes | فهرست جامعی از تمام کلاسهای مجوز ثبتشده در کنسول تجاری Google Wallet مرتبط با کاربر احراز هویتشده را بازیابی میکند. این ابزار اطلاعات ضروری را برای توسعهدهندگانی که مجوزهای Wallet مانند کارتهای وفاداری، کارتهای هدیه یا پروازها را مدیریت میکنند، فراهم میکند. |
validate_pass_jwt | نمایش JWT از یک گذر، یا بار داده JWT کدگذاری نشده را به عنوان یک رشته JSON برای یک گذر، اعتبارسنجی میکند. |
query_merchant_performance | دادههای عملکرد تجمیعشده سطح بالا و معیارهای پس از ادغام را برای یک نمایه تجاری خاص بازیابی میکند. |
query_merchant_error_metrics | معیارهای خطای دقیق را برای یک پروفایل تجاری خاص بازیابی میکند. این ابزار، تجزیه و تحلیل دقیقی از خطاها ارائه میدهد و به توسعهدهندگان اجازه میدهد تا مشکلات را شناسایی و حل کنند. |
مشخصات ابزار MCP را دریافت کنید
برای دریافت مشخصات ابزار MCP برای همه ابزارهای موجود در یک سرور MCP، از متد tools/list استفاده کنید. مثال زیر نحوه استفاده از curl برای فهرست کردن همه ابزارها و مشخصات آنها که در حال حاضر در سرور MCP موجود هستند را نشان میدهد.
| درخواست کرل |
|---|
curl --location 'https://paydeveloper.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/list", "jsonrpc": "2.0", "id": 1 }' |