یک سرور MCP اضافه کنید

Gemini در عامل اندروید استودیو می‌تواند با استفاده از پروتکل Model Context (MCP) با ابزارهای خارجی تعامل داشته باشد. این ویژگی روشی استاندارد برای حالت عامل فراهم می‌کند تا از ابزارها استفاده کند و دانش و قابلیت‌ها را با محیط خارجی گسترش دهد.

ابزارهای زیادی وجود دارد که می‌توانید در اندروید استودیو به MCP Host متصل شوید. برای مثال، می‌توانید با GitHub MCP Server ادغام شوید تا مستقیماً از اندروید استودیو درخواست‌های pull ایجاد کنید یا با سرور MCP از راه دور Figma ادغام شوید تا اطلاعات طراحی را بدون دانلود برنامه دسکتاپ ارائه دهید. برای ایده‌های بیشتر، به سرورهای نمونه MCP مراجعه کنید.

برای اضافه کردن سرور MCP، مراحل زیر را دنبال کنید:

  1. با کلیک روی File ( اندروید استودیو در macOS) > Settings > Tools > Gemini > MCP Servers به ​​تنظیمات سرور MCP بروید.
  2. فعال کردن سرورهای MCP را انتخاب کنید.
  3. پیکربندی MCP را در فیلد ارائه شده اضافه کنید. این پیکربندی در فایل mcp.json در دایرکتوری پیکربندی اندروید استودیو ذخیره می‌شود.
  4. روی تأیید کلیک کنید.

مثال زیر یک فایل mcp.json را با چندین پیکربندی سرور نشان می‌دهد:

{
  "mcpServers": {
    "figma": {
      "httpUrl": "https://mcp.figma.com/mcp"
    },
    "github": {
      "httpUrl": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "Authorization": "Bearer <YOUR_PERSONAL_ACCESS_TOKEN>"
      }
    },
    "gitlab": {
      "httpUrl": "https://gitlab.com/api/v4/mcp"
    },
    "canva": {
      "httpUrl": "https://mcp.canva.com/mcp"
    },
    "notion": {
      "httpUrl": "https://mcp.notion.com/mcp"
    },
    "linear": {
      "httpUrl": "https://mcp.linear.app/mcp"
    }
  }
}

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

احراز هویت

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

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

از ابزارهای MCP استفاده کنید

برای دیدن ابزارهای موجود در Gemini در اندروید استودیو، در چت عبارت /mcp را تایپ کنید.

سپس می‌توانید در چت به ابزارها ارجاع دهید، مثلاً «فهرست مخازن من در گیت‌هاب».

پیکربندی‌ها

این بخش تمام گزینه‌های پیکربندی سرور MCP را شرح می‌دهد.

سرور HTTP MCP

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

نام نوع توضیحات
httpUrl رشته الزامی. آدرس اینترنتی کامل نقطه پایانی HTTP قابل پخش (برای مثال، https://example.com/mcp یا http://localhost:1234/mcp ).
headers نقشه<رشته، رشته> نقشه‌ای از هدرهای HTTP سفارشی برای درج در درخواست اتصال. مقدار پیش‌فرض {} (یک نقشه خالی) است.
timeout بلند زمان اتصال بر حسب میلی ثانیه. -1 نشان دهنده عدم زمان اتصال است. مقدار پیش‌فرض -1 است.
enabled بولی آیا این پیکربندی سرور فعال است یا خیر. مقدار پیش‌فرض true است.

محدودیت‌ها

ادغام MCP اندروید استودیو از ویژگی‌های زیر پشتیبانی نمی‌کند:

  • اتصال به سرورهای MCP از طریق stdio transport
  • منابع MCP
  • قالب‌های اعلان
  • ورود با OAuth با برخی از سرورهای MCP، مانند GitHub