Pachca MCP Server

MCP сервер для интеграции Пачки с Cursor IDE и другими MCP-совместимыми инструментами.

Возможности

• 📤 Отправка сообщений — в личку или групповой чат (с подтверждением)
• 📬 Чтение сообщений — с фильтрами по чату, отправителю, пагинацией
• 📋 Список чатов — с фильтрацией по типу и дате
• 📇 Справочник контактов — автоматическое запоминание имён
• 🔄 Синхронизация — обновление контактов из чатов бота

Быстрый старт

1. Создай бота в Пачке

1. Открой Пачку → Автоматизации → Интеграции → Webhook
2. Нажми "+" для создания нового бота
3. В разделе "API" скопируй токен
4. Отметь бота как публичный

2. Добавь в Cursor

Создай или отредактируй файл .cursor/mcp.json:

{
  "mcpServers": {
    "pachca": {
      "command": "npx",
      "args": ["-y", "pachca-mcp"],
      "env": {
        "PACHCA_BOT_TOKEN": "твой_токен_бота",
        "PACHCA_BOT_ID": "id_пользователя_бота",
        "PACHCA_DEFAULT_USER_ID": "твой_user_id"
      }
    }
  }
}

3. Перезапусти Cursor

Переменные окружения

| Переменная | Обязательно | Описание | |------------|-------------|----------| | PACHCA_BOT_TOKEN | ✅ | Токен бота из настроек интеграции | | PACHCA_BOT_ID | ❌ | ID пользователя бота (для фильтрации его сообщений) | | PACHCA_DEFAULT_USER_ID | ❌ | ID получателя по умолчанию |

Использование

Отправка сообщений

"Напиши в пачку: Привет!"
"Напиши Ване: Как дела?"
"Напиши в B2B Tech: Всем привет"

Перед отправкой покажет превью и спросит подтверждение

Чтение сообщений

"Покажи новые сообщения"
"Покажи сообщения от Вани"
"Покажи сообщения из B2B Tech"
"Покажи 20 последних сообщений, страница 2"

Чаты и контакты

"Покажи чаты бота"
"Покажи только личные чаты"
"Покажи контакты"
"Обнови контакты"

Доступные команды (tools)

| Команда | Описание | |---------|----------| | pachca_send_message | Отправить сообщение | | pachca_get_new_messages | Получить сообщения | | pachca_list_chats | Список чатов бота | | pachca_list_contacts | Показать справочник контактов | | pachca_sync_contacts | Обновить контакты из чатов |

Параметры команд

pachca_send_message

| Параметр | Тип | Описание | |----------|-----|----------| | content | string | Текст сообщения (поддерживает Markdown) | | to | string | Имя получателя или чата | | entity_id | string | ID получателя (приоритетнее to) | | entity_type | "user" | "discussion" | Тип: личка или группа | | confirmed | boolean | Пропустить подтверждение |

pachca_get_new_messages

| Параметр | Тип | Описание | |----------|-----|----------| | chat_id | string | ID чата | | chat_name | string | Название чата или имя собеседника | | from | string | Фильтр по отправителю | | limit | number | Количество сообщений (макс. 50) | | page | number | Страница для пагинации | | include_bot | boolean | Включить сообщения от бота | | sort | "asc" | "desc" | Сортировка по дате |

pachca_list_chats

| Параметр | Тип | Описание | |----------|-----|----------| | personal | boolean | Фильтр: только личные/групповые | | limit | number | Количество чатов (макс. 50) | | last_message_after | string | Чаты с сообщениями после даты | | last_message_before | string | Чаты с сообщениями до даты | | sort | "asc" | "desc" | Сортировка |

Лицензия

MIT