Hướng dẫn cài đặt Plugin MCP

Tìm hiểu cách cài đặt và cấu hình MCP server (Model Context Protocol) để mở rộng khả năng của Claude với các công cụ bên ngoài, nguồn dữ liệu và tích hợp đa dạng.

Model Context Protocol (MCP) là một tiêu chuẩn mở do Anthropic phát triển, giúp chuẩn hóa cách các mô hình AI kết nối với nguồn dữ liệu và công cụ bên ngoài. Thường được ví như "USB-C cho AI", MCP cung cấp một giao diện chung để Claude tương tác với file trên máy, cơ sở dữ liệu, API và các công cụ phát triển của bạn.

Tính đến năm 2026, MCP được hỗ trợ bởi Anthropic, OpenAI, Google và Microsoft — trở thành tiêu chuẩn tích hợp phổ biến nhất cho các AI agent. Hiện có hơn 593 MCP server trong hệ sinh thái, từ các gói chính thức của Anthropic đến các tích hợp do cộng đồng xây dựng.

Yêu cầu chuẩn bị

terminal

Node.js (LTS)

Cần thiết để chạy hầu hết các MCP server qua npx. Tải về tại nodejs.org.

code

Python / uv (Tùy chọn)

Một số MCP server viết bằng Python và sử dụng uvx thay vì npx.

desktop_mac

Claude Desktop

Ứng dụng Claude Desktop phải được cài đặt sẵn. Hỗ trợ macOS và Windows.

info

Không cần gói trả phí

MCP server hoạt động với mọi gói Claude, kể cả gói miễn phí.

Vị trí file cấu hình

Các MCP server được cấu hình trong file claude_desktop_config.json. Vị trí file phụ thuộc vào hệ điều hành bạn đang dùng:

desktop_mac macOS

~/Library/Application Support/Claude/claude_desktop_config.json

desktop_windows Windows

%APPDATA%\Claude\claude_desktop_config.json

lightbulb

Mẹo

Bạn không cần tạo file này thủ công. Claude Desktop có thể tự tạo file cho bạn — xem các bước cài đặt bên dưới.

Hướng dẫn cài đặt từng bước

Mở Claude Desktop

Khởi chạy ứng dụng Claude Desktop trên máy tính của bạn.

Mở Cài đặt

Nhấn vào menu hamburger → File → Settings (hoặc dùng phím tắt).

Chuyển đến tab Developer

Trong bảng Settings, nhấn vào tab "Developer" ở thanh bên trái.

Nhấn "Edit Config"

Thao tác này sẽ mở (hoặc tạo mới) file claude_desktop_config.json trong trình soạn thảo mặc định của bạn.

Thêm cấu hình MCP Server

Thêm các MCP server bạn muốn vào phần mcpServers (xem định dạng cấu hình bên dưới).

Lưu và khởi động lại

Lưu file cấu hình và khởi động lại Claude Desktop hoàn toàn để các thay đổi có hiệu lực.

Kiểm tra cài đặt

Tìm biểu tượng búa 🔨 trên giao diện Claude Desktop. Nhấn vào đó để xem tất cả các công cụ MCP khả dụng.

Định dạng cấu hình

File cấu hình sử dụng cấu trúc JSON đơn giản. Mỗi MCP server được khai báo trong phần mcpServers:

data_object Cấu trúc cơ bản

{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "@package/server-name"],
      "env": {
        "API_KEY": "your-api-key-here"
      }
    }
  }
}

folder Ví dụ Filesystem Server

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/Users/username/Downloads"
      ]
    }
  }
}

stacks Ví dụ nhiều Server

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/username/Documents"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxxxxxx"
      }
    },
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "your-brave-api-key"
      }
    }
  }
}

Các MCP Server phổ biến

Dưới đây là những MCP server được sử dụng rộng rãi nhất trong hệ sinh thái:

Server	Gói (Package)	Chức năng
Filesystem	`@modelcontextprotocol/server-filesystem`	Đọc/ghi file trên máy, tạo tài liệu, sắp xếp thư mục
GitHub	`@modelcontextprotocol/server-github`	Đọc mã nguồn, xem PR, theo dõi workflow
PostgreSQL	`@modelcontextprotocol/server-postgres`	Truy cập cơ sở dữ liệu chỉ đọc, xem cấu trúc schema
Brave Search	`@modelcontextprotocol/server-brave-search`	Tìm kiếm trên web
Puppeteer	`@modelcontextprotocol/server-puppeteer`	Tự động hóa trình duyệt và thu thập dữ liệu web
Sequential Thinking	`@modelcontextprotocol/server-sequential-thinking`	Suy luận động và giải quyết vấn đề theo từng bước
Slack	`@anthropic/mcp-server-slack`	Tích hợp không gian làm việc Slack
Google Drive	`@anthropic/mcp-server-gdrive`	Tích hợp Google Docs, Sheets và Drive
Docker	`@anthropic/mcp-server-docker`	Quản lý và điều phối container
Memory	`@modelcontextprotocol/server-memory`	Bộ nhớ lưu trữ liên tục giữa các phiên làm việc

Giao thức truyền tải

MCP hỗ trợ nhiều cơ chế truyền tải khác nhau để giao tiếp giữa Claude và các MCP server:

terminal

stdio (Standard I/O)

Giao thức mặc định cho Claude Desktop. Client khởi chạy MCP server như một tiến trình cục bộ và giao tiếp qua stdin/stdout. Đây chính là những gì các trường command và args trong file cấu hình định nghĩa.

check Khuyên dùng cho môi trường cục bộ

cloud

StreamableHTTP

Giao thức được khuyên dùng cho truy cập web và từ xa. Hỗ trợ nhiều client kết nối đồng thời và là phiên bản thay thế cho giao thức SSE đã ngừng hỗ trợ.

language Dành cho server từ xa/web

do_not_disturb

SSE (Server-Sent Events)

Đã ngừng hỗ trợ, được thay thế bởi StreamableHTTP. Không nên sử dụng cho các tích hợp mới.

Lưu ý bảo mật

warning

Quan trọng

MCP server chạy cục bộ và có quyền truy cập vào hệ thống của bạn. Vào tháng 1 năm 2026, các lỗ hổng nghiêm trọng đã được phát hiện trong MCP server Git chính thức của Anthropic. Hãy luôn tuân thủ các nguyên tắc bảo mật.

check_circle

Chỉ cài đặt từ nguồn đáng tin cậy — Sử dụng các gói chính thức của Anthropic hoặc các server cộng đồng uy tín được bảo trì thường xuyên.

check_circle

Cập nhật server thường xuyên — Chạy npx @package/server-name định kỳ để nhận các bản vá bảo mật mới nhất.

check_circle

Dùng biến môi trường cho thông tin bí mật — Không bao giờ viết trực tiếp API key vào file cấu hình. Hãy sử dụng trường env hoặc biến môi trường hệ thống.

check_circle

Giới hạn phạm vi truy cập file — Khi sử dụng filesystem server, chỉ cấp quyền truy cập vào những thư mục thực sự cần thiết.

check_circle

Gỡ bỏ server không sử dụng — Mỗi MCP server đều làm tăng bề mặt tấn công. Hãy gỡ bỏ những server bạn không còn dùng đến.

arrow_forward Xem hướng dẫn đầy đủ về Bảo mật Prompt Injection

Xử lý sự cố

Biểu tượng búa không xuất hiện sau khi khởi động lại expand_more

Nguyên nhân thường gặp là file cấu hình có lỗi cú pháp JSON. Các lỗi phổ biến:

Thiếu hoặc thừa dấu phẩy giữa các mục server
Ngoặc vuông hoặc ngoặc nhọn không khớp
Dùng dấu nháy đơn thay vì dấu nháy kép

Kiểm tra JSON tại jsonlint.com hoặc dùng lệnh node -e "JSON.parse(require('fs').readFileSync('path/to/config.json'))"

MCP server không khởi động được expand_more

Hãy kiểm tra những điều sau:

Đảm bảo Node.js đã được cài đặt và npx có trong PATH của hệ thống
Thử chạy lệnh npx trực tiếp trong terminal để xem thông báo lỗi
Kiểm tra tên gói có chính xác không (lỗi đánh máy rất hay gặp)
Với các server yêu cầu API key, hãy xác nhận key hợp lệ và được khai báo đúng trong trường env

Lỗi từ chối quyền truy cập (Permission denied) expand_more

MCP server kế thừa quyền hạn của tiến trình Claude Desktop:

Trên macOS, kiểm tra System Settings → Privacy & Security để cấp quyền phù hợp
Đảm bảo các thư mục khai báo trong file cấu hình có thể truy cập được bởi tài khoản người dùng của bạn
Với filesystem server, xác nhận các đường dẫn trong args tồn tại và có quyền đọc

extension

Khám phá hệ sinh thái MCP

Với hơn 593 MCP server hiện có, rất có thể đã có server phù hợp với nhu cầu của bạn. Duyệt danh mục MCP server chính thức tại modelcontextprotocol.io hoặc xem các danh sách do cộng đồng tuyển chọn trên GitHub để cập nhật những server mới nhất.