Cảnh quen thuộc: bạn đang debug một lỗi, cần kiểm tra PR liên quan trên GitHub, search Stack Overflow để xem người khác gặp vấn đề tương tự chưa, rồi đọc thêm API doc từ trang chính thức. Kết quả: 4 tab browser mở, copy-paste liên tục, context bị phân mảnh.

Với MCP server được cài đúng, Claude Code làm hết những việc đó — không rời terminal, không gián đoạn luồng làm việc.

MCP Là Gì?

Model Context Protocol (MCP) là chuẩn kết nối Claude Code với tool và data bên ngoài. Hiểu đơn giản: như cổng USB cho AI assistant. Thay vì Claude chỉ biết những gì bạn paste vào, nó có thể trực tiếp đọc file, gọi API, điều khiển browser, tìm kiếm web.

Anthropic thiết kế MCP như một open standard — bất kỳ ai cũng có thể viết server. Hiện tại có hàng trăm server cộng đồng, nhưng hầu hết chất lượng không ổn định. Bài này chỉ tập trung vào 5 server đáng tin cậy nhất, được bảo trì bởi các công ty lớn.

Cách Thêm MCP Server

Hai kiểu transport chính:

Terminal window
# stdio — chạy local process
claude mcp add --transport stdio [--env KEY=val] <name> -- <command> [args...]
# http — kết nối remote endpoint
claude mcp add --transport http <name> <url>

Kiểm tra server đã cài:

Terminal window
claude mcp list
claude mcp get <name>

Xóa server:

Terminal window
claude mcp remove <name>

Bên trong session, gõ /mcp để xem trạng thái tất cả server đang kết nối.

Về scope: mặc định là local (chỉ project hiện tại). Thêm --scope project để lưu vào .mcp.json và chia sẻ với cả team. --scope user để áp dụng cho tất cả project.


1. GitHub MCP — Làm Việc Với GitHub Không Cần Rời Terminal

Bởi: GitHub (official)

GitHub MCP cho phép Claude Code đọc PR, comment, tạo issue, xem diff, kiểm tra CI status — tất cả trong cùng một session. Không cần mở browser.

Cài đặt:

Terminal window
claude mcp add --transport http github https://api.githubcopilot.com/mcp/

Sau khi cài, chạy /mcp trong session để authenticate qua GitHub OAuth.

Ví dụ thực tế:

Bạn: "Review PR #142, tóm tắt những thay đổi chính và chỉ ra potential issues"
Claude: [đọc diff, comments, check CI — trả về phân tích chi tiết]

Hoặc khi debug:

Bạn: "Tìm tất cả PR liên quan đến AuthModule trong 2 tuần qua"
Claude: [search GitHub, liệt kê PR với status và reviewer]

Lưu ý quan trọng: Package cũ @modelcontextprotocol/server-github đã bị archived và không còn được bảo trì. Dùng HTTP transport ở trên — đây là cách chính thức hiện tại.


2. Brave Search MCP — Tìm Kiếm Web Ngay Trong Session

Bởi: Brave

Khi Claude gặp vấn đề không có trong training data — lỗi mới, thư viện vừa release, API thay đổi — nó cần tìm kiếm web. Brave Search MCP cho phép điều đó.

Lấy API key: brave.com/search/api — có free tier 2,000 queries/tháng, đủ dùng.

Cài đặt:

Terminal window
claude mcp add --transport stdio \
--env BRAVE_API_KEY=YOUR_KEY \
brave-search -- npx -y @brave/brave-search-mcp-server

Thay YOUR_KEY bằng key thực của bạn.

Ví dụ thực tế:

Bạn: "Kotlin 2.1 có breaking changes gì so với 2.0?"
Claude: [search web, tổng hợp release notes và migration guide]
Bạn: "Tìm cách fix lỗi 'Cannot read property of undefined' trong React 19 strict mode"
Claude: [search Stack Overflow, GitHub issues, trả về giải pháp đã được confirm]

Lưu ý: Package cũ @modelcontextprotocol/server-brave-search đã archived. Dùng @brave/brave-search-mcp-server — package chính thức từ Brave.


3. Playwright MCP — Điều Khiển Browser Có Screenshot

Bởi: Microsoft

Playwright MCP cho Claude Code khả năng điều khiển browser thật: navigate URL, click button, fill form, chụp screenshot. Hữu ích cho automation testing, scraping có xác thực, kiểm tra UI.

Cài đặt:

Terminal window
claude mcp add --transport stdio playwright -- npx -y @playwright/mcp@latest

Ví dụ thực tế:

Bạn: "Vào trang staging của mình, login với test account, chụp screenshot trang dashboard và báo cáo lỗi nào hiển thị"
Claude: [mở browser, navigate, login, chụp screenshot, phân tích]
Bạn: "Kiểm tra form đăng ký có validate email không hợp lệ đúng chưa"
Claude: [điều khiển browser, nhập email sai format, check validation message]

Playwright MCP đặc biệt hữu ích khi kết hợp với test generation: Claude viết test, chạy trong browser, xem kết quả, sửa — tất cả trong một luồng.


4. Filesystem MCP — Truy Cập File Ngoài Project

Bởi: Anthropic (official reference implementation)

Mặc định Claude Code chỉ truy cập file trong project directory. Filesystem MCP mở rộng quyền truy cập đến những thư mục bạn chỉ định — ví dụ thư mục shared, downloaded files, hay config chung giữa nhiều project.

Cài đặt:

Terminal window
claude mcp add --transport stdio filesystem -- \
npx -y @modelcontextprotocol/server-filesystem /path/to/allowed/dir

Thay /path/to/allowed/dir bằng đường dẫn thực. Có thể chỉ định nhiều thư mục bằng cách thêm nhiều path:

Terminal window
claude mcp add --transport stdio filesystem -- \
npx -y @modelcontextprotocol/server-filesystem ~/Documents/specs ~/Downloads

Ví dụ thực tế:

Bạn: "Đọc file design spec trong ~/Documents/specs/payment-flow.pdf và implement theo đó"
Claude: [đọc file ngoài project, hiểu spec, viết code]
Bạn: "So sánh CLAUDE.md của project này với template trong ~/Documents/templates/claude-md-backend.md"
Claude: [đọc cả hai file, phân tích điểm khác nhau]

Bảo mật: Chỉ cấp quyền đến thư mục cần thiết. Tránh / hay ~ vì quá rộng.


5. Fetch MCP — Đọc Bất Kỳ URL Nào

Bởi: Anthropic (official reference implementation)

Fetch MCP cho Claude Code đọc nội dung từ bất kỳ URL nào — trang web, API endpoint, raw file từ GitHub, documentation. Khác với Brave Search (tìm kiếm), Fetch đọc trực tiếp một URL cụ thể.

Cài đặt:

Terminal window
claude mcp add --transport stdio fetch -- npx -y @modelcontextprotocol/server-fetch

Ví dụ thực tế:

Bạn: "Đọc API doc tại https://api.example.com/docs và viết client wrapper cho endpoint /payments"
Claude: [fetch URL, parse doc, generate client code]
Bạn: "Lấy nội dung file CHANGELOG.md từ https://raw.githubusercontent.com/org/repo/main/CHANGELOG.md"
Claude: [fetch raw file, hiển thị hoặc xử lý]

Fetch MCP đặc biệt hữu ích khi làm việc với third-party API — thay vì bạn phải tự đọc doc và giải thích, Claude đọc trực tiếp.


Bảng Tham Khảo Nhanh

ServerTransportPackage / URLCần Key?
GitHubHTTPhttps://api.githubcopilot.com/mcp/OAuth (qua /mcp)
Brave Searchstdio@brave/brave-search-mcp-serverBrave API key
Playwrightstdio@playwright/mcpKhông
Filesystemstdio@modelcontextprotocol/server-filesystemKhông
Fetchstdio@modelcontextprotocol/server-fetchKhông

Cảnh Báo: Package Cũ Đã Archived

Nếu bạn tìm trên Google hoặc đọc bài viết cũ, sẽ thấy nhiều hướng dẫn dùng package từ @modelcontextprotocol/ namespace. Nhiều package trong số đó đã bị archived và không còn được bảo trì:

  • @modelcontextprotocol/server-githubarchived, dùng HTTP transport thay thế
  • @modelcontextprotocol/server-brave-searcharchived, dùng @brave/brave-search-mcp-server

Các package vẫn còn active và dùng được:

  • @modelcontextprotocol/server-filesystem — vẫn OK
  • @modelcontextprotocol/server-fetch — vẫn OK
  • @playwright/mcp — Microsoft maintain, stable

Kiểm tra npm trước khi cài bất kỳ MCP package nào: xem ngày publish gần nhất và xem repository có còn active không.


Cài Tất Cả 5 Server Một Lần

Nếu bạn muốn setup nhanh, đây là tất cả lệnh theo thứ tự:

Terminal window
# 1. GitHub (HTTP transport)
claude mcp add --transport http github https://api.githubcopilot.com/mcp/
# 2. Brave Search (cần API key)
claude mcp add --transport stdio \
--env BRAVE_API_KEY=YOUR_BRAVE_KEY \
brave-search -- npx -y @brave/brave-search-mcp-server
# 3. Playwright
claude mcp add --transport stdio playwright -- npx -y @playwright/mcp@latest
# 4. Filesystem (chỉnh path cho phù hợp)
claude mcp add --transport stdio filesystem -- \
npx -y @modelcontextprotocol/server-filesystem ~/Documents
# 5. Fetch
claude mcp add --transport stdio fetch -- npx -y @modelcontextprotocol/server-fetch

Kiểm tra kết quả:

Terminal window
claude mcp list

Trong session, gõ /mcp để xem tất cả server và trạng thái kết nối.


Kết

5 server này cover khoảng 80% nhu cầu hàng ngày của developer: GitHub workflow, tìm kiếm web, browser automation, file access, và fetch URL.

Điểm quan trọng hơn là sự thay đổi về cách làm việc. Claude Code không còn là code assistant đơn thuần — nó trở thành môi trường phát triển kết nối. Thay vì bạn làm trung gian giữa các tool, Claude tự điều phối: đọc PR, search doc, chạy browser test, đọc spec file, rồi viết code — tất cả trong một luồng liên tục.

Ít context switch hơn. Ít copy-paste hơn. Nhiều code hơn.


Bạn đang dùng MCP server nào khác thấy hữu ích? Gợi ý phần tiếp theo của series này.