Thêm máy chủ MCP

Tác nhân của Gemini trong Android Studio có thể tương tác với các công cụ bên ngoài bằng Giao thức bối cảnh mô hình (MCP). Tính năng này cung cấp một cách thức chuẩn hoá để Chế độ tác nhân sử dụng các công cụ, mở rộng kiến thức và khả năng với môi trường bên ngoài.

Có nhiều công cụ mà bạn có thể kết nối với MCP Host trong Android Studio. Ví dụ: bạn có thể tích hợp với Máy chủ MCP GitHub để tạo yêu cầu kéo ngay từ Android Studio hoặc tích hợp với máy chủ MCP từ xa Figma để cung cấp thông tin thiết kế mà không cần tải ứng dụng dành cho máy tính xuống. Để biết thêm ý tưởng, hãy xem các máy chủ MCP mẫu.

Để thêm một máy chủ MCP, hãy làm theo các bước sau:

  1. Chuyển đến phần cài đặt máy chủ MCP bằng cách nhấp vào File (Tệp) (Android Studio trên macOS) > Settings > Tools > Gemini > MCP Servers (Cài đặt > Công cụ > Gemini > Máy chủ MCP).
  2. Chọn Enable MCP Servers (Bật máy chủ MCP).
  3. Thêm cấu hình MCP vào trường được cung cấp. Cấu hình được lưu trong tệp mcp.json trong thư mục cấu hình của Android Studio.
  4. Nhấp vào OK.

Ví dụ sau đây cho thấy một tệp mcp.json có nhiều cấu hình máy chủ:

{
  "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"
    }
  }
}

Để biết các giá trị cấu hình chính xác cần liệt kê trong tệp này, hãy xem tài liệu về máy chủ MCP mà bạn đang tích hợp.

Xác thực

Sau khi nhấp vào OK, bạn sẽ thấy thông báo "Đã kết nối thành công với máy chủ MCP..." hoặc một thông báo mô tả lỗi. Hầu hết các Máy chủ MCP từ xa đều yêu cầu xác thực và do đó trả về "Lỗi kết nối với phương tiện truyền tải: Ngoại lệ về việc uỷ quyền" khi uỷ quyền không thành công.

Nhấp vào Start Login (Bắt đầu đăng nhập) để bắt đầu quy trình xác thực cho máy chủ đó. Bạn sẽ được yêu cầu đăng nhập vào trang đăng nhập của máy chủ đó trong trình duyệt. Sau khi đăng nhập, hệ thống sẽ thử kết nối lại và nếu thành công, bạn sẽ thấy thông báo "Đã kết nối thành công với máy chủ MCP...".

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

Để xem những công cụ mà Gemini có thể sử dụng trong Android Studio, hãy nhập /mcp vào cuộc trò chuyện.

Sau đó, bạn có thể tham chiếu các công cụ trong cuộc trò chuyện, ví dụ: "liệt kê các kho lưu trữ của tôi trên GitHub".

Cấu hình

Phần này mô tả tất cả các lựa chọn cấu hình máy chủ MCP.

Máy chủ MCP HTTP

Bảng sau đây liệt kê các lựa chọn cấu hình để kết nối với một máy chủ MCP thông qua một phương thức truyền tải HTTP có thể truyền trực tuyến.

Tên Loại Mô tả
httpUrl Chuỗi Bắt buộc. URL đầy đủ của điểm cuối HTTP có thể truyền phát (ví dụ: https://example.com/mcp hoặc http://localhost:1234/mcp).
headers Map<String, String> Một bản đồ các tiêu đề HTTP tuỳ chỉnh cần đưa vào yêu cầu kết nối. Mặc định là {} (bản đồ trống).
timeout Dài Thời gian chờ kết nối tính bằng mili giây. -1 cho biết không có thời gian chờ. Giá trị mặc định là -1.
enabled Boolean Liệu cấu hình máy chủ này có đang hoạt động hay không. Giá trị mặc định là true.

Các điểm hạn chế

Hoạt động tích hợp MCP của Android Studio không hỗ trợ các tính năng sau:

  • Kết nối với máy chủ MCP thông qua phương thức truyền stdio
  • Tài nguyên MCP
  • Mẫu câu lệnh
  • Đăng nhập bằng OAuth với một số máy chủ MCP, chẳng hạn như GitHub