·

Google Drive MCP Là Gì?

Tìm hiểu Google Drive MCP là gì và cách nó giúp AI agent tìm kiếm, đọc và tổ chức file.

Rất nhiều team sản phẩm vẫn giữ toàn bộ tri thức nghiệp vụ — spec, PRD, biên bản họp stakeholder, bảng so sánh đối thủ — nằm rải rác trong Google Docs, Sheets và Slides. Đó là nguồn thông tin cực kỳ giá trị, nhưng lại gần như "vô hình" với AI agent nếu bạn không kết nối nó vào. Google Drive MCP (Model Context Protocol) chính là cầu nối giúp Claude Code, Cursor, Gemini CLI hay OpenCode đọc trực tiếp các tài liệu đó — tìm, mở, và trích xuất nội dung — mà không cần bạn copy-paste tay từng đoạn vào prompt.

Bài này đi qua bốn phần cốt lõi: bộ tool chuẩn mà một Google Drive MCP server cung cấp, các hướng xác thực (authentication) khả dụng, những việc AI thực sự làm tốt khi có quyền đọc Drive, và — quan trọng không kém — những rủi ro bảo mật bạn cần lường trước khi cấp quyền này cho một tác nhân tự động.

Các Tool Cốt Lõi Của Google Drive MCP: Search, Đọc File, Thư Mục Và Format Export

Khác với Confluence hay Jira (có REST API thiết kế sẵn cho use case "trích xuất nội dung có cấu trúc"), Google Drive về bản chất là một hệ thống lưu file, nên MCP server phải xử lý thêm một bước quan trọng: chuyển đổi định dạng (export) trước khi đưa nội dung vào context của LLM (Large Language Model — mô hình ngôn ngữ lớn). Một Google Doc không phải là text thuần, nó là một cấu trúc XML nội bộ của Google — MCP server cần gọi Drive Export API để lấy ra bản markdown hoặc plain text tương ứng.

Bộ tool phổ biến bạn sẽ thấy ở phần lớn Google Drive MCP server (dựa trên reference implementation @modelcontextprotocol/server-gdrive, và các fork community đang được duy trì tích cực hơn như @isaacphi/mcp-gdrive):

  • gdrive_search — tìm file theo tên hoặc full-text, hỗ trợ cú pháp Drive search query (ví dụ fullText contains 'onboarding flow'), trả về danh sách gồm id, name, mimeType, modifiedTime, webViewLink.
  • gdrive_read_file — đọc nội dung một file theo fileId, tự động export đúng format theo mimeType: Google Docs → Markdown, Google Sheets → CSV, Google Slides → text theo từng slide, PDF/Office file (.docx, .pptx) → text được trích xuất qua OCR/parser nội bộ của Drive.
  • gdrive_list_files (một số fork gọi là gdrive_list_folder) — liệt kê file trong một folder cụ thể theo folderId, hữu ích khi bạn muốn agent quét toàn bộ một thư mục dự án thay vì search từng file.

Ví dụ cấu hình MCP server dạng stdio (giao tiếp qua standard input/output, phổ biến nhất cho server chạy local) trong file cấu hình MCP chuẩn:

{
  "mcpServers": {
    "gdrive": {
      "command": "npx",
      "args": ["-y", "@isaacphi/mcp-gdrive"],
      "env": {
        "CLIENT_ID": "${GDRIVE_OAUTH_CLIENT_ID}",
        "CLIENT_SECRET": "${GDRIVE_OAUTH_CLIENT_SECRET}",
        "GDRIVE_CREDS_DIR": "/Users/you/.config/gdrive-mcp"
      }
    }
  }
}

Điểm khác biệt lớn nhất khi AI agent có tool này: bạn không cần biết trước fileId hay đường dẫn folder chính xác. Agent tự search, tự đọc, tự nối kết quả từ nhiều file lại — bạn chỉ cần ra yêu cầu bằng ngôn ngữ tự nhiên như "tìm tài liệu PRD mới nhất về tính năng checkout".

Mẹo: Khi mới kết nối, hãy thử prompt an toàn kiểu "Tìm 5 file Google Docs có chữ 'API design' được sửa trong 30 ngày gần nhất" trước khi giao việc phức tạp. Việc này giúp bạn xác nhận gdrive_search hoạt động đúng phạm vi (scope) tài khoản, đồng thời quan sát format kết quả trả về trước khi tin tưởng agent tự động hoá các bước sâu hơn.

Có ba hướng xác thực chính, và lựa chọn sai ngay từ đầu là nguyên nhân phổ biến nhất khiến người mới setup Google Drive MCP mất cả buổi chiều để debug.

Hướng 1: OAuth 2.0 với tài khoản cá nhân (user-based OAuth). Đây là cách phù hợp nhất cho máy cá nhân của developer. Bạn tạo OAuth Client ID loại "Desktop app" trong Google Cloud Console, tải file credentials.json, rồi chạy một lần flow xác thực trong browser (server MCP tự mở URL consent screen). Sau khi bạn đồng ý cấp quyền, server lưu access token + refresh token vào một file cache local (thường là .gdrive-server-credentials.json), từ đó tự refresh mà không cần đăng nhập lại. Agent sẽ có đúng những quyền mà tài khoản Google của bạn có — nếu bạn share hạn chế, agent cũng chỉ thấy đúng phạm vi đó.

Hướng 2: Scope OAuth — chọn đúng mức độ truy cập. Google Drive API cung cấp nhiều scope với mức rủi ro khác nhau, và đây là quyết định quan trọng nhất khi cấp quyền cho một AI agent:

  • drive.readonly — chỉ đọc, không thể tạo/sửa/xoá gì. Đây là lựa chọn mặc định nên dùng cho hầu hết use case "đọc tài liệu, tóm tắt, trích xuất requirement".
  • drive.file — chỉ truy cập những file mà chính ứng dụng này đã tạo hoặc được user mở qua file picker, an toàn hơn drive toàn quyền nhưng không phù hợp nếu bạn cần agent đọc file có sẵn của cả team.
  • drive — toàn quyền đọc/viết/xoá trên toàn bộ Drive mà tài khoản có quyền truy cập. Chỉ nên dùng khi workflow của bạn thực sự cần agent tạo/cập nhật file, và bạn đã có cơ chế review trước khi ghi.

Hướng 3: Service Account với domain-wide delegation. Dành cho tổ chức dùng Google Workspace, muốn agent chạy dạng "bot" không gắn với tài khoản cá nhân nào (phù hợp cho CI/CD, chạy theo lịch). Admin Workspace phải cấp domain-wide delegation cho service account trong Admin Console, chỉ định đúng scope OAuth được phép impersonate. Đây là cách mạnh nhất về mặt kỹ thuật (service account có thể "đóng vai" bất kỳ user nào trong domain), nên cũng là cách rủi ro nhất nếu file JSON key của service account bị lộ.

export GDRIVE_OAUTH_CLIENT_ID="1234567890-abc.apps.googleusercontent.com"
export GDRIVE_OAUTH_CLIENT_SECRET="GOCSPX-xxxxxxxxxxxxxxxxxxxx"

Mẹo: Luôn bắt đầu với scope drive.readonly cho bất kỳ AI agent mới nào, bất kể client bạn dùng là gì. Nếu sau này thực sự cần agent tạo file (ví dụ ghi report vào một Google Doc), hãy tách riêng một OAuth Client ID khác chỉ dùng cho use case ghi đó, để bạn dễ audit và revoke độc lập mà không ảnh hưởng tới các agent chỉ cần đọc.

AI Có Thể Tự Động Hóa Gì: Tìm Kiếm, Trích Xuất Và Tóm Tắt Tài Liệu

Khi đã kết nối xong, đây là những việc Google Drive MCP thực sự phát huy giá trị trong công việc hàng ngày của kỹ sư và product manager.

1. Document discovery (khám phá tài liệu) khi vào một dự án mới. Thay vì hỏi đồng nghiệp "spec nằm ở đâu", bạn để agent tự search theo từ khoá nghiệp vụ, liệt kê ra các candidate liên quan kèm ngày sửa gần nhất, giúp bạn nhanh chóng xác định phiên bản mới nhất — vấn đề rất phổ biến ở các Drive không có convention đặt tên rõ ràng.

2. Trích xuất requirement từ tài liệu phi cấu trúc. Một PRD viết theo văn phong tự do, không có bảng biểu rõ ràng, vẫn hoàn toàn có thể được agent đọc và tự rút ra danh sách requirement dạng bullet, kèm trích dẫn câu gốc để bạn verify lại.

3. Tóm tắt biên bản họp và theo dõi action item. Nhiều team lưu meeting note trực tiếp trên Google Docs. Agent có thể đọc một loạt file note theo tuần, tổng hợp lại các action item chưa hoàn thành, ai chịu trách nhiệm, deadline — việc mà nếu làm tay sẽ rất tốn thời gian khi số lượng file tăng lên.

4. So sánh phiên bản tài liệu. Khi một spec được chỉnh sửa nhiều lần bởi nhiều stakeholder, agent có thể đọc song song hai file (hoặc hai version cũ/mới của cùng file, nếu bạn export riêng), chỉ ra điểm khác biệt về mặt yêu cầu nghiệp vụ — không phải diff dạng text thô mà là diff ở mức ý nghĩa.

Ví dụ prompt thực tế cho use case đầu tiên:

Tìm tất cả Google Docs trong Drive có chữ "checkout flow" hoặc
"payment retry", được sửa trong 60 ngày gần nhất. Với mỗi file,
đọc nội dung và tóm tắt trong 2 câu file đó nói về vấn đề gì,
sắp xếp theo modifiedTime giảm dần.

Mẹo: Khi giao việc tổng hợp nhiều tài liệu, luôn yêu cầu agent trích dẫn rõ tên file và đoạn gốc (nguồn) cho mỗi kết luận đưa ra. Điều này giúp bạn verify nhanh khi có nghi ngờ, và tránh tình trạng agent "bịa" thông tin (hallucination) khi tổng hợp từ nhiều nguồn khác nhau.

Vấn Đề Bảo Mật Dữ Liệu Khi Agent Đọc Tài Liệu Công Ty

Đây là phần dễ bị bỏ qua nhất nhưng lại quan trọng không kém phần kỹ thuật. Khi bạn cấp quyền Drive cho một AI agent, bạn đang cho một hệ thống tự động khả năng đọc (và có thể cả viết) vào toàn bộ kho tri thức của công ty — bao gồm cả những tài liệu bạn quên rằng mình có quyền truy cập.

Phạm vi truy cập thực tế rộng hơn bạn nghĩ. OAuth theo tài khoản cá nhân nghĩa là agent thấy được MỌI file mà tài khoản đó có quyền xem — kể cả file share từ đồng nghiệp khác, kể cả những shared drive bạn chỉ là viewer. Nếu bạn hỏi agent một câu tưởng như vô hại ("tìm file có chữ 'lương'"), nó có thể vô tình đọc và trích dẫn nội dung từ một file bảng lương mà bạn được share nhầm từ lâu.

Dữ liệu đi qua LLM provider. Nội dung tài liệu, sau khi được MCP server export, sẽ được đưa vào context window (cửa sổ ngữ cảnh) của model và gửi tới LLM provider (Anthropic, Google, OpenAI...) tuỳ client bạn dùng. Với tài liệu chứa thông tin nhạy cảm (PII — Personally Identifiable Information, dữ liệu khách hàng, thông tin tài chính chưa công bố), cần kiểm tra chính sách data retention và data processing agreement (DPA) của provider tương ứng trước khi cho agent đọc loại tài liệu này trong môi trường production.

Log và output cũng là một bề mặt rủi ro. Nếu agent chạy trong CI, output (bao gồm nội dung trích dẫn từ tài liệu nội bộ) có thể bị log lại vào hệ thống CI/CD, hoặc hiện trong PR comment công khai. Luôn rà soát pipeline có ghi log những gì trước khi cho agent tự động đọc và paste nội dung Drive vào nơi có thể bị truy cập rộng hơn dự kiến.

Giải pháp thực tế:

  • Dùng shared drive riêng, chỉ chứa tài liệu được duyệt để AI agent truy cập, thay vì cấp quyền vào toàn bộ "My Drive" cá nhân.
  • Luôn dùng scope readonly trừ khi có lý do rõ ràng cần ghi.
  • Với dữ liệu cực nhạy cảm (hợp đồng, thông tin nhân sự), loại hẳn khỏi phạm vi mà agent có thể search tới — không dựa vào việc "agent sẽ không tìm ra" làm cơ chế bảo vệ.

Mẹo: Trước khi triển khai Google Drive MCP cho cả team, hãy tự chạy thử một prompt search rộng ("tìm mọi file có chữ 'confidential' hoặc 'internal only'") bằng chính tài khoản sẽ dùng cho agent. Nếu kết quả trả về khiến bạn giật mình, đó là dấu hiệu cần dọn lại quyền chia sẻ trên Drive trước khi kết nối AI vào, chứ không phải sau.

Mẹo Và Lưu Ý Thực Chiến

Vài điều rút ra sau khi triển khai Google Drive MCP cho một số team product/engineering thực tế:

  • Đặt convention đặt tên file rõ ràng (ví dụ tiền tố [PRD], [RFC], kèm ngày dạng YYYY-MM-DD) giúp gdrive_search trả kết quả chính xác hơn nhiều so với tài liệu đặt tên tự do như "Untitled document copy 3".
  • Google Slides là loại file khó nhất để agent đọc chính xác — nội dung trải trên nhiều slide, text box không theo thứ tự đọc tự nhiên, nên luôn double-check phần trích xuất từ Slides kỹ hơn so với Docs.
  • Tạo một tài khoản Google riêng (không phải tài khoản cá nhân của bạn) chỉ dùng cho MCP server nếu có thể, để dễ audit và revoke quyền độc lập khi không còn cần dùng agent nữa.

Mẹo: Ghi lại một ghi chú ngắn (ví dụ trong AGENTS.md hay CLAUDE.md của project) mô tả rõ những shared drive/folder nào agent được phép truy cập, và quy tắc đặt tên file team đang dùng. Điều này giúp agent search chính xác hơn ngay từ prompt đầu tiên, thay vì phải dò tìm qua nhiều lượt.

Tiếp Google Drive MCP với Claude Code CLI and VS Code