# MCP trong Claude Desktop là gì: thêm server filesystem đầu tiên và kiểm tra nó chạy

> MCP là chuẩn để Claude Desktop nối với công cụ và dữ liệu bên ngoài thông qua các server nhỏ chạy trên máy bạn. Bạn thêm server bằng cách sửa file cấu hình JSON, thoát hẳn Claude rồi mở lại. Sau đó nhờ Claude liệt kê file trong thư mục thử: nếu list_directory trả danh sách thì server đã chạy.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Claude Code
- Đăng: 2026-05-14 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/mcp-claude-desktop-la-gi-them-server-dau-tien

MCP (Model Context Protocol) là một chuẩn chung để Claude nói chuyện với công cụ và dữ liệu bên ngoài cuộc trò chuyện. Với Claude Desktop, nó cho phép một chương trình nhỏ chạy trên máy bạn (gọi là server) đưa thêm “khả năng” cho Claude, ví dụ đọc một thư mục file. Bạn không phải viết code, chỉ cần khai báo server trong một file cấu hình.

Vì sao đáng quan tâm? Mặc định Claude chỉ thấy những gì bạn dán hoặc đính kèm vào khung chat. MCP mở thêm một đường: Claude tự gọi công cụ khi cần, trong phạm vi bạn cho phép. Bài này giúp bạn hiểu MCP bằng ví dụ đời thường, thêm đúng một server đầu tiên (filesystem, trên một thư mục thử) và biết chắc nó đã chạy hay chưa. Video ngắn bên dưới làm nhanh từng bước, còn bài này giải thích vì sao từng bước cần thiết.

Bài này nằm trong series dành cho dân văn phòng ngại terminal. Mình giả định bạn đã cài app desktop. Nếu chưa, hãy xem tập cài đặt trước. Phần chọn desktop hay Claude Code CLI và phần cấp quyền kín dữ liệu có tập riêng, nên ở đây mình chỉ nhắc ngắn.

```video
- youtube | https://youtube.com/shorts/6x5Qu4c89d4
- facebook | https://www.facebook.com/reel/1110653885184875
- title | MCP trong Claude Desktop là gì và thêm một server đầu tiên
```

## Bản chất của MCP

### MCP giống một cái ổ cắm chung

Hãy nghĩ đến ổ cắm điện. Nếu mỗi thiết bị dùng một kiểu phích riêng, bạn phải mua một bộ chuyển đổi cho từng cái. Khi có ổ cắm chung, thiết bị nào đúng chuẩn cũng cắm vào được.

MCP đóng vai trò ổ cắm chung đó giữa ứng dụng AI và công cụ. Phía Claude Desktop là “ứng dụng khách”. Phía công cụ là “server”. Hai bên thống nhất cách hỏi: bạn có những công cụ nào, mình gọi công cụ này với tham số này, kết quả trả về là gì. Nhờ vậy, ai viết server theo chuẩn thì Claude dùng được, không cần Anthropic làm riêng từng cái.

### Server ở đây không phải máy chủ trên mạng

Chữ “server” dễ gây hiểu lầm. Với server filesystem, đó chỉ là một chương trình nhỏ chạy ngay trên máy bạn, do Claude Desktop khởi động khi mở app. Nó không phải một dịch vụ ngoài internet bạn phải thuê hay quản trị.

Cơ chế chạy như sau:

- Bạn khai báo trong file cấu hình: tên server, lệnh để khởi động nó, và tham số.
- Khi Claude Desktop mở lên, nó đọc file này và khởi động từng server.
- Mỗi server báo cho Claude biết nó có công cụ gì, ví dụ liệt kê thư mục, đọc file, ghi file.
- Trong cuộc trò chuyện, khi bạn nhờ việc phù hợp, Claude chọn công cụ, gửi yêu cầu, nhận kết quả và trả lời bạn.

### Khác gì Connectors và đính kèm file?

Đính kèm file là bạn đưa nội dung vào chat, một lần, thủ công. Connectors (tập khác trong series) là các kết nối dựng sẵn tới dịch vụ như Gmail, Drive, lịch, bạn chỉ bật và cấp quyền. MCP server là con đường mở hơn: bạn (hoặc cộng đồng) thêm công cụ mới, kể cả công cụ chạy cục bộ trên máy. Đổi lại, bạn phải tự cấu hình và tự chịu trách nhiệm với những gì mình cài. Đó cũng là lý do bài này bắt đầu bằng một thư mục thử chứ không phải thư mục công việc thật.

### Server filesystem làm được gì

Server filesystem cho Claude đọc, tìm, và sửa file trong phạm vi thư mục bạn cấp. Điểm mấu chốt là hai chữ “phạm vi”: bạn khai báo thư mục nào thì Claude chỉ làm việc trong đó. Thư mục ngoài danh sách không thuộc về nó. Vì thế ví dụ đầu tiên nên là một thư mục thử chứa vài file mẫu, đúng như video.

## Làm thế nào: thêm server đầu tiên

```steps
- Tạo thư mục thử | Tạo một thư mục riêng, bỏ vào vài file mẫu không nhạy cảm
- Cài Node.js | Cài Node.js kèm npm để máy chạy được server
- Mở file cấu hình | Mở file cấu hình của Claude Desktop theo đúng đường dẫn của hệ điều hành
- Thêm mục filesystem | Dán khối mcpServers, thay đường dẫn bằng thư mục thử
- Thoát hẳn rồi mở lại | Thoát Claude từ khay hệ thống, mở lại app
- Kiểm tra | Nhờ Claude liệt kê file trong thư mục thử
```

### Chuẩn bị thư mục thử và Node.js

Tạo một thư mục mới, đặt tên dễ nhớ, ví dụ thu-mcp trên Desktop. Bỏ vào đó 3-4 file giả: một bản ghi chú, một bảng tính mẫu, một file văn bản. Đừng dùng hợp đồng, bảng lương hay file khách hàng thật. Mục tiêu là học, không phải làm việc thật.

Tiếp theo cài Node.js kèm npm (tải bản cài từ trang chủ Node.js, bấm Next đến hết). Lý do: server filesystem được khởi động bằng lệnh npx, đi kèm Node. Nếu máy chưa có Node, Claude sẽ không khởi động được server và bạn thấy lỗi ở bước sau.

### Mở file cấu hình

File cấu hình của Claude Desktop tên là claude_desktop_config.json. Trên Windows, nó thường nằm ở `%APPDATA%\Claude\claude_desktop_config.json`. Bạn dán đường dẫn đó vào thanh địa chỉ của File Explorer để đến thẳng thư mục. Trên Mac, nó nằm trong thư mục Application Support của thư viện người dùng, trong thư mục Claude. Trong app, mục cài đặt dành cho nhà phát triển thường có nút mở file này, nhưng vị trí nút có thể đổi theo bản app, nên nếu không thấy thì cứ đi theo đường dẫn.

Nếu file chưa tồn tại, bạn tạo mới bằng Notepad hoặc một trình soạn thảo văn bản thuần, đặt đúng tên và đúng thư mục.

### Thêm mục filesystem

Mẫu tối thiểu trông như sau (thay đường dẫn bằng thư mục thử của bạn):

```json
{
 "mcpServers": {
 "filesystem": {
 "command": "npx",
 "args": [
 "-y",
 "@modelcontextprotocol/server-filesystem",
 "C:\\Users\\TenBan\\Desktop\\thu-mcp"
 ]
 }
 }
}
```

Đọc từng phần cho bớt sợ:

- mcpServers là danh sách các server bạn muốn bật.
- filesystem là tên bạn tự đặt cho mục này.
- command và args là cách khởi động: chạy npx, tải server filesystem nếu chưa có, rồi truyền vào thư mục được phép truy cập.
- Dòng cuối trong args chính là phạm vi được cấp. Đổi dòng này là đổi phạm vi.

Nếu file của bạn đã có sẵn mục mcpServers thì đừng dán thêm một khối mcpServers thứ hai. Chỉ chép mục filesystem vào bên trong khối đang có, cách nhau bằng dấu phẩy. Đây là chỗ người mới hay sai nhất, vì JSON không cho phép hai khóa trùng tên và sẽ gây lỗi hoặc bị ghi đè.

### Dấu gạch chéo ngược phải viết đôi

Trong JSON, dấu gạch chéo ngược (\) là ký tự đặc biệt. Vì vậy đường dẫn Windows phải viết mỗi dấu thành hai dấu. Đường dẫn C:\Users\TenBan\Desktop\thu-mcp sẽ thành C:\\Users\\TenBan\\Desktop\\thu-mcp, như ở mẫu trên. Trên Mac thì dùng dấu gạch chéo thường, không cần viết đôi.

Cũng nhớ kiểm tra dấu ngoặc và dấu phẩy: thiếu một dấu là cả file hỏng. Nếu không chắc, dán nội dung file vào một trình kiểm tra JSON trực tuyến (chỉ dán phần cấu hình, không có thông tin bí mật) hoặc nhờ Claude soát lỗi cú pháp.

### Thoát hẳn rồi mở lại

Lưu file chưa đủ. Claude Desktop chỉ đọc file cấu hình lúc khởi động, nên bạn phải thoát hẳn app. Bấm nút X ở góc cửa sổ thường chỉ thu nhỏ xuống khay hệ thống, app vẫn chạy ngầm và chưa đọc lại gì cả. Hãy tìm biểu tượng Claude ở khay hệ thống (góc phải thanh tác vụ Windows) hoặc thanh menu trên Mac, chọn thoát, rồi mở lại app. Đây chính là “bước dễ quên” trong video.

### Kiểm tra server đã chạy

Mở một cuộc trò chuyện mới và gõ một câu đơn giản:

```text
Hãy liệt kê các file trong thư mục thử mà bạn được cấp quyền truy cập.
```

Claude có thể hỏi xin phép trước khi dùng công cụ. Hãy đọc kỹ yêu cầu rồi cho phép. Dấu hiệu server đã chạy là công cụ list_directory được gọi và trả về danh sách thành công. Danh sách đó phải khớp đúng thư mục bạn vừa cấp, đúng những file mẫu bạn đã bỏ vào. Nếu Claude liệt kê ra một thư mục lạ, hoặc nói không có công cụ nào, thì có gì đó chưa đúng (xem phần lỗi hay gặp bên dưới).

## Dùng vào việc thật

Ba tình huống dưới đây đều giả định bạn đã có server filesystem trỏ vào một thư mục làm việc nhỏ, tách riêng khỏi dữ liệu nhạy cảm.

### Chủ shop dọn thư mục báo giá

Bối cảnh: chị Lan bán đồ gia dụng online. Thư mục báo giá có hơn chục file tên lộn xộn: bao-gia-final, bao-gia-final-2, bao-gia-moi. Chị muốn biết file nào là bản mới nhất mà chưa muốn xóa gì.

```text
Hãy liệt kê tất cả file trong thư mục báo giá. Với mỗi file, cho mình biết tên, loại file và ngày sửa gần nhất nếu bạn xem được. Sau đó đề xuất tên mới theo dạng bao-gia-khach-ngay, nhưng CHỈ đề xuất dưới dạng bảng, chưa đổi tên file nào.
```

Kết quả nhận được: một bảng tên cũ và tên đề xuất. Chỗ cần kiểm tra lại: ngày sửa có thể không có hoặc không chính xác, nên chị tự xem lại vài file trước khi đồng ý đổi. Chỉ khi bảng ổn, chị mới nhờ Claude đổi tên và nên làm trên bản sao của thư mục.

### Kế toán đọc và tóm tắt biên bản

Bối cảnh: anh Hùng làm kế toán, mỗi tháng nhận nhiều biên bản đối chiếu công nợ dạng văn bản. Anh muốn bản tóm tắt ngắn để báo cáo, không muốn dán từng file vào chat.

```text
Đọc các file biên bản đối chiếu trong thư mục thử. Tóm tắt mỗi file thành 3 gạch đầu dòng: bên nào, số tiền chênh lệch, việc cần xử lý. Cuối cùng, liệt kê những file bạn không đọc được hoặc đọc chưa chắc chắn.
```

Kết quả nhận được: bản tóm tắt theo từng file và một danh sách file bị bỏ sót. Chỗ cần kiểm tra lại: mọi con số. Claude có thể đọc nhầm hoặc làm tròn, nên anh đối chiếu số tiền với bản gốc trước khi đưa vào báo cáo. Ngoài ra, một số định dạng file (như file quét thành ảnh) có thể không đọc được, vì vậy yêu cầu liệt kê file bị bỏ sót là rất đáng giữ.

### Nhân viên văn phòng chuẩn hoá ghi chú họp

Bối cảnh: bạn Mai ghi chú họp vào các file văn bản rời, mỗi người một kiểu. Cô muốn gom việc cần làm vào một file duy nhất.

```text
Đọc các file ghi chú họp trong thư mục thử. Tạo một file mới tên tong-hop-viec-can-lam.txt trong cùng thư mục, gồm bảng: việc, người phụ trách, hạn, nguồn (tên file). Không sửa hay xóa các file ghi chú gốc.
```

Kết quả nhận được: một file mới nằm cạnh các file gốc. Đây là lần đầu server ghi file, nên Mai nên kiểm tra tận mắt: file gốc còn nguyên không, file mới có đúng nội dung không, và Claude có suy diễn thêm “người phụ trách” hay “hạn” mà ghi chú không hề nêu hay không. Việc nào bị đoán, cô tự sửa lại.

```note
Server filesystem có thể sửa, ghi và xóa file trong phạm vi được cấp. Hãy cấp đúng một thư mục thử, làm việc trên bản sao, và đừng cấp cả ổ đĩa hay thư mục chứa dữ liệu khách hàng, mật khẩu, hồ sơ nhân sự.
```

## Góc nhìn khách quan

### Điểm mạnh thật sự

MCP biến Claude từ “người chỉ đọc phần bạn dán vào” thành “người có thể tự tra cứu trong phạm vi cho phép”. Với dân văn phòng, lợi ích rõ nhất là bỏ được thao tác lặp: không cần mở từng file, copy, dán, rồi lặp lại. Việc cấu hình là một lần, các lần sau chỉ cần nói bằng ngôn ngữ thường.

Một điểm mạnh khác là tính chuẩn hóa. Vì là chuẩn chung, bạn học một cách cấu hình rồi áp dụng cho nhiều server khác về sau, chỉ khác phần lệnh và tham số. Và phạm vi được khai báo ngay trong file, nên bạn nhìn vào là biết Claude đang được cấp gì.

> Một server MCP không làm Claude thông minh hơn. Nó chỉ cho Claude tay chân, và bạn là người quyết định tay chân đó với tới đâu.
>
> — Ông T

### Giới hạn và rủi ro

Rủi ro đầu tiên là quyền truy cập file. Khi cấp quyền ghi, một yêu cầu mơ hồ có thể dẫn đến việc sửa hoặc ghi đè file mà bạn không định sửa. Cách phòng là làm trên bản sao và yêu cầu Claude “đề xuất trước, chưa làm”.

Rủi ro thứ hai là dữ liệu. Nội dung file mà Claude đọc sẽ đi vào cuộc trò chuyện, tức là được gửi tới dịch vụ của Anthropic để xử lý. Nếu công ty bạn có quy định về dữ liệu nội bộ, hãy hỏi bộ phận phụ trách trước khi cấp thư mục thật.

Rủi ro thứ ba là độ tin cậy của chính server bạn cài. Một server do người lạ viết chạy ngay trên máy bạn, với quyền của bạn. Chỉ cài server từ nguồn bạn tin, đọc kỹ mô tả, và đừng chép nguyên cấu hình từ một bài đăng không rõ nguồn.

Cuối cùng là các giới hạn thực tế: cần cài Node, file JSON dễ gõ sai, cần khởi động lại app sau mỗi thay đổi, và dùng công cụ nhiều có thể làm cuộc trò chuyện tốn lượt dùng hơn thông thường, nhất là khi Claude đọc nhiều file. Một số định dạng file cũng có thể không đọc được.

### Khi nào nên chọn cách khác

Nếu bạn chỉ cần Claude xử lý vài file một lần, đính kèm trực tiếp vào chat là nhanh và an toàn hơn, không cần cấu hình gì. Nếu việc là đọc tài liệu có sẵn trên Drive hay mail, hãy xem Connectors trước, vì đó là kết nối dựng sẵn và dễ quản lý quyền. Nếu bạn cần tài liệu dùng lại nhiều lần theo một chủ đề, Projects hợp hơn.

Nếu việc thiên về lập trình, sửa nhiều file trong một dự án, chạy lệnh, thì Claude Code ở terminal (hoặc các công cụ như Cursor, GitHub Copilot) thường hợp hơn. Tập “Chọn Claude Desktop hay Claude Code CLI” trong series đi sâu phần này. Còn nếu công ty đã chuẩn hóa một công cụ AI khác như ChatGPT hay Gemini, bạn nên theo quy định chung thay vì tự dựng thêm một đường song song.

## Lỗi hay gặp và cách tránh

- **Lưu file rồi nhưng không thoát hẳn app.** Biểu hiện: Claude nói không có công cụ nào. Cách tránh: thoát từ biểu tượng ở khay hệ thống (hoặc thanh menu trên Mac) rồi mở lại, đừng chỉ đóng cửa sổ.
- **Quên viết đôi dấu gạch chéo ngược.** Biểu hiện: JSON báo lỗi hoặc server không thấy thư mục. Cách tránh: trên Windows, mỗi dấu \ trong đường một trang tin tức thành \\. Soát lại bằng một trình kiểm tra JSON.
- **Dán thêm khối mcpServers thứ hai.** Biểu hiện: server cũ biến mất hoặc file lỗi. Cách tránh: nếu file đã có mcpServers, chỉ thêm mục filesystem vào bên trong, nhớ dấu phẩy giữa các mục.
- **Chưa cài Node.js.** Biểu hiện: server không khởi động được dù cấu hình đúng. Cách tránh: cài Node kèm npm trước, rồi khởi động lại máy hoặc app nếu cần.
- **Cấp thư mục quá rộng ngay từ đầu.** Biểu hiện: Claude thấy cả những thứ bạn không muốn. Cách tránh: luôn bắt đầu bằng thư mục thử, chỉ mở rộng khi bạn đã hiểu rõ nó hoạt động ra sao.

## Dự phóng: MCP sẽ đi về đâu

Đây là nhận định của Ông T dựa trên hướng đi chung của các AI agent, không phải thông báo chính thức từ bất kỳ hãng nào.

**Cấu hình sẽ bớt thủ công hơn.** Mức chắc chắn: khả năng cao. Sửa file JSON bằng tay là rào cản lớn với người không quen kỹ thuật, nên các ứng dụng có xu hướng làm cách cài dễ hơn, kiểu bấm chọn thay vì gõ. Bạn nên chuẩn bị bằng cách hiểu khái niệm (server, phạm vi, quyền), vì dù giao diện đổi, các khái niệm này vẫn là gốc.

**Quản lý quyền sẽ chặt hơn.** Mức chắc chắn: khả năng cao. Khi AI có thể sửa file hay gọi dịch vụ, các tổ chức sẽ đòi kiểm soát rõ ai được cấp gì. Bạn nên tập thói quen cấp quyền vừa đủ và ghi lại mình đã cấp những gì.

**Nhiều công cụ nghiệp vụ sẽ có server riêng.** Mức chắc chắn: có thể. Việc nối AI với phần mềm kế toán, CRM, bán hàng là nhu cầu rõ, và một chuẩn chung giúp làm việc đó rẻ hơn. Nhưng chất lượng sẽ không đồng đều, nên bạn cần giữ thói quen kiểm tra nguồn trước khi cài.

**MCP trở thành chuẩn dùng chung giữa nhiều công cụ AI.** Mức chắc chắn: còn bỏ ngỏ. Một chuẩn chỉ thành chuẩn khi nhiều bên cùng dùng, và điều đó còn tùy vào cách thị trường phát triển. Lời khuyên: học cách làm việc với MCP để hiểu bản chất, nhưng đừng xây cả quy trình quan trọng chỉ dựa vào một cách cấu hình.

## Bắt đầu từ đâu

MCP nghe có vẻ kỹ thuật, nhưng ý tưởng rất đơn giản: cho Claude thêm một công cụ, trong một phạm vi bạn tự vạch ra. Hãy bắt đầu nhỏ, với một server và một thư mục thử, rồi mở rộng khi bạn thấy yên tâm. Ba việc bạn làm được ngay hôm nay:

1. Tạo thư mục thu-mcp với 3-4 file mẫu không nhạy cảm, và cài Node.js nếu máy chưa có.
2. Thêm mục filesystem vào file cấu hình, thoát hẳn Claude từ khay hệ thống, mở lại rồi nhờ Claude liệt kê file trong thư mục thử.
3. Thử một yêu cầu đọc và tóm tắt một file mẫu, sau đó đối chiếu với bản gốc để xem Claude đọc đúng đến đâu. Theo dõi Ông T để xem tập tiếp theo về dùng Claude đọc và tóm tắt file.

## Câu hỏi thường gặp

### MCP trong Claude Desktop là gì, nói ngắn gọn?

MCP (Model Context Protocol) là chuẩn chung giúp Claude kết nối với công cụ và dữ liệu bên ngoài thông qua các server nhỏ. Với server filesystem, Claude có thể liệt kê, đọc và sửa file trong thư mục bạn cấp. Bạn cấu hình bằng một file JSON, không cần viết code.

### File cấu hình của Claude Desktop nằm ở đâu?

Trên Windows, file claude_desktop_config.json thường nằm trong %APPDATA%\Claude. Trên Mac, nó nằm trong thư mục Application Support, mục Claude. Nếu app có mục cài đặt cho nhà phát triển với nút mở file thì dùng cũng được, nhưng vị trí nút có thể khác theo bản app.

### Tại sao tôi sửa file cấu hình rồi mà Claude vẫn không thấy server?

Nguyên nhân phổ biến nhất là chưa thoát hẳn app. Đóng cửa sổ thường chỉ thu nhỏ xuống khay hệ thống, bạn cần thoát từ biểu tượng ở khay rồi mở lại. Các nguyên nhân khác gồm JSON gõ sai, chưa viết đôi dấu gạch chéo ngược trên Windows, hoặc chưa cài Node.js.

### Làm sao biết server filesystem đã chạy thật?

Mở cuộc trò chuyện mới và nhờ Claude liệt kê file trong thư mục thử. Nếu công cụ list_directory được gọi và trả về danh sách khớp với thư mục bạn đã cấp thì server đã chạy. Nếu Claude báo không có công cụ hoặc trả sai thư mục thì cần kiểm tra lại cấu hình.

### Cấp quyền cho server filesystem có an toàn không?

An toàn ở mức bạn kiểm soát được phạm vi. Server có thể sửa và ghi file trong thư mục được cấp, và nội dung file Claude đọc sẽ đi vào cuộc trò chuyện. Hãy bắt đầu với thư mục thử, làm trên bản sao và không cấp thư mục chứa dữ liệu nhạy cảm.

### Tôi không rành kỹ thuật, có nên dùng MCP không?

Nếu chỉ cần xử lý vài file một lần, đính kèm trực tiếp vào chat hoặc dùng Connectors và Projects sẽ đơn giản hơn. MCP đáng thử khi bạn muốn Claude làm việc lặp lại với file trên máy. Nếu ngại sửa JSON, hãy nhờ người quen kỹ thuật làm cùng lần đầu.

### Cấu hình MCP có tốn thêm lượt dùng không?

Mình không có số liệu cụ thể, và hạn mức thay đổi theo gói. Nhìn chung khi Claude đọc nhiều file hoặc gọi công cụ nhiều lần thì cuộc trò chuyện dài hơn và có thể tiêu tốn lượt dùng nhanh hơn. Hãy bắt đầu bằng yêu cầu nhỏ và theo dõi mức tiêu hao của gói bạn đang dùng.
