به سرور MCP توسعه‌دهنده Google Pay & Wallet متصل شوید

پیش‌نمایش

این محصول مشمول «شرایط ارائه‌های پیش از GA» در بخش شرایط خدمات عمومی از شرایط خاص خدمات است. محصولات پیش از GA «به همین صورت» موجود هستند و ممکن است پشتیبانی محدودی داشته باشند. برای اطلاعات بیشتر، به توضیحات مرحله راه‌اندازی مراجعه کنید.

سرور MCP توسعه‌دهنده Google Pay & Wallet به ابزارهای توسعه مبتنی بر هوش مصنوعی این امکان را می‌دهد که به داده‌های توسعه‌دهنده Google Pay و Google Wallet شما دسترسی داشته باشند، اسناد رسمی را جستجو کنند و ادغام‌های شما را مدیریت کنند.

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

سرور MCP توسعه‌دهنده Google Pay & Wallet به شما امکان می‌دهد:

• جستجوی مستندات : راهنمایی‌ها و نمونه‌های کد به‌روز را از مستندات رسمی Google Pay و Google Wallet دریافت کنید.
• مدیریت ادغام‌ها : وضعیت ادغام‌های خود را بررسی کنید و APIها را برای حساب تجاری خود فعال کنید.
• نظارت بر عملکرد : به داده‌های عملکرد کلی و معیارهای خطا برای حساب تجاری خود دسترسی پیدا کنید.

• مدیریت مجوزها : صادرکنندگان مجوز و کلاس‌های آن را برای Google Wallet فهرست کنید.

  توجه: برای مشاهده جزئیات ابزارهای MCP موجود و توضیحات آنها، به مرجع توسعه‌دهنده Pay & Wallet مراجعه کنید.

نمونه سوالات

می‌توانید از دستورات زیر با دستیار هوش مصنوعی خود استفاده کنید:

• «حساب‌های Google Pay من را فهرست کن.»
• «وضعیت ادغام‌های گوگل پی من چگونه است؟»
• «چطور می‌توانم Google Pay را با React ادغام کنم؟»
• «معیارهای خطای گوگل پی را برای ادغام من در 30 روز گذشته به من نشان بده.»
• «کلاس‌های پذیرش گوگل والت من را فهرست کنید.»

قبل از اینکه شروع کنی

برای استفاده از سرور MCP توسعه‌دهنده Google Pay & Wallet، باید یک پروژه Google Cloud ایجاد کنید و سرور MCP توسعه‌دهنده Google Pay & Wallet و APIهای Google Wallet را فعال کنید.

1. در کنسول ابری خود، در صفحه انتخاب پروژه، یک پروژه گوگل کلود را انتخاب یا ایجاد کنید.

   به انتخابگر پروژه بروید

2. رابط‌های برنامه‌نویسی کاربردی (API) کیف پول گوگل و توسعه‌دهنده‌ی پرداخت و کیف پول را فعال کنید.

   نقش‌های مورد نیاز برای فعال‌سازی APIها

   برای فعال کردن APIها، به نقش IAM مدیر استفاده از سرویس ( roles/serviceusage.serviceUsageAdmin ) نیاز دارید که شامل مجوز serviceusage.services.enable است. نحوه اعطای نقش‌ها را بیاموزید .

   فعال کردن APIها

نقش‌های مورد نیاز

برای دریافت مجوزهایی که برای استفاده از سرور MCP از راه دور Google Pay & Wallet Developer MCP نیاز دارید، از مدیر خود بخواهید که نقش‌های مدیریت هویت و دسترسی (IAM) زیر را در پروژه Google Cloud که می‌خواهید سرور MCP از راه دور Google Pay & Wallet Developer MCP را در آن فعال کنید، به شما اعطا کند:

• فراخوانی‌های ابزار MCP را انجام دهید: کاربر ابزار MCP ( roles/mcp.toolUser )

برای اطلاعات بیشتر در مورد اعطای نقش‌ها، به مدیریت دسترسی به پروژه‌ها، پوشه‌ها و سازمان‌ها مراجعه کنید.

احراز هویت و مجوز

سرور MCP توسعه‌دهنده Google Pay & Wallet سرورهای MCP از پروتکل OAuth 2.0 به همراه مدیریت هویت و دسترسی (IAM) برای احراز هویت و مجوز استفاده می‌کنند. همه هویت‌ها برای احراز هویت در سرورهای MCP پشتیبانی می‌شوند.

سرور MCP توسعه‌دهنده Google Pay & Wallet کلیدهای API را نمی‌پذیرد.

توصیه می‌کنیم برای عامل‌هایی که از ابزارهای MCP استفاده می‌کنند، یک هویت جداگانه ایجاد کنید تا دسترسی به منابع قابل کنترل و نظارت باشد. برای اطلاعات بیشتر در مورد احراز هویت، به بخش احراز هویت در سرورهای MCP مراجعه کنید.

دامنه‌های OAuth سرور MCP توسعه‌دهنده Google Pay و Wallet

OAuth 2.0 از حوزه‌ها و اعتبارنامه‌ها برای تعیین اینکه آیا یک مدیر اصلی احراز هویت شده مجاز به انجام یک اقدام خاص روی یک منبع است یا خیر، استفاده می‌کند. برای اطلاعات بیشتر در مورد حوزه‌های OAuth 2.0 در گوگل، بخش «استفاده از OAuth 2.0 برای دسترسی به APIهای گوگل» را مطالعه کنید.

سرور MCP توسعه‌دهنده‌ی Google Pay & Wallet دارای دامنه‌های OAuth ابزار MCP زیر است:

آدرس URL مربوط به رابط خط فرمان gcloud	توضیحات
https://www.googleapis.com/auth/paydeveloper.merchant	مدیریت داده‌های پذیرنده در گوگل پی
https://www.googleapis.com/auth/paydeveloper.issuer.readonly	اطلاعات صادرکننده کیف پول گوگل را بخوانید.

یک شناسه و رمز کلاینت OAuth 2.0 ایجاد کنید

برای ایجاد شناسه و رمز کلاینت OAuth 2.0، مراحل زیر را دنبال کنید:

1. در کنسول API گوگل، به Google Auth Platform > Clients > Create client بروید.

   به ایجاد مشتری بروید

   اگر هنوز یک برنامه‌ی جدید در پلتفرم احراز هویت گوگل (Google Auth Platform) ایجاد نکرده‌اید، باید آن را ایجاد کنید. در صفحه‌ی مرور کلی، روی دکمه‌ی «شروع به کار» کلیک کنید و اطلاعات لازم را پر کنید.

2. در لیست نوع برنامه ، نوع مناسب برای برنامه هوش مصنوعی خود را انتخاب کنید:

   • برای Antigravity ، Claude.ai ، Claude Code و ChatGPT ، گزینه Web application را انتخاب کنید.
   • برای Gemini CLI و VS Code ، گزینه Desktop app را انتخاب کنید.

3. در قسمت نام ، یک نام برای برنامه خود وارد کنید.

4. اگر برنامه وب را انتخاب کرده‌اید، در بخش Authorized redirect URIs ، روی + Add URI کلیک کنید و سپس ریدایرکت URI مورد نیاز برای برنامه هوش مصنوعی خود را اضافه کنید:

   ضد جاذبه

   https://antigravity.google/oauth-callback

   Claude.ai

   https://claude.ai/api/mcp/auth_callback

   کلود کد

   http://localhost:CLAUDE_REDIRECT_PORT/callback

   چت جی پی تی

   فعلاً می‌توانید redirect_uri خالی بگذارید. ChatGPT هنگام ایجاد برنامه، یک redirect_uri ایجاد می‌کند (به بخش پیکربندی برنامه هوش مصنوعی خود در زیر مراجعه کنید).

   توجه: در بخش Authorized JavaScript origins ، روی + Add URI کلیک کنید و سپس https://chatgpt.com در فیلد URIs اضافه کنید.

5. روی ایجاد کلیک کنید. پس از ایجاد، رمز کلاینت یک بار نمایش داده می‌شود. آن را کپی کرده و در جای امنی ذخیره کنید.

اپلیکیشن هوش مصنوعی خود را پیکربندی کنید

در مرحله بعد، باید جزئیات پیکربندی سرور را به برنامه هوش مصنوعی خود ارائه دهید.

رابط خط فرمان جمینی

1. برای پیکربندی Gemini CLI ، موارد زیر را به فایل `~/.gemini/settings.json` خود اضافه کنید:

   {
     "mcpServers": {
       "google-pay-wallet-dev": {
         "httpUrl": "https://paydeveloper.googleapis.com/mcp",
         "authProviderType": "dynamic_discovery",
         "oauth": {
           "enabled": true,
           "clientId": "GEMINI_CLI_CLIENT_ID",
           "clientSecret": "GEMINI_CLI_CLIENT_SECRET",
           "scopes": [
             "https://www.googleapis.com/auth/paydeveloper.merchant",
             "https://www.googleapis.com/auth/paydeveloper.issuer.readonly"
           ]
         }
       }
     }
   }

2. برای شروع فرآیند احراز هویت برای سرور MCP توسعه‌دهنده‌ی Google Pay & Wallet، دستور /mcp auth google-pay-wallet-dev را اجرا کنید.

ضد جاذبه

برای پیکربندی Antigravity جهت استفاده از سرور MCP:

1. در Antigravity، روی منوی Additional options در پنل Agent > MCP Servers > Manage MCP Servers کلیک کنید.
2. در بالای پنل مدیریت سرورهای MCP، روی View raw config کلیک کنید تا فایل mcp_config.json ویرایش شود:

   {
     "mcpServers": {
       "google-pay-wallet-dev": {
         "serverUrl": "https://paydeveloper.googleapis.com/mcp",
         "oauth": {
           "clientId": "ANTIGRAVITY_CLIENT_ID",
           "clientSecret": "ANTIGRAVITY_CLIENT_SECRET"
         }
       }
     }
   }

3. به مدیریت سرورهای MCP برگردید و روی Refresh کلیک کنید. با کلیک بر روی Authenticate، برگه Customizations در تنظیمات Agent باز می‌شود.
4. روی تأیید اعتبار کلیک کنید و جریان OAuth را تکمیل کنید.
5. کد مجوز را کپی کنید و کد را در پنجره تنظیمات نماینده ارسال کنید.

کد VS

1. برای پیکربندی VS Code (Copilot)، فایل .vscode/mcp.json را در فضای کاری خود ویرایش کنید:

   {
     "servers": {
       "google-pay-wallet-dev": {
         "url": "https://paydeveloper.googleapis.com/mcp"
       }
     }
   }

2. برای شروع فرآیند احراز هویت، ابزاری را در سرور MCP فراخوانی کنید. برای مثال: «لیست حساب‌های Google Pay من».
3. همانطور که انتظار می‌رود، پنجره‌ی «ثبت نام پویای کلاینت پشتیبانی نمی‌شود» باز می‌شود. برای بستن این پنجره، روی هر دکمه‌ای کلیک کنید.
4. شناسه کلاینت OAuth خود را وارد کنید و Enter را بزنید.
5. وقتی از شما خواسته شد، رمز عبور کلاینت OAuth خود را وارد کنید و Enter را بزنید.
6. یک پنجره برای تأیید اعتبار باز می‌شود، روی «مجاز» کلیک کنید.
7. پس از تأیید، ابزار فراخوانی می‌شود و جلسه در پنجره چت ادامه می‌یابد.

Claude.ai

برای پیکربندی Claude.ai:

1. به سفارشی‌سازی > کانکتورها بروید.
2. روی دکمه‌ی کلیک کنید و گزینه‌ی افزودن کانکتور سفارشی را انتخاب کنید.
3. جزئیات زیر را وارد کنید:
   نام سرور : Google Pay & Wallet MCP .
   آدرس اینترنتی سرور MCP از راه دور : https://paydeveloper.googleapis.com/mcp
4. در تنظیمات پیشرفته، شناسه کلاینت OAuth و رمز کلاینت OAuth خود را وارد کنید.
5. کانکتور جدید را انتخاب کنید و روی «اتصال» کلیک کنید.

کلود کد

برای پیکربندی Claude Code، دستور زیر را اجرا کنید:

MCP_CLIENT_SECRET=CLAUDE_CODE_CLIENT_SECRET claude mcp add --transport http \
  --client-id CLAUDE_CODE_CLIENT_ID --client-secret --callback-port CLAUDE_REDIRECT_PORT \
  google-pay-wallet-dev https://paydeveloper.googleapis.com/mcp

چت جی پی تی

برای پیکربندی ChatGPT:

1. حالت توسعه‌دهنده را از تنظیمات > برنامه‌ها > تنظیمات پیشرفته فعال کنید.
2. روی دکمه ایجاد برنامه کلیک کنید.
3. جزئیات زیر را وارد کنید:
   نام : Google Pay & Wallet MCP .
   آدرس سرور MCP : https://paydeveloper.googleapis.com/mcp
4. به تنظیمات پیشرفته بروید و شناسه و رمز کلاینت OAuth خود را وارد کنید.
5. URL فراخوانی پویا را کپی کنید و آن را به کلاینت OAuth ایجاد شده در مرحله قبل اضافه کنید.

محدودیت‌های شناخته‌شده

• نتایج فقط انگلیسی : جستجوی اسناد فقط از انگلیسی پشتیبانی می‌کند.
• محتوای پشت ACL : مستندات پشت ACLها ایندکس نشده است.
• وابسته به شبکه : سرور نیاز به اتصال زنده به سرویس‌های Google Pay و Wallet دارد.

شرایط خدمات

استفاده از API گوگل پی تابع شرایط خدمات API گوگل پی است. استفاده از API گوگل والت تابع شرایط خدمات API گوگل والت است.