GramClaw открывает один и тот же движок Telegram двумя способами: REST API для собственной автоматизации и удалённый MCP-сервер (Model Context Protocol) для ИИ-агентов. Оба аутентифицируются через API-ключ, который вы создаёте в Настройках, оба соблюдают одну и ту же дозировку по каждому аккаунту, которая поддерживает здоровье ваших аккаунтов Telegram, и оба требуют активной подписки или пробного периода.
На практике: REST API — для кода: синхронизируйте контакты из вашего продукта, запускайте кампанию, когда пользователь регистрируется, направляйте диалоги в ваше хранилище данных. MCP-сервер — для агентов: Claude Desktop, Claude Code, Cursor или ваш собственный агент получает инструменты, чтобы получать список чатов, читать сообщения, отправлять ответы, запускать массовые рассылки и управлять воронкой — без единой строки кода.
Создайте API-ключ
- 1
Откройте Настройки → API-ключи
Сгенерируйте ключ и выберите его области доступа — read для получения списков и чтения данных, send для всего, что записывает или отправляет сообщения. Ограничивайте ключи минимумом, который им нужен.
- 2
Скопируйте его один раз
Полный ключ (gc_live_…) показывается только при создании — храните его в менеджере секретов. Если он утечёт, удалите его в Настройках, и он немедленно перестанет работать.
- 3
Аутентифицируйтесь
REST: отправляйте его как заголовок Authorization: Bearer. MCP: помещайте его в URL сервера как параметр key.
REST API за одну минуту
API охватывает поверхность платформы: аккаунты, чаты, сообщения, контакты, кампании, массовые рассылки, колонки воронки и аналитику. Запросы — это обычный JSON поверх HTTPS. Полная документация по эндпоинтам — каждый маршрут, его области доступа и примеры запросов/ответов — находится на странице документации API, а машиночитаемая спецификация OpenAPI доступна по адресу /openapi.json для генерации кода или для передачи LLM.
Подключите MCP-сервер
- 1
Скопируйте URL сервера
https://gramclaw.com/api/mcp?key=gc_live_… — ключ одновременно идентифицирует и авторизует вас, ограничен аккаунтами, с которыми ему разрешено действовать.
- 2
Добавьте его в свой MCP-клиент
Claude Desktop, Claude Code, Cursor или любой совместимый с MCP клиент принимает URL удалённого сервера. Без локальной установки, без прокси.
- 3
Просите настоящую работу
После подключения ваш агент может искать по чатам, составлять и отправлять ответы, запускать кампании, проверять статус кампаний и продвигать сделки по воронке — при этом каждая отправка подчиняется той же дозировке по аккаунтам, что и остальная часть GramClaw.
Хорошие практики
- Один ключ на интеграцию, названный соответственно, чтобы отзыв одной вещи никогда не ломал другую.
- Предпочитайте области доступа только для чтения для дашбордов и аналитических задач.
- Ротируйте ключи, когда коллеги уходят, и удаляйте ключи, которые вы больше не используете — отзыв мгновенный.
- Помните, что отправки через API и MCP — это настоящие сообщения Telegram с ваших настоящих аккаунтов: те же требования к согласию и здравому смыслу по объёму, что и в приложении.