Tích hợp các dịch vụ của Firebase bằng tính năng hỗ trợ AI

Đơn giản hoá quy trình thiết lập Firebase cho ứng dụng web bằng cách sử dụng các công cụ phát triển dựa trên AI như Antigravity, Claude Code, Codex và Cursor. Bằng cách sử dụng kỹ năng của tác nhân Firebase cùng với Firebase CLI và máy chủ MCP của Firebase, bạn có thể biến tác nhân lập trình AI thành một chuyên gia Firebase chuyên biệt có thể viết mã, định cấu hình Firebase Security Rules và quản lý tài nguyên đang hoạt động.

Hướng dẫn này trình bày cách sử dụng tác nhân lập trình AI để giúp thiết lập Cloud Firestore, Firebase Authentication và Firebase Hosting cho một ứng dụng web. Hãy sớm quay lại để biết thông tin về các ứng dụng iOS, Android và Flutter!

Tại sao nên sử dụng các kỹ năng và công cụ của tác nhân Firebase?

Các tác nhân lập trình AI thường gặp khó khăn với các cấu hình dự án cụ thể hoặc thông tin lỗi thời. Bộ công cụ này thu hẹp khoảng cách đó bằng cách kết hợp các hướng dẫn chuyên biệt (kỹ năng của tác nhân) với hai loại công cụ thực thi tác nhân bổ sung (CLI và máy chủ MCP):

  • Kỹ năng của tác nhân Firebase: Cung cấp cho tác nhân viết mã kiến thức chuyên môn và quy trình làm việc theo miền. Là lớp hướng dẫn, các kỹ năng sẽ hướng dẫn tác nhân về các phương pháp hay nhất để làm việc với Firebase, bao gồm cả việc viết mã. Kỹ năng cũng hướng dẫn tác nhân thời điểm và cách sử dụng CLI Firebase và máy chủ MCP của Firebase.
  • Công cụ thực thi tác nhân:
    • Firebase CLI (công cụ dòng lệnh): Cung cấp các công cụ cho vòng đời dự án và các tác vụ môi trường. Tác nhân có thể chạy các lệnh CLI trong môi trường thiết bị đầu cuối để thiết lập các dịch vụ trong một dự án Firebase, triển khai toàn bộ trang web hoặc tài nguyên phụ trợ, khởi động trình mô phỏng cục bộ, v.v.
    • Máy chủ MCP của Firebase (các công cụ và tài nguyên có lập trình): Cung cấp các công cụ để kiểm tra theo thời gian thực và thực hiện các thao tác dữ liệu. Thông qua các lệnh gọi công cụ có cấu trúc, tác nhân có thể truy vấn và cập nhật tài liệu Cloud Firestore, quản lý người dùng Firebase Authentication, xác thực Security Rules, lấy nhật ký hoặc tài liệu trực tiếp vào ngữ cảnh, v.v. theo phương thức lập trình.

Việc sử dụng các kỹ năng của tác nhân Firebase cùng với Firebase CLI và máy chủ Firebase MCP giúp tác nhân lập trình AI của bạn có thêm các khả năng:

  • Hành động: Không chỉ viết mã. Tác nhân của bạn có thể khởi chạy các dịch vụ, quản lý người dùng Firebase Authentication, triển khai Firebase Security Rules mới và làm việc trực tiếp với dữ liệu Cloud Firestore của bạn.
  • Luôn cập nhật: Sử dụng câu lệnh chính thức, có nhận biết phiên bản để hướng dẫn tác nhân của bạn thực hiện các nhiệm vụ thiết lập.
  • Cải thiện độ chính xác: Truy cập vào môi trường và giản đồ của dự án để cung cấp thông tin trợ giúp phù hợp và chính xác hơn.
  • Giảm chi phí cho token: Kỹ năng của tác nhân chỉ tải tài liệu chi tiết khi một nhiệm vụ cụ thể yêu cầu, giúp giảm thiểu mức hao tổn của phiên.

Các dịch vụ Firebase có thể áp dụng

Hướng dẫn này chủ yếu tập trung vào cách các kỹ năng của tác nhân, CLI Firebase và máy chủ MCP của Firebase phối hợp với nhau để giúp bạn nhanh chóng thiết lập các dịch vụ và tính năng sau:

  • Cloud Firestore: Cung cấp cơ sở dữ liệu NoSQL.
  • Firebase Authentication: Thiết lập quy trình đăng nhập an toàn cho người dùng.
  • Firebase Security Rules: Tạo và tinh chỉnh Security Rules cho ứng dụng của bạn.
  • Firebase Hosting: Thiết lập dự án để triển khai ứng dụng web tĩnh.

Để xem danh sách đầy đủ các kỹ năng hiện có, hãy duyệt xem danh sách đầy đủ các kỹ năng của tác nhân Firebase.

Quy trình công việc chung

Các bước sau đây mô tả quy trình làm việc chung về cách sử dụng các kỹ năng của tác nhân Firebase để thiết lập và sử dụng các dịch vụ Firebase trong một ứng dụng web. Ở chế độ nền, các kỹ năng của tác nhân đang sử dụng CLI Firebase và máy chủ MCP Firebase để hoàn tất các tác vụ này.

Bước 1: Cài đặt kỹ năng của tác nhân Firebase

Trong hầu hết các trường hợp, bạn có thể cài đặt kỹ năng của tác nhân Firebase trong trình chỉnh sửa mà bạn muốn chỉ bằng một câu lệnh:

Antigravity

  • Cách 1: Quyền truy cập ở cấp độ chung

    Các kỹ năng của tác nhân Firebase có trong trình bổ trợ Firebase trong Antigravity Marketplace (và dưới dạng một gói tích hợp Build with Google). Cài đặt trình bổ trợ bằng một trong các cách sau:

    • Trong Antigravity Marketplace: Nhấp vào Customizations (Tuỳ chỉnh), chọn thẻ Marketplace rồi nhấp vào + trên thẻ trình bổ trợ Firebase.
    • Trong Antigravity CLI: Run /plugin install firebase@agent-marketplace (Chạy) (hoặc chạy /plugin và cài đặt Firebase từ thẻ Discover (Khám phá)). Các trình bổ trợ được cài đặt trong Antigravity cũng tự động đồng bộ hoá với Antigravity CLI.
    • Trong quá trình thiết lập: Chọn hộp đánh dấu cho ngăn xếp Firebase.
  • Cách 2: Quyền truy cập ở cấp dự án

    Chạy lệnh sau trong thư mục của dự án:

    npx skills add firebase/agent-skills --agent=antigravity
    

Claude Code

Chạy các lệnh sau trong thiết bị đầu cuối:

claude plugin marketplace add firebase/agent-skills
claude plugin install firebase@firebase

Codex

  • Lựa chọn 1: Thiết bị đầu cuối Codex

    Chạy các lệnh sau trong dòng lệnh:

    codex plugin marketplace add firebase/agent-skills
    codex plugin add firebase@firebase
    
  • Cách 2: Ứng dụng Codex

    1. Hoàn thành các nhiệm vụ sau đây một lần:

      1. Đăng ký thông qua thiết bị đầu cuối:

        codex plugin marketplace add firebase/agent-skills
        
      2. Khởi động lại hoàn toàn ứng dụng Codex.

      3. Mở Plugins (Trình bổ trợ).

      4. Chọn thị trường/nguồn Firebase.

      5. Mở Firebase rồi nhấp vào + Cài đặt.

    2. Bắt đầu một việc cần làm mới.

    3. Nhập @Firebase để chọn trình bổ trợ hoặc yêu cầu Codex thực hiện một tác vụ Firebase.

Cursor

  • Cách 1: Cài đặt trình bổ trợ ngay từ Cursor Marketplace.

  • Cách 2: Chạy lệnh sau trong dòng lệnh:

    npx skills add firebase/agent-skills --agent=cursor
    

Tác nhân khác

Chạy lệnh sau trong thiết bị đầu cuối:

npx skills add firebase/agent-skills

Bước 2: Kết nối với máy chủ MCP của Firebase

Mặc dù nhiều kỹ năng của tác nhân Firebase sử dụng CLI Firebase cho các nhiệm vụ, nhưng bạn cũng nên kết nối tác nhân lập trình AI với máy chủ MCP của Firebase. Kết nối này giúp tác nhân của bạn tương tác hiệu quả hơn với môi trường Firebase, mang lại khả năng tích hợp và truy cập sâu hơn.

Phương pháp sử dụng AI

Trong hầu hết các trường hợp, bạn có thể yêu cầu tác nhân lập trình AI thiết lập máy chủ MCP Firebase. Tuy nhiên, nếu máy chủ gặp khó khăn hoặc bạn không thấy máy chủ Firebase MCP trong danh sách, hãy chuyển sang Phương thức thủ công.

Phương thức thủ công

Antigravity

Cách định cấu hình Antigravity để sử dụng máy chủ MCP của Firebase:

  1. Trong Antigravity, hãy nhấp vào trình đơn trong ngăn Agent (Nhân viên) > MCP Servers (Máy chủ MCP).
  2. Chọn Firebase > Cài đặt.

Thao tác này sẽ tự động cập nhật tệp mcp_config.json. Bạn có thể xem tệp này bằng cách nhấp vào Quản lý máy chủ MCP ở đầu ngăn Cửa hàng MCP > Xem cấu hình thô, với nội dung sau:

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

Claude

Claude Code

  • Cách 1: Cài đặt thông qua trình bổ trợ (Nên dùng)

    Cách dễ nhất để thiết lập máy chủ MCP của Firebase trong Claude Code là cài đặt trình bổ trợ chính thức của Firebase:

    1. Thêm Firebase Marketplace cho các trình bổ trợ Claude:

      claude plugin marketplace add firebase/firebase-tools
    2. Cài đặt trình bổ trợ Claude cho Firebase:

      claude plugin install firebase@firebase
    3. Xác minh quá trình cài đặt:

      claude plugin marketplace list
  • Cách 2: Định cấu hình máy chủ MCP theo cách thủ công

    Ngoài ra, bạn có thể định cấu hình máy chủ Firebase MCP theo cách thủ công:

    1. Chạy lệnh sau trong thư mục ứng dụng:

      claude mcp add firebase npx -- -y firebase-tools@latest mcp
    2. Xác minh quá trình cài đặt:

      claude mcp list

      Chương trình sẽ hiển thị:

      firebase: npx -y firebase-tools@latest mcp - ✓ Connected
      

Claude Desktop

Để định cấu hình Claude Desktop sử dụng máy chủ MCP của Firebase, hãy chỉnh sửa tệp claude_desktop_config.json. Bạn có thể mở hoặc tạo tệp này trong trình đơn Claude > Cài đặt. Chọn thẻ Nhà phát triển, rồi nhấp vào Chỉnh sửa cấu hình.

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

Con trỏ

Cách 1: Trình bổ trợ Marketplace (nên dùng)

Cài đặt Trình bổ trợ Firebase từ Cursor Marketplace. Thao tác này sẽ tự động định cấu hình máy chủ MCP và cấp quyền truy cập vào các kỹ năng của tác nhân Firebase.

Cách 2: Thiết lập MCP bằng một lần nhấp

Nếu bạn chỉ muốn thêm máy chủ MCP vào cấu hình chung, hãy nhấp vào nút sau:

Cài đặt máy chủ MCP

Cách 3: Cấu hình thủ công

Nếu bạn muốn định cấu hình máy chủ cho một dự án cụ thể hoặc muốn chỉnh sửa chế độ cài đặt theo cách thủ công, hãy cập nhật tệp mcp.json:

  • Đối với một dự án cụ thể, hãy chỉnh sửa .cursor/mcp.json
  • Đối với tất cả dự án (toàn cục), hãy chỉnh sửa ~/.cursor/mcp.json
"mcpServers": {
  "firebase": {
    "command": "npx",
    "args": ["-y", "firebase-tools@latest", "mcp"]
  }
}

Cline

Để định cấu hình Cline sử dụng máy chủ Firebase MCP, hãy chỉnh sửa tệp cline_mcp_settings.json. Bạn có thể mở hoặc tạo tệp này bằng cách nhấp vào biểu tượng Máy chủ MCP ở đầu ngăn Cline, sau đó nhấp vào nút Định cấu hình máy chủ MCP.

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

VS Code Copilot

Để định cấu hình một dự án, hãy chỉnh sửa tệp .vscode/mcp.json trong không gian làm việc của bạn:

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

Để cung cấp máy chủ trong mọi dự án bạn mở, hãy chỉnh sửa chế độ cài đặt người dùng, ví dụ:

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

Lướt ván buồm

Để định cấu hình Windsurf Editor, hãy chỉnh sửa tệp ~/.codeium/windsurf/mcp_config.json:

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

Bước 3: Khởi chạy các dịch vụ của Firebase

Sau khi thiết lập các kỹ năng và công cụ của tác nhân, giờ đây, bạn có thể sử dụng ngôn ngữ tự nhiên để thiết lập tác nhân lập trình AI Cloud Firestore, Firebase Authentication và Firebase Hosting.

  1. Yêu cầu nhân viên hỗ trợ thiết lập một dịch vụ. Ví dụ: bạn có thể sử dụng các câu lệnh như sau:

    • Thiết lập Cloud Firestore làm cơ sở dữ liệu cho ứng dụng này.
    • Tạo trang đăng nhập bằng Authentication và cập nhật Security Rules để đảm bảo chỉ những người dùng được uỷ quyền mới có thể đọc và ghi dữ liệu của riêng họ.
    • Thiết lập Firebase Hosting và triển khai ứng dụng lên kênh phát hành công khai.
  2. Xem xét mọi thông tin và làm theo mọi bước hướng dẫn mà nhân viên hỗ trợ có thể cung cấp, chẳng hạn như:

    1. Kế hoạch: Tác nhân của bạn đề xuất một chiến lược dựa trên toàn bộ mã nguồn hiện có.
    2. Kết nối: Tác nhân liên kết mã cục bộ của bạn với một dự án Firebase hiện có hoặc giúp bạn tạo một dự án Firebase mới.
    3. Khởi chạy tài nguyên: Tác nhân sẽ thêm các thư viện và cấu hình Firebase cần thiết vào toàn bộ mã nguồn của bạn.
    4. Cập nhật tệp: Tác nhân của bạn tạo và cập nhật mọi tệp cần thiết, chẳng hạn như firestore.rules (để xác định ai có thể đọc, ghi hoặc truy vấn dữ liệu trong cơ sở dữ liệu của bạn) hoặc firebase.json (để thông báo cho Firebase CLI về những dịch vụ cần triển khai và cách định cấu hình các dịch vụ đó).
    5. Thực thi: Nhân viên hỗ trợ sẽ hướng dẫn bạn thực hiện các bước cấu hình hoặc triển khai bổ sung.

Các mẹo chung để đưa ra câu lệnh cho tác nhân lập trình AI

Để khai thác tối đa tác nhân lập trình AI, đặc biệt là khi làm việc với các công cụ tích hợp đa diện như Firebase, hãy coi hoạt động tương tác là một hoạt động cộng tác thay vì một lệnh duy nhất.

Nêu rõ ràng và cung cấp bối cảnh

Mặc dù máy chủ MCP của Firebase cung cấp cho tác nhân nhiều thông tin ngữ cảnh về dự án của bạn, nhưng câu lệnh rõ ràng và cụ thể bằng ngôn ngữ tự nhiên sẽ mang lại kết quả tốt nhất. Tránh những yêu cầu mơ hồ.

  • Mơ hồ: "Khắc phục lỗi cơ sở dữ liệu."
  • Cụ thể: "Tôi gặp lỗi "permission denied" (bị từ chối quyền) khi cố gắng ghi vào tập hợp "users" (người dùng) trong Cloud Firestore. Xem lại firestore.rules của tôi và đề xuất cách khắc phục cho phép người dùng đã xác thực ghi vào tài liệu của chính họ."

Lặp lại và tinh chỉnh

Các tác nhân lập trình AI hiếm khi tạo ra mã hoàn hảo ngay trong lần thử đầu tiên đối với các tác vụ phức tạp. Nếu câu trả lời chưa đúng ý bạn, hãy tiếp tục trò chuyện:

  • Cung cấp thông báo lỗi: Dán mọi lỗi dòng lệnh hoặc nhật ký bảng điều khiển vào cuộc trò chuyện.
  • Yêu cầu điều chỉnh: "Mã đó sử dụng SDK phiên bản 8 cũ. Hãy viết lại bằng SDK mô-đun Firebase phiên bản 9."
  • Yêu cầu giải thích: "Giải thích cách các biện pháp đó Firebase Security Rules bảo vệ dữ liệu người dùng".

Xác minh trước khi thực hiện

Tác nhân lập trình AI rất mạnh mẽ, nhưng chúng có thể mắc lỗi hoặc "ảo tưởng" (tạo ra các hàm được đặt tên hoặc dịch vụ không chính xác).

  • Xem xét mã: Luôn đọc kỹ mã được tạo, đặc biệt là Firebase Security Rules và các tệp cấu hình (như firebase.json), trước khi triển khai vào môi trường thực tế.
  • Kiểm thử cục bộ: Bất cứ khi nào có thể, hãy yêu cầu tác nhân giúp bạn kiểm thử các thay đổi trên máy cục bộ trước khi đưa vào hoạt động.

Sử dụng kết nối MCP

Vì máy chủ MCP của Firebase cho phép tác nhân của bạn trực tiếp xem cấu trúc dự án, nên bạn có thể tham chiếu các tệp cụ thể để nhận được lời khuyên triển khai phù hợp.

  • Ví dụ: "Xem tệp src/web/index.html của tôi và cho tôi biết vị trí cần thêm tập lệnh khởi chạy Firebase tiêu chuẩn."

Các bước tiếp theo