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

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

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

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

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

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

نمونه سوالات

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

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

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

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

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

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

  2. API توسعه‌دهنده‌ی پرداخت و کیف پول را فعال کنید.

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

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

    فعال کردن API

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

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

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

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

سرور MCP توسعه‌دهنده Google Pay & Wallet از پروتکل 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 بروید.

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

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

    • برای Antigravity ، Claude.ai ، Claude Code ، ChatGPT و Cursor Desktop ، گزینه Web application را انتخاب کنید.
    • برای Antigravity CLI ، Antigravity IDE و 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 ایجاد می‌کند (به بخش پیکربندی برنامه هوش مصنوعی خود در زیر مراجعه کنید).

    دسکتاپ مکان‌نما

    http://localhost:8787/callback

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

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

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

رابط خط فرمان ضد جاذبه

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

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

  2. دستور /mcp را اجرا کنید، سرور MCP جدید خود را انتخاب کنید و برای شروع فرآیند احراز هویت، گزینه Authenticate را انتخاب کنید.

ضد جاذبه

  1. در Antigravity، به تنظیمات سفارشی‌سازی‌ها بروید.
  2. در بخش سرورهای MCP نصب‌شده ، برای ویرایش فایل mcp_config.json ، روی Open MCP Config کلیک کنید: 
    {
  "mcpServers": {
    "google-pay-wallet-dev": {
      "serverUrl": "https://paydeveloper.googleapis.com/mcp",
      "oauth": {
        "clientId": "ANTIGRAVITY_CLIENT_ID",
        "clientSecret": "ANTIGRAVITY_CLIENT_SECRET"
      }
    }
  }
}
  3. به Antigravity برگردید و روی Refresh کلیک کنید.
  4. روی تأیید اعتبار کلیک کنید و مراحل تأیید اعتبار را تکمیل کنید.
  5. کد مجوز را کپی کرده و آن را در پنجره تنظیمات ضد جاذبه ارسال کنید.

محیط برنامه‌نویسی ضد جاذبه

  1. روی در بالای پنل سمت عامل ویرایشگر کلیک کنید و MCP Servers را انتخاب کنید.
  2. روی مدیریت سرورهای MCP کلیک کنید.
  3. روی مشاهده پیکربندی خام کلیک کنید و جزئیات سرور MCP خود را اضافه کنید: 
    {
  "mcpServers": {
    "google-pay-wallet-dev": {
      "serverUrl": "https://paydeveloper.googleapis.com/mcp",
      "oauth": {
        "clientId": "ANTIGRAVITY_IDE_CLIENT_ID",
        "clientSecret": "ANTIGRAVITY_IDE_CLIENT_SECRET"
      }
    }
  }
}
  4. به Antigravity IDE برگردید و روی Refresh کلیک کنید.
  5. سرور MCP جدید خود را انتخاب کنید و روی Authenticate کلیک کنید و مراحل احراز هویت را تکمیل کنید.
  6. کد مجوز را کپی کرده و آن را در پنجره تنظیمات ضد جاذبه ارسال کنید.

کد VS

  1. روی نماد در بالای پنل کناری چت کلیک کنید و به سرورهای MCP بروید.
  2. روی دکمه‌ی «افزودن سرور » ( ) کلیک کنید، HTTP را انتخاب کنید و آدرس اینترنتی (URL) مربوط به سرور MCP توسعه‌دهنده‌ی Pay & Wallet را وارد کنید: https://paydeveloper.googleapis.com/mcp .
    پیکربندی MCP شما در فایل .vscode/mcp.json در فضای کاری شما ذخیره می‌شود: 
    {
  "servers": {
    "google-pay-wallet-dev": {
      "url": "https://paydeveloper.googleapis.com/mcp"
    }
  }
}
  3. روی سرور جدید MCP کلیک راست کرده و Start Server را انتخاب کنید.
  4. به پنجره چت برگردید و ابزاری را در سرور MCP فراخوانی کنید تا فرآیند احراز هویت آغاز شود. برای مثال: «لیست حساب‌های Google Pay من».
  5. همانطور که انتظار می‌رود، پنجره‌ی «ثبت نام پویای کلاینت پشتیبانی نمی‌شود» باز می‌شود. برای بستن این پنجره، روی هر دکمه‌ای کلیک کنید.
  6. شناسه کلاینت OAuth خود را وارد کنید و Enter را بزنید.
  7. وقتی از شما خواسته شد، رمز عبور کلاینت OAuth خود را وارد کنید و Enter را بزنید.
  8. یک پنجره برای تأیید اعتبار باز می‌شود، روی «مجاز» کلیک کنید.
  9. می‌توانید از فهرستی از هویت‌های تأییدشده انتخاب کنید، یا با یک حساب کاربری جدید وارد شوید.
  10. پس از احراز هویت، ابزار فراخوانی می‌شود و جلسه در پنجره چت ادامه می‌یابد.

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 .
      آدرس سرور : https://paydeveloper.googleapis.com/mcp
  4. به تنظیمات پیشرفته بروید و شناسه و رمز کلاینت OAuth خود را وارد کنید.
  5. URL فراخوانی پویا را کپی کنید و آن را به کلاینت OAuth ایجاد شده در مرحله قبل اضافه کنید.

دسکتاپ مکان‌نما

برای پیکربندی مکان‌نما در دسکتاپ:

  1. روی سفارشی‌سازی در پنل سمت چپ کلیک کنید.
  2. روی New MCP Server کلیک کنید. این کار فایل پیکربندی mcp.json را باز می‌کند.
  3. جزئیات پیکربندی را برای افزودن سرور MCP توسعه‌دهنده Google Pay & Wallet وارد کنید: 
    {
  "mcpServers": {
    "google-pay-wallet-dev": {
      "url": "https://paydeveloper.googleapis.com/mcp",
      "auth": {
        "CLIENT_ID": "CURSOR_DESKTOP_CLIENT_ID",
        "CLIENT_SECRET": "CURSOR_DESKTOP_CLIENT_SECRET"
      }
    }
  }
}
  4. پس از ذخیره فایل، لیست سرورهای MCP به‌روزرسانی می‌شود.
  5. برای شروع فرآیند احراز هویت ، روی Authenticate کلیک کنید.

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

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

شرایط خدمات

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