Hãy tưởng tượng bạn có thể tự động hóa các tương tác trên WhatsApp, phân tích các cuộc hội thoại và thậm chí tích hợp các trợ lý AI trực tiếp vào quy trình nhắn tin của bạn. Nghe có vẻ giống như một bộ phim khoa học viễn tưởng, phải không? Nhưng thực ra, nó gần hơn bạn nghĩ! Chào mừng đến với WhatsApp MCP, nơi Giao thức Ngữ cảnh Mô hình (MCP) kết nối WhatsApp với các công cụ AI như Claude và Cursor. Điều này mở ra một thế giới cơ hội cho việc tự động hóa nhắn tin của bạn và tích hợp AI vào giao tiếp hàng ngày của bạn.

Hướng dẫn này sẽ dẫn bạn qua quá trình thiết lập và thành thạo sự tích hợp mạnh mẽ này. Chúng ta sẽ đi từng bước một, vì vậy đừng lo lắng nếu bạn mới với loại công nghệ này. Hãy cùng bắt đầu!

Bằng cách hoạt động như một cầu nối giữa các dự án Apidog của bạn và Cursor, Apidog MCP Server đảm bảo rằng trợ lý AI của bạn có quyền truy cập vào các thiết kế API mới nhất, bổ sung cho tính năng Ngân hàng Bộ nhớ bằng cách cung cấp thông tin API có cấu trúc mà Cursor có thể tham chiếu trong quá trình phát triển. Để tìm hiểu thêm về Apidog MCP Server, hãy tham khảo tài liệu chính thức hoặc ghé thăm trang NPM. Hơn nữa, hãy cân nhắc việc khám phá Apidog - một giải pháp tích hợp, mạnh mẽ và chi phí hiệu quả thay thế cho Postman.
Các yêu cầu cần thiết
Trước khi bắt đầu, hãy đảm bảo bạn có tất cả những gì bạn cần. Điều này có thể có vẻ nhiều, nhưng đừng lo lắng! Chỉ cần làm theo hướng dẫn, và bạn sẽ ổn.
1. Một tài khoản WhatsApp: Rõ ràng, bạn sẽ cần một tài khoản WhatsApp để sử dụng điều này.
2. Tài khoản GitHub: Bạn sẽ cần một tài khoản GitHub để nhân bản kho lưu trữ. Nếu bạn chưa có, hãy tạo một tài khoản miễn phí tại GitHub.
3. Ứng dụng Claude Desktop: Để theo dõi hướng dẫn này, bạn cần cài đặt và thiết lập Ứng dụng Claude Desktop.
4. Kiến thức cơ bản về dòng lệnh: Bạn nên cảm thấy thoải mái khi mở terminal (hoặc command prompt) và chạy các lệnh cơ bản.
5. Git: Git được sử dụng để nhân bản kho lưu trữ. Hãy đảm bảo bạn đã cài đặt Git trên hệ thống của mình. Bạn có thể tải xuống từ Git-SCM.
6. Go: Chúng tôi sẽ sử dụng Go để chạy một tệp. Hướng dẫn cài đặt có thể được tìm thấy tại Tải Go.
7. Python: Công cụ này cần Python. Một liên kết để tải xuống có thể được tìm thấy tại Tải Python.
8. Trình quản lý gói uv: Để cài đặt trình quản lý gói uv
, hãy làm theo hướng dẫn được cung cấp trong hướng dẫn cài đặt sắp tới.
Phần 1: Hiểu về WhatsApp MCP
WhatsApp MCP chính xác là gì?
WhatsApp MCP là một dự án mã nguồn mở hoạt động như một cầu nối giữa WhatsApp Web và các mô hình AI thông qua Giao thức Ngữ cảnh Mô hình (MCP). Nói đơn giản, nó cho phép các mô hình AI như Claude và Cursor "nói" với WhatsApp và thực hiện các hành động một cách lập trình.
Hãy nghĩ về nó như thế này: WhatsApp là một ngôn ngữ, MCP là người phiên dịch, và các mô hình AI là những người nói. WhatsApp MCP cho phép AI "nói" WhatsApp và tương tác với các tin nhắn của bạn theo cách hoàn toàn mới.
Các thành phần chính của WhatsApp MCP
Máy chủ API WhatsApp: Thành phần này kết nối với WhatsApp Web và cung cấp cách để các mô hình AI tương tác với WhatsApp thông qua một tập hợp các lệnh (REST endpoints). Đây là "miệng" của AI.
Máy chủ MCP: Thành phần này triển khai Giao thức Ngữ cảnh Mô hình, cho phép giao tiếp và phối hợp giữa các mô hình AI và Máy chủ API WhatsApp. Đây là "não" hướng dẫn "miệng" nên nói gì và làm gì.
Phần 2: Thiết lập WhatsApp MCP
Được rồi, giờ là phần thú vị! Hãy khởi động Máy chủ WhatsApp MCP.
Bước 1: Nhân bản kho lưu trữ
Đầu tiên, chúng ta cần lấy mã cho WhatsApp MCP. Mở terminal của bạn và chạy lệnh sau:
git clone https://github.com/lharries/whatsapp-mcp
cd whatsapp-mcp
Điều này sẽ tải xuống mã từ GitHub và đặt nó vào một thư mục có tên là whatsapp-mcp
trên máy tính của bạn. Lệnh cd whatsapp-mcp
sau đó chuyển bạn vào thư mục đó.
Bước 2: Tải và cài đặt Go
Hãy chắc chắn rằng bạn đã cài đặt Go trên máy tính của mình. Vui lòng truy cập Tải Go để tải và cài đặt Go.

Bước 3: Tải và cài đặt Python
Hãy chắc chắn rằng bạn đã cài đặt Python trên máy tính của mình. Vui lòng truy cập Tải Python để tải và cài đặt Python.

Bước 4: Cài đặt trình quản lý gói uv
Hãy chắc chắn rằng bạn đã cài đặt uv trên máy tính của mình. Để cài đặt nó, bạn có thể chạy lệnh sau trong terminal.
pip install uv
Bước 5: Chạy Bridge WhatsApp
Chúng ta sẽ bắt đầu phần "whatsapp-bridge", đây là tệp Go.
cd whatsapp-bridge
go run main.go
Nếu thành công, nó sẽ thông báo như sau:
2025/03/30 13:55:15 Máy chủ lắng nghe trên cổng 8001
Bước 6: Tích hợp với Claude Desktop
Đây là nơi chúng ta kết nối WhatsApp MCP với Claude.
- Mở Claude Desktop và vào Cài đặt.
- Chọn Nhà phát triển và nhấp vào nút cài đặt để mở tệp claude_desktop_config.json.
Thêm cấu hình sau vào tệp claude_desktop_config.json:
{
"mcpServers": {
"whatsapp": {
"command": "{{PATH}}/.local/bin/uv", // Chạy `which uv` và đặt đầu ra ở đây
"args": [
"--directory",
"{{PATH}}/whatsapp-mcp/whatsapp-mcp-server", // cd vào repo, chạy `pwd` và nhập đầu ra ở đây + "/whatsapp-mcp-server"
"run",
"main.py"
]
}
}
}
Ghi chú quan trọng:
- command: Bạn cần thay thế "{{PATH}}/.local/bin/uv" bằng đường dẫn thực tế đến tệp thực thi uv trên hệ thống của bạn. Để tìm đường dẫn này, chạy lệnh
which uv
trong terminal của bạn và dán đầu ra ở đây. - args: Bạn cần thay thế "{{PATH}}/whatsapp-mcp/whatsapp-mcp-server" bằng đường dẫn đầy đủ đến thư mục whatsapp-mcp-server trên hệ thống của bạn. Để tìm đường dẫn này:
cd
vào thư mụcwhatsapp-mcp
mà bạn đã nhân bản trước đó.- Chạy lệnh
pwd
trong terminal của bạn. Điều này sẽ in ra đường dẫn đầy đủ đến thư mục đó. - Thêm
/whatsapp-mcp-server
vào cuối đường dẫn đó. - Dán kết quả vào phần "args".
Bước 7: Khởi động lại Cursor
Đóng hoàn toàn Cursor. Đảm bảo đóng từ trình quản lý tác vụ (hoặc monitor hoạt động trên Mac) để đảm bảo nó được tắt hoàn toàn. Sau đó, khởi động lại Cursor.
Phần 3: Sử dụng WhatsApp MCP
Bây giờ bạn đã thiết lập mọi thứ đúng cách, hãy khám phá một số cách bạn có thể sử dụng WhatsApp MCP.
Trường hợp sử dụng 1: Gửi tin nhắn tự động
Bạn có thể cấu hình Claude (hoặc các mô hình AI khác) để gửi tin nhắn thay bạn. Ví dụ:
/ask "Gửi một tin nhắn đến John Doe trên WhatsApp: 'Xin chào, bạn khỏe không?'"

Đằng sau những cảnh:
Claude kích hoạt máy chủ WhatsApp MCP.
Máy chủ sử dụng API WhatsApp để gửi tin nhắn.
Trường hợp sử dụng 2: Phân tích cuộc hội thoại
Bạn có thể sử dụng Claude để phân tích các cuộc hội thoại trên WhatsApp của bạn. Ví dụ:
/ask "Phân tích cuộc trò chuyện cuối cùng với Jane trên WhatsApp"
Claude sẽ xử lý cuộc trò chuyện bằng cách sử dụng các mô hình AI và trả về các thông tin chi tiết, chẳng hạn như phân tích cảm xúc, chiết xuất chủ đề và các chủ đề chính.

Phần 4: Các tính năng nâng cao và bảo mật
Quản lý phiên WhatsApp
WhatsApp MCP cho phép bạn quản lý nhiều phiên WhatsApp một cách lập trình. Điều này bao gồm việc tạo và quản lý nhóm, gửi tệp và truy xuất lịch sử trò chuyện. Đây là những trường hợp sử dụng nâng cao hơn đòi hỏi bạn phải tìm hiểu thêm về API WhatsApp và tài liệu MCP.
Các thực hành bảo mật tốt nhất
Bảo mật là vô cùng quan trọng khi làm việc với dữ liệu nhắn tin cá nhân. Dưới đây là một số thực hành tốt quan trọng:
- Đồng ý của người dùng: Luôn nhận sự đồng ý rõ ràng từ người dùng trước khi truy cập vào dữ liệu WhatsApp của họ. Sự minh bạch là chìa khóa.
- Bảo mật dữ liệu: Bảo vệ dữ liệu của người dùng với các kiểm soát truy cập hợp lý và mã hóa. Tuân thủ các quy định về bảo mật dữ liệu như GDPR và CCPA.
- An toàn công cụ: Đối xử với các công cụ một cách cẩn thận vì chúng đại diện cho việc thực thi mã tùy ý. Hiểu rõ các rủi ro liên quan trước khi chạy bất kỳ mã nào.
Phần 5: Khắc phục sự cố và các câu hỏi thường gặp
Phần này bao gồm các vấn đề phổ biến và giải pháp cho chúng:
- "Tôi không nhận được tin nhắn." (Kiểm tra khóa API, trạng thái máy chủ, kết nối mạng)
- "Claude không phản hồi các lệnh của tôi." (Xác minh cấu hình MCP, kiểm tra cài đặt của Claude)
- "Tài khoản WhatsApp của tôi bị chặn." (Tránh gửi spam hoặc vi phạm điều khoản dịch vụ của WhatsApp)
Suy nghĩ cuối cùng
Bây giờ bạn đã thiết lập và kiểm tra thành công WhatsApp MCP, mở ra cánh cửa đến một thế giới nhắn tin tự động và được nâng cao bởi AI. Từ việc tự động hóa các nhiệm vụ tẻ nhạt đến việc thu được thông tin quý giá từ các cuộc hội thoại của bạn, WhatsApp MCP cho phép bạn tận dụng sức mạnh của AI trong giao tiếp hàng ngày của bạn. Đây chỉ là khởi đầu! Hãy thử nghiệm với các mô hình AI khác nhau, khám phá khả năng của API WhatsApp và tạo ra các quy trình tùy chỉnh để thực sự cá nhân hóa trải nghiệm nhắn tin của bạn. Hãy đón chào tương lai của giao tiếp với WhatsApp MCP!
