Cách Sử Dụng Máy Chủ WhatsApp MCP

中村 拓也

中村 拓也

1 tháng 4 2025

Cách Sử Dụng Máy Chủ WhatsApp MCP

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ình ảnh whatsapp

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!

💡
Tích hợp Apidog MCP Server vào IDE được hỗ trợ AI của bạn nâng cao khả năng lập trình của bạn bằng cách cho phép truy cập trực tiếp vào các thông số API từ các dự án Apidog. Sự tích hợp này cho phép trợ lý AI của bạn tạo ra hoặc chỉnh sửa mã dựa trên các thông số API của bạn, tìm kiếm qua tài liệu API, tạo các mô hình dữ liệu và DTO phù hợp với thiết kế API của bạn, và thêm các chú thích cũng như tài liệu liên quan.
apidog mcp

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.

button

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.

hình ảnh cài đặt golang

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.

hình ảnh 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.

  1. Mở Claude Desktop và vào Cài đặt.
  2. 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:

  1. 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.
  2. 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:

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?'"
kết quả ví dụ 1

Đằ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.

kết quả ví dụ 2

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:

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:

  1. "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)
  2. "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)
  3. "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!

Hình ảnh Apidog Ui
button

Thực hành thiết kế API trong Apidog

Khám phá cách dễ dàng hơn để xây dựng và sử dụng API