~/tools / MCP Config Checker
MCP Config Checker — Kiểm tra lỗi trong tệp cấu hình MCP
Kiểm tra tệp cấu hình máy chủ MCP (.mcp.json hoặc claude_desktop_config.json) để tìm lỗi: thiếu type, sai khóa cấp cao nhất, tên bị dành riêng hoặc không hợp lệ, đường dẫn tương đối, biến chưa được đặt và bí mật bị ghi thẳng vào tệp. Không có gì rời khỏi trình duyệt của bạn.
Các quy tắc được đối chiếu với tài liệu vào ngày 2026-10-23.
Tài liệu: Claude Code / Model Context Protocol / VS Code
Không được kiểm tra: một lệnh có tồn tại hay không, một gói có cài được hay không, một máy chủ từ xa có phản hồi hay không, và các thiết lập mà ứng dụng khác đọc theo cách khác.
Mọi thứ chạy trong trình duyệt của bạn. Cấu hình không được tải lên.
Máy chủ MCP được thiết lập trong một tệp JSON, và một lỗi nhỏ cũng có thể khiến máy chủ lặng lẽ không xuất hiện. Một mục máy chủ có url nhưng không có type sẽ bị bỏ qua, tệp dùng khóa servers của VS Code sẽ không được Claude Code hay Claude Desktop đọc, và một biến môi trường chưa được đặt sẽ được truyền đi dưới dạng văn bản thuần. Công cụ này đọc cấu hình bạn dán vào và liệt kê những gì tài liệu cho biết sẽ không hoạt động, những gì đáng kiểm tra và những gì chỉ là ghi chú. Công cụ cũng cảnh báo khi có vẻ một token được ghi thẳng vào tệp, nơi nó có thể bị đưa vào hệ thống quản lý phiên bản. Các quy tắc lấy từ tài liệu của Claude Code, Model Context Protocol và VS Code, được kiểm tra vào ngày hiển thị bên dưới công cụ.
Trường hợp dùng
- Tìm hiểu vì sao một máy chủ MCP không xuất hiện sau khi bạn sửa .mcp.json hoặc claude_desktop_config.json
- Kiểm tra một cấu hình bạn sao chép từ README trước khi thêm vào dự án dùng chung
- Phát hiện token và mật khẩu bị ghi vào tệp cấu hình trước khi commit
Cách dùng
- Dán nội dung tệp cấu hình MCP của bạn, hoặc tải ví dụ.
- Xem các máy chủ tìm thấy và loại của từng máy chủ, rồi đến danh sách kết quả. Sửa nghĩa là tài liệu cho biết mục đó sẽ không hoạt động, Kiểm tra nghĩa là đáng xem lại, và Ghi chú chỉ để cung cấp thông tin.
- Chỉnh sửa tệp, dán lại, rồi khởi động lại ứng dụng đọc tệp đó.
Hỏi đáp
Công cụ bao gồm những tệp và ứng dụng nào?
Định dạng mcpServers được dùng trong tệp dự án .mcp.json của Claude Code và trong claude_desktop_config.json của Claude Desktop. Các ứng dụng khác có thể đọc những trường khác hoặc một khóa cấp cao nhất khác, nên hãy xem tài liệu riêng của chúng. Ví dụ, VS Code dùng khóa cấp cao nhất có tên servers.
Mục của tôi có url nhưng không có type. Vì sao đó là vấn đề?
Claude Code đọc một mục không có type như một máy chủ stdio, vì vậy mục có url nhưng không có type là lỗi cấu hình và máy chủ sẽ bị bỏ qua. Hãy thêm type là http, sse hoặc ws.
Điều gì xảy ra với một biến như ${API_KEY} chưa được đặt?
Claude Code mở rộng ${VAR} và ${VAR:-default} trong command, args, env, url và headers. Nếu một biến chưa được đặt và không có giá trị mặc định, cấu hình vẫn được tải, Claude Code hiển thị cảnh báo và dùng nguyên văn bản ${VAR}. Hãy thêm giá trị mặc định bằng ${VAR:-default} khi điều đó an toàn.
Vì sao công cụ cảnh báo về token trong tệp?
Token ghi trực tiếp vào tệp cấu hình có thể bị chia sẻ khi tệp được commit hoặc gửi cho người khác. Phép kiểm tra này là heuristic dựa trên các định dạng token đã biết và các tên như api-key, token và password, nên có thể bỏ sót một bí mật hoặc đánh dấu nhầm một giá trị vô hại. Dùng ${VAR} sẽ giữ giá trị đó ngoài tệp.
Công cụ có khởi động máy chủ hoặc thử kết nối không?
Không. Công cụ chỉ đọc văn bản. Nó không thể biết một lệnh có tồn tại hay không, một gói có cài được hay không, hoặc một máy chủ từ xa có truy cập được hay không, nên hãy thử máy chủ trong ứng dụng sau khi tệp đã qua kiểm tra.
Cấu hình của tôi có được gửi đến máy chủ không?
Không. Việc kiểm tra chạy trong trình duyệt của bạn.