به سرور MCP توسعه‌دهندگان «کیف پول» و Google Pay متصل شوید

سرور MCP توسعه‌دهنده Google Pay و «کیف پول» به ابزارهای توسعه مجهز به هوش مصنوعی امکان می‌دهد به داده‌های توسعه‌دهنده Google Pay و «کیف پول Google» شما دسترسی داشته باشند، در اسناد رسمی جستجو کنند، و ادغام‌های شما را مدیریت کنند.

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

سرور MCP توسعه‌دهنده «کیف پول» و Google Pay به شما امکان می‌دهد:

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

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

پیام‌واره‌های نمونه

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

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

قبل‌از شروع

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

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

    رفتن به انتخابگر پروژه

  2. اگر «میانای برنامه‌سازی کاربردی توسعه‌دهندگان Pay و کیف پول» ازقبل فعال نیست، آن را فعال کنید.

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

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

    فعال کردن میانای برنامه‌سازی کاربردی

اصالت‌سنجی و صدور مجوز

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

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

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

گستره‌های OAuth سرور MCP توسعه‌دهنده Google Pay و «کیف پول»

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

سرور MCP «توسعه‌دهنده Google Pay و کیف پول» دارای دامنه‌های OAuth ابزار MCP زیر است:

URI دامنه برای gcloud CLI شرح
https://www.googleapis.com/auth/paydeveloper.merchant داده‌های فروشنده Google Pay را مدیریت کنید.
https://www.googleapis.com/auth/paydeveloper.issuer.readonly داده‌های صادرکننده «کیف پول Google» را بخواند.

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

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

  1. در «کنسول Google API»، به پلاتفرم Google Auth > کارخواه‌ها > ایجاد کارخواه بروید.

    رفتن به «ایجاد کارخواه»

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

    • برای Cursor Desktop،‏ Claude Code،‏ Claude.ai،‏ ChatGPT، و Antigravity،‏ کاربرد وب را انتخاب کنید.
    • برای Antigravity CLI،‏ Antigravity IDE، و VS Code، برنامه رایانه‌ای را انتخاب کنید.

  3. در فیلد نام، نامی برای برنامه‌تان وارد کنید.

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

    مکان‌نمای میز کار

    http://localhost:8787/callback

    کد Claude

    http://localhost:CLAUDE_REDIRECT_PORT/callback

    Claude.ai

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

    ChatGPT

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

    Antigravity

    https://antigravity.google/oauth-callback

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

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

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

VS Code

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

Cursor Desktop

برای پیکربندی «میز کار مکان‌نما»:

  1. روی سفارشی‌سازی در پانل کناری سمت راست کلیک کنید.
  2. روی سرور MCP جدید کلیک کنید. با این کار، فایل پیکربندی mcp.json باز می‌شود.
  3. جزئیات پیکربندی را برای افزودن سرور MCP «توسعه‌دهنده Google Pay و کیف پول» وارد کنید: 
    {
  "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. برای شروع فرایند اصالت‌سنجی، روی اصالت‌سنجی کلیک کنید.

کد Claude

برای پیکربندی 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

Claude.ai

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

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

ChatGPT

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

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

Antigravity CLI

  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 جدیدتان را انتخاب کنید، و برای شروع فرایند اصالت‌سنجی، اصالت‌سنجی را انتخاب کنید.

Antigravity IDE

  1. روی در بالای پانل کناری عامل ویرایشگر کلیک کنید و سرورهای MCP را انتخاب کنید.
  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 برگردید و روی بازآوری کلیک کنید.
  5. سرور MCP جدیدتان را انتخاب کنید و روی اصالت‌سنجی کلیک کنید و مراحل اصالت‌سنجی را تکمیل کنید.
  6. کد مجوز را کپی کنید و آن را در پنجره تنظیمات Antigravity ارسال کنید.

Antigravity

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

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

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

شروط خدمات

استفاده از Google Pay API مشمول شرایط خدمات Google Pay است. استفاده از «میانای برنامه‌سازی کاربردی کیف پول Google» تابع شرایط خدمات «میانای برنامه‌سازی کاربردی کیف پول Google» است.