whatsapp-chatgpt-mcp
WhatsApp → ChatGPT (через MCP)
Подключает WhatsApp к ChatGPT: каждый клиент/агентство становится Проектом в ChatGPT, с ежедневным отчётом (через Запланированные) и свободными вопросами о переписках. Стоимость — ноль: всё с открытым исходным кодом / self-hosted.
WhatsApp ←QR code→ Evolution API ←→ servidor MCP ←→ ChatGPT (Modo de desenvolvedor)
↓
Postgres (sessão + mensagens)Структура
Файл | Описание |
| Полная установка одной командой на VPS (Postgres + Evolution + MCP + HTTPS) |
| Переменные для заполнения (пароли, номер инстанса, список блокировки, домен) |
| Коннектор, к которому обращается ChatGPT (Node, 4 инструмента: список чатов, поиск контакта, сообщения из чата, последние сообщения) |
| План Б: деплой на Render free + бесплатный внешний Postgres, если нет VPS |
Related MCP server: WhatsApp MCP Server (TypeScript)
План развёртывания
1. Инфраструктура (~15 мин, на VPS Ubuntu с Docker)
git clone https://github.com/rafaelacoelhob/whatsapp-chatgpt-mcp.git
cd whatsapp-chatgpt-mcp
cp .env.example .env
nano .env # preencher senhas e domínio (instruções no próprio arquivo)
docker compose up -dТребование: домен/поддомен, указывающий на IP VPS (A-запись) — Caddy сам выдаёт HTTPS-сертификат.
2. Подключение WhatsApp (2 мин, один раз)
Откройте панель Evolution:
http://<servidor>:8080/manager(логин =EVOLUTION_API_KEY)Создайте инстанс с именем, указанным в
EVOLUTION_INSTANCE(интеграция: Baileys)На телефоне: WhatsApp → Настройки → Связанные устройства → Подключить устройство → отсканируйте QR-код
Сначала протестируйте на СВОЁМ номере; затем повторите с постоянным номером (изменив
EVOLUTION_INSTANCEили создав другой инстанс).
3. Подключение к ChatGPT (3 мин)
ChatGPT → Настройки → Плагины → Режим разработчика → создать коннектор
URL:
https://<dominio-do-mcp>/mcp/<MCP_PATH_SECRET>Проверьте в чате: «Перечисли мои последние чаты WhatsApp» и «Резюмируй сообщения, которые я получил сегодня»
4. Проекты для каждого агентства (2 мин на каждый)
Создайте Проект в ChatGPT для каждого агентства с этими инструкциями (адаптируйте):
Você acompanha as conversas da AGÊNCIA X no meu WhatsApp (use as
ferramentas do conector WhatsApp).
Contatos conhecidos da agência:
- Fulana — +55 11 9XXXX-XXXX
- Grupo "Agência X"
Contatos novos: se uma conversa de número desconhecido claramente for
desta agência, inclua no relatório na seção "🆕 Contato novo — confirmar".
Só trate como contato fixo depois que eu confirmar.
Relatório do dia — quando eu pedir, busque as mensagens de hoje e
organize em: 📌 Decisões / ⏳ Pendências / 📅 Prazos / ❗ Precisa de
resposta / 🆕 Contatos novos.
Responda sempre em português, direto. Se a informação não estiver nas
conversas, diga que não está — não invente.5. Автоматический ежедневный отчёт
ChatGPT → Запланированные → новая задача: «Каждый день в 18:00 ищи в WhatsApp сообщения за сегодня от [агентство/контакты] и формируй отчёт за день в формате Решения / Открытые вопросы / Сроки / Требует ответа / Новые контакты.» (Business: до 15 активных задач; свыше этого — используйте одну задачу, охватывающую все агентства.)
Список запрещённых номеров
BLOCKED_NUMBERS в .env (с кодом страны, через запятую). Это технический фильтр на сервере: переписки с этих номеров никогда не передаются в ChatGPT, что бы ни попросили. Изменили .env → снова docker compose up -d, чтобы применить.
Обслуживание (что может произойти)
Сессия WhatsApp упала (редко): повторно отсканируйте QR-код в панели Evolution (шаг 2).
Сервер перезагрузился: контейнеры поднимутся сами (
restart: always); сессия сохраняется (хранится в Postgres).Полное отключение: на телефоне — Связанные устройства → завершить сессию;
docker compose down; удалите коннектор в ChatGPT.
Предупреждения
Evolution использует мост в стиле WhatsApp Web — это не официальный продукт Meta. Риск бана при чтении низкий, но не нулевой; владелец номера должен быть в курсе.
Переписки проходят через сервер и OpenAI (стандартная работа ChatGPT).
This server cannot be deployed
Maintenance
Related MCP Connectors
Read, search and reply to your WhatsApp chats from your AI, using your own number.
- WhatSyncOAuthapp.whatsync
WhatsApp for Claude, ChatGPT or any AI agent: search, reply and send. Personal or Business API.
Your own WhatsApp in Claude and ChatGPT: read chats, draft replies, send messages you approve.
WhatsApp CRM for AI agents: search contacts, read chats, manage the sales pipeline, send messages.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to interact with your personal WhatsApp account, allowing them to search messages and contacts, retrieve chat history, and send messages to individuals or groups. Uses WhatsApp Web API with local data storage for privacy and security.11 npmISC
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to interact with your personal WhatsApp account to search messages, list chats, and send messages. It stores all authentication and message data locally using SQLite for privacy and direct multi-device API connection.11 npm1ISC
- AlicenseBqualityBmaintenanceBridges the WhatsApp HTTP API with AI assistants to enable full control over messaging, chat management, and interactive workflows through 63 specialized tools. It allows users to automate WhatsApp tasks and receive real-time AI feedback directly on their mobile devices.635 npm6MIT
- AlicenseNot gradedqualityBmaintenanceA self-hosted WhatsApp bridge that exposes a stdio MCP server with ~20 tools for reading conversations, sending messages, managing groups, contacts, and aliases, enabling AI agents to operate WhatsApp directly.4MIT