به سرورهای پروتکل بافت مدل (MCP) متصل شوید

سرورهای MCP ابزارهای اضافی و منابع داده ای را در اختیار Gemini قرار می دهند. برای مثال، با افزودن سرور Firebase MCP ، می‌توانید از زبان طبیعی برای کاوش داده‌های Cloud Firestore خود در حین ساختن یا اشکال‌زدایی برنامه خود استفاده کنید.

پیش نیازها

در صورت نیاز سرور MCP، مطمئن شوید که Node.js و npm را نصب کرده اید.

یک سرور MCP سازگار انتخاب کنید

Firebase Studio پشتیبانی اساسی از سرورهای MCP دارد، اما همه سرورهای MCP سازگار نیستند. هنگام انتخاب سرور MCP، جزئیات سازگاری زیر را در نظر داشته باشید:

  • پشتیبانی شده:

    • ورودی/خروجی استاندارد (stdio) یا رویدادهای ارسال شده از سرور (SSE)/سرورهای انتقال HTTP قابل پخش
    • احراز هویت کلید API با استفاده از هدرهای HTTP یا متغیرهای محیطی
    • ابزارهای ارائه شده توسط سرورهای MCP

  • پشتیبانی نمی شود:

    • سرورهایی که به یک رابط کاربری گرافیکی یا یک جلسه دسکتاپ نیاز دارند
    • درخواست ها، نمونه گیری یا سایر منابع ارائه شده توسط سرورهای MCP

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

برای افزودن یک سرور MCP، باید فایل پیکربندی آن را ایجاد یا ویرایش کنید.

مرحله 1: فایل پیکربندی را ایجاد کنید

چت تعاملی و Gemini CLI هر دو می توانند به سرورهای MCP متصل شوند، اما از فایل های پیکربندی متفاوتی استفاده می کنند:

  • چت تعاملی از .idx/mcp.json استفاده می کند.
  • Gemini CLI از .gemini/settings.json استفاده می کند.

با استفاده از دستورالعمل های زیر یک یا هر دو فایل را ایجاد کنید.

چت تعاملی

در نمای Code ، .idx/mcp.json را با استفاده از یکی از این روش ها ایجاد کنید:

  • پالت فرمان : پالت فرمان را باز کنید ( Shift+Ctrl+P ) و از دستور Firebase Studio: Add MCP Server استفاده کنید.
  • چت تعاملی : کلیک کنید سفارشی کردن نماد ابزار ابزارها را در چت تعاملی سفارشی کنید و افزودن سرور MCP را انتخاب کنید.
  • Explorer : از Explorer (Ctrl+Shift+E) ، روی فهرست .idx کلیک راست کرده و New file را انتخاب کنید. نام فایل را mcp.json .

Gemini CLI

در نمای Code ، .gemini/settings.json را ایجاد کنید:

  1. در Explorer (Ctrl+Shift+E) ، بررسی کنید که فهرست .gemini . وجود دارد یا خیر. اگر نه، روی پنجره Explorer راست کلیک کرده و پوشه جدید را انتخاب کنید. نام پوشه را .gemini بگذارید.
  2. روی پوشه .gemini کلیک راست کرده و New file را انتخاب کنید. نام فایل را settings.json بگذارید.

برای جزئیات در مورد استفاده از سرورهای MCP با Gemini CLI، مستندات کامل را مرور کنید .

مرحله 2: پیکربندی سرور را ویرایش کنید

  1. فایل پیکربندی سرور را باز کنید.

  2. پیکربندی سرور را به محتوای فایل اضافه کنید. به عنوان مثال، برای افزودن سرور Firebase MCP، وارد کنید:

    {
  "mcpServers": {
   "firebase": {
     "command": "npx",
     "args": [
       "-y",
       "firebase-tools@latest",
       "experimental:mcp"
      ]
    }
  }
}

    این فایل پیکربندی به Gemini دستور می دهد که از کدام سرور MCP استفاده کند. این مثال یک سرور واحد به نام firebase را نشان می دهد که از دستور npx برای نصب و اجرای firebase-tools@latest استفاده می کند.

    اگر سرور MCP شما به احراز هویت کلید API نیاز دارد، می توانید آن را به یکی از روش های زیر پیکربندی کنید:

    • برای سرورهای راه دور HTTP MCP که به یک کلید API در سرصفحه‌های درخواست نیاز دارند، از قسمت headers استفاده کنید. به عنوان مثال، برای پیکربندی سرور MCP GitHub:

      {
  "mcpServers": {
    "github": {
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "Authorization": "Bearer <ACCESS_TOKEN>"
      }
    }
  }
}

    • برای سرورهای محلی stdio MCP که به یک کلید API در متغیرهای محیطی نیاز دارند، از فیلد env استفاده کنید. به عنوان مثال، برای پیکربندی یک ساخت محلی از سرور MCP GitHub:

      {
  "mcpServers": {
    "github": {
      "command": "/path/to/github-mcp-server",
      "args": ["stdio"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<ACCESS_TOKEN>"
      }
    }
  }
}

  3. در ترمینال ( Shift+Ctrl+C )، دستورات لازم را برای تکمیل نصب اجرا کنید. به عنوان مثال، برای استفاده از سرور Firebase MCP، دستور زیر را وارد کنید تا وارد حساب کاربری خود شوید:

    firebase login --no-localhost

    دستورالعمل های موجود در ترمینال را برای مجوز دادن به جلسه دنبال کنید. برخی از ابزارها به پروژه Firebase متصل نیاز دارند. می توانید از سرور Firebase MCP برای ایجاد یک پروژه استفاده کنید، یا می توانید دستور زیر را برای مقداردهی اولیه پروژه Firebase اجرا کنید:

    firebase init

    این یک فایل firebase.json در دایرکتوری ریشه شما ایجاد می کند.

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

پس از نصب سرور MCP که می‌خواهید استفاده کنید، ابزارها یا داده‌هایی که ارائه می‌کند در دسترس هستند:

  • Gemini CLI
  • چت تعاملی هنگام استفاده از حالت عامل و حالت عامل (اجرای خودکار).
  • App Prototyping agent

برای مثال، اگر سرور Firebase MCP را اضافه کنید، می‌توانید از Gemini بخواهید که پیکربندی SDK را برای پروژه فعلی واکشی کند، داده‌های ذخیره شده در Cloud Firestore و Realtime Database بازیابی کند، به شما در راه‌اندازی خدمات Firebase کمک کند، و موارد دیگر .

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

فهرست درخواست‌های MCP موجود

ابزارها را بررسی یا تنظیم کنید

می‌توانید مدیریت کنید که کدام ابزارها در چت تعاملی فعال هستند:

  1. کلیک کنید سفارشی کردن نماد ابزار ابزارها را در چت تعاملی سفارشی کنید تا لیستی از تمام ابزارهای موجود از سرورهای MCP پیکربندی شده خود را مشاهده کنید.
  2. از کادرهای انتخاب برای فعال یا غیرفعال کردن کل سرور یا ابزارهای فردی استفاده کنید.

فهرست ابزارهای MCP موجود

عیب یابی سرورهای MCP

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

گزارش ها را برای وجود خطا بررسی کنید

  1. پنل خروجی ( Shift+Ctrl+U ) را باز کنید.
  2. در منوی کشویی، Gemini را انتخاب کنید.
  3. پیام هایی را که با یک برچسب [MCPManager] شروع می شوند بررسی کنید. این گزارش‌ها نشان می‌دهند که کدام سرورها پیکربندی شده‌اند، کدام ابزارها با موفقیت اضافه شده‌اند و هر پیام خطایی.

محیط زیست را بازسازی کنید

اگر سرور MCP نصب یا متصل نشد، سعی کنید فضای کاری خود را دوباره بسازید:

  1. پالت فرمان ( Shift+Ctrl+P ) را باز کنید.
  2. دستور Firebase Studio: Rebuild Environment را اجرا کنید.
  3. پس از بازسازی فضای کاری، بررسی کنید که آیا سرور MCP متصل است یا خیر.

اگر از ابزار استفاده نمی شود

اگر سرور MCP متصل شود اما Gemini از ابزارهای خود استفاده نمی کند:

  • شروع یک جلسه گپ جدید : این اطمینان را ایجاد می کند که Gemini آخرین پیکربندی ابزار را انتخاب می کند. نحوه مدیریت تاریخچه چت را بیاموزید .
  • در درخواست خود دقیق باشید : اگر Gemini بتواند کار را بدون استفاده از ابزار MCP انجام دهد، ممکن است روش دیگری را امتحان کند. اگر می خواهید از ابزار خاصی استفاده کنید، نام ابزار را امتحان کنید. به عنوان مثال: "از firebase_get_sdk_config برای دریافت پیکربندی SDK برای پروژه فعلی استفاده کنید."
  • به برنامه توسعه‌دهنده Google بپیوندید : بررسی کنید که آیا حساب شما ثبت شده است یا خیر .

مراحل بعدی