Kết nối với máy chủ Giao thức ngữ cảnh mô hình (MCP)

Máy chủ MCP cung cấp cho Gemini các công cụ và nguồn dữ liệu bổ sung. Ví dụ: bằng cách thêm máy chủ MCP Firebase, bạn có thể sử dụng ngôn ngữ tự nhiên để khám phá dữ liệu Cloud Firestore trong khi xây dựng hoặc gỡ lỗi ứng dụng.

Điều kiện tiên quyết

Nếu máy chủ MCP yêu cầu, hãy đảm bảo bạn đã cài đặt Node.js và npm.

Chọn máy chủ MCP tương thích

Firebase Studio có hỗ trợ cơ bản cho máy chủ MCP, nhưng không phải máy chủ MCP nào cũng tương thích. Khi chọn máy chủ MCP, hãy lưu ý các thông tin chi tiết về khả năng tương thích sau:

  • Được hỗ trợ:

    • Đầu vào/đầu ra tiêu chuẩn (stdio) hoặc Sự kiện do máy chủ gửi (SSE)/Máy chủ truyền tải HTTP có thể truyền phát
    • Xác thực khoá API bằng tiêu đề HTTP hoặc biến môi trường
    • Các công cụ do máy chủ MCP cung cấp

  • Không được hỗ trợ:

    • Máy chủ yêu cầu giao diện người dùng đồ hoạ hoặc phiên bản dành cho máy tính
    • Lời nhắc, mẫu hoặc các tài nguyên khác do máy chủ MCP cung cấp

Thêm máy chủ MCP

Để thêm máy chủ MCP, bạn cần tạo hoặc chỉnh sửa tệp cấu hình của máy chủ đó.

Bước 1: Tạo tệp cấu hình

Tính năng trò chuyện tương tác kết nối với máy chủ MCP bằng tệp cấu hình:

  • Tính năng trò chuyện tương tác sử dụng .idx/mcp.json.

Tạo tệp bằng cách làm theo hướng dẫn sau.

Tính năng trò chuyện tương tác

Trong Chế độ xem Code, hãy tạo .idx/mcp.json bằng một trong các phương thức sau:

  • Bảng lệnh: Mở Bảng lệnh (Shift+Ctrl+P) rồi sử dụng lệnh Firebase Studio: Add MCP Server.
  • Tính năng trò chuyện tương tác: Nhấp vào Tuỳ chỉnh biểu tượng công cụ Customize Tools (Tuỳ chỉnh công cụ) trong tính năng trò chuyện tương tác rồi chọn Add MCP server (Thêm máy chủ MCP).
  • Trình khám phá: Trong Trình khám phá (Ctrl+Shift+E), hãy nhấp chuột phải vào .idx thư mục rồi chọn Tệp mới. Đặt tên cho tệp là mcp.json.

Bước 2: Chỉnh sửa cấu hình máy chủ

  1. Mở tệp cấu hình máy chủ.

  2. Thêm cấu hình máy chủ vào nội dung của tệp. Ví dụ: để thêm máy chủ MCP Firebase, hãy nhập:

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

    Tệp cấu hình này hướng dẫn Gemini máy chủ MCP nào bạn muốn sử dụng. Ví dụ này cho thấy một máy chủ duy nhất có tên là firebase sẽ sử dụng lệnh npx để cài đặt và chạy firebase-tools@latest.

    Nếu máy chủ MCP yêu cầu xác thực khoá API, bạn có thể định cấu hình theo một trong những cách sau:

    • Đối với các máy chủ MCP HTTP từ xa yêu cầu khoá API trong tiêu đề yêu cầu, hãy sử dụng trường headers. Ví dụ: để định cấu hình máy chủ MCP của GitHub:

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

    • Đối với các máy chủ MCP stdio cục bộ yêu cầu khoá API trong biến môi trường, hãy sử dụng trường env. Ví dụ: để định cấu hình bản dựng cục bộ của máy chủ MCP của GitHub:

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

    • Để tránh mã hoá cứng các bí mật trong mcp.json, bạn có thể tuỳ ý sử dụng cú pháp ${env:VARIABLE_NAME}. Cú pháp này sẽ thay thế các giá trị từ các biến môi trường được xác định trong tệp .env hoặc .env.local trong thư mục gốc của không gian làm việc. Ví dụ:

      {
  "mcpServers": {
    "github": {
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "Authorization": "Bearer ${env:GITHUB_ACCESS_TOKEN}"
      }
    }
  }
}

  3. Trong thiết bị đầu cuối (Shift+Ctrl+C), hãy chạy mọi lệnh cần thiết để hoàn tất quá trình cài đặt. Ví dụ: để sử dụng máy chủ MCP Firebase, hãy nhập lệnh sau để đăng nhập vào tài khoản của bạn:

    firebase login --no-localhost

    Làm theo hướng dẫn trong thiết bị đầu cuối để cho phép phiên. Một số công cụ yêu cầu dự án Firebase được kết nối. Bạn có thể sử dụng máy chủ MCP Firebase để tạo dự án hoặc chạy lệnh sau để khởi chạy dự án Firebase:

    firebase init

    Lệnh này sẽ tạo tệp firebase.json trong thư mục gốc.

Sử dụng các công cụ MCP

Sau khi cài đặt máy chủ MCP mà bạn muốn sử dụng, các công cụ hoặc dữ liệu mà máy chủ đó cung cấp sẽ có trong:

  • Tính năng trò chuyện tương tác khi sử dụng chế độ Tác nhân và chế độ Tác nhân (Tự động chạy)
  • App Prototyping agent

Ví dụ: nếu bạn thêm máy chủ MCP Firebase, bạn có thể yêu cầu Gemini tìm nạp cấu hình SDK cho dự án hiện tại, truy xuất dữ liệu được lưu trữ trong Cloud Firestore và Realtime Database, giúp bạn thiết lập các dịch vụ Firebase, v.v..

Trong tính năng trò chuyện tương tác, hãy nhập / để xem danh sách các lời nhắc MCP hiện có.

Danh sách các câu lệnh MCP hiện có

Kiểm tra hoặc điều chỉnh công cụ

Bạn có thể quản lý những công cụ đang hoạt động trong tính năng trò chuyện tương tác:

  1. Nhấp vào Tuỳ chỉnh biểu tượng công cụ Customize Tools (Tuỳ chỉnh công cụ) trong tính năng trò chuyện tương tác để xem danh sách tất cả các công cụ hiện có từ các máy chủ MCP đã định cấu hình.
  2. Sử dụng hộp đánh dấu để bật hoặc tắt toàn bộ máy chủ hoặc từng công cụ.

Danh sách các công cụ MCP hiện có

Khắc phục sự cố máy chủ MCP

Nếu bạn gặp vấn đề với máy chủ MCP, hãy làm theo các bước sau để chẩn đoán vấn đề.

Kiểm tra nhật ký để tìm lỗi

  1. Mở bảng điều khiển Đầu ra (Shift+Ctrl+U).
  2. Trong trình đơn thả xuống, hãy chọn Gemini.
  3. Kiểm tra các thông báo bắt đầu bằng thẻ [MCPManager]. Các nhật ký này cho biết những máy chủ được định cấu hình, những công cụ được thêm thành công và mọi thông báo lỗi.

Xây dựng lại môi trường

Nếu máy chủ MCP không cài đặt hoặc kết nối được, hãy thử xây dựng lại không gian làm việc:

  1. Mở Bảng lệnh (Shift+Ctrl+P).
  2. Chạy lệnh Firebase Studio: Rebuild Environment (Firebase Studio: Xây dựng lại môi trường).
  3. Sau khi không gian làm việc xây dựng lại, hãy kiểm tra xem máy chủ MCP có kết nối hay không.

Nếu công cụ không được sử dụng

Nếu máy chủ MCP kết nối nhưng Gemini không sử dụng các công cụ của máy chủ đó:

  • Bắt đầu phiên trò chuyện mới: Điều này đảm bảo Gemini chọn cấu hình công cụ mới nhất. Tìm hiểu cách quản lý nhật ký trò chuyện.
  • Nêu cụ thể trong lời nhắc: Nếu Gemini có thể hoàn thành nhiệm vụ mà không cần sử dụng công cụ MCP, thì Gemini có thể thử một phương thức khác. Nếu bạn muốn sử dụng một công cụ cụ thể, hãy thử đặt tên cho công cụ đó. Ví dụ: "Use firebase_get_sdk_config to get the SDK config for the current project." (Sử dụng firebase_get_sdk_config để lấy cấu hình SDK cho dự án hiện tại).
  • Tham gia Chương trình Nhà phát triển của Google: Kiểm tra xem tài khoản của bạn đã đăng ký hay chưa.

Các bước tiếp theo