MCP-коннектор: как подключить нейросеть к сервису
MCP-коннектор MSG.Center: 28 инструментов для нейросетей, токены mcpc_, политика подтверждений и безопасность.
MCP-коннектор: как подключить нейросеть к сервису
Обычный сценарий работы с нейросетью выглядит так: вы копируете задачу в чат, получаете текст, копируете обратно в сервис публикаций. Три копирования на одну публикацию, и каждое — шанс потерять часть текста или перепутать канал.
MCP (Model Context Protocol) убирает этот круг. Нейросеть подключается к сервису как к источнику данных и инструментов: сама смотрит список каналов, проверяет расписание, готовит черновик и — если разрешено — ставит публикацию в календарь. Один endpoint, один токен, понятные правила.
Что даёт MCP по сравнению с API
| Developer API | MCP-коннектор | |
|---|---|---|
| Кто вызывает | ваша система | нейросеть-клиент |
| Формат | REST, JSON | JSON-RPC 2.0 поверх Streamable HTTP |
| Аутентификация | ключи Developer API | отдельные токены mcpc_… |
| Инструменты | 3 endpoint'а | 28 инструментов с описанием схем |
| Подтверждения | нет | dry_run и confirm |
Ключевое отличие — в правах и подтверждениях. MCP-токен создаётся под конкретную задачу: только чтение, чтение и черновики, публикация с подтверждением. Отзыв токена не ломает интеграции с CRM и сайтом.
Какие инструменты доступны
28 инструментов сгруппированы по задачам:
| Группа | Что можно | Права |
|---|---|---|
| Профиль | узнать рабочее пространство, лимиты, список инструментов | mcp:read |
| Каналы | посмотреть сети, подключённые аккаунты | mcp:read |
| Публикации | создать, посмотреть, отменить, повторить | posts:write, posts:publish |
| Аналитика | сводка, метрики публикаций, лучшее время | mcp:read |
| Инбокс | беседы, сообщения, назначение, статусы, теги, AI-черновик | inbox:* |
| Автоматизации | список сценариев, история запусков, запуск | automation:read, automation:run |
| AI | подписи под площадки, ответы для инбокса | ai:generate |
| Медиа | библиотека, проверка и импорт ссылки | mcp:read, media:write |
| Тарифы | текущий тариф и каталог | mcp:read |
Инструменты появляются не все сразу: если в сборке нет инбокса, соответствующие вызовы просто не показываются. Это честнее, чем ошибка «метод не найден» на каждом шаге.
Токены и права
Токен создаётся в разделе MCP-коннектора: имя, набор прав, срок действия. Значение показывается один раз — сохраните его в менеджере секретов.
Практические правила:
- начинайте с
mcp:readи только потом добавляйте запись; - не выдавайте
posts:publishклиенту, который должен лишь готовить черновики; - задайте срок действия и пересоздавайте токен при смене подрядчика;
- отзывайте токен сразу, если доступ больше не нужен.
Лимит по умолчанию — 120 запросов в минуту на токен. Для одного человека и одной нейросети этого достаточно с запасом.
Пошагово: подключить Claude или Cursor
- Откройте раздел MCP-коннектора и создайте токен с правами
mcp:read. - Скопируйте значение токена.
- В клиенте укажите endpoint
https://msg.center/mcpи заголовокAuthorization: Bearer <токен>. - Перезапустите клиент и проверьте, что сервер отображается как подключённый.
- Попросите модель вызвать
me— она покажет рабочее пространство и доступные возможности. - Попросите вызвать
channels.listиaccounts.list. - Создайте второй токен с
posts:writeи попробуйтеposts.createсdry_run: true. - Убедитесь, что вернулся предпросмотр, а публикация не создана.
- Только после этого разрешите запись без
dry_run.
Для клиентов, которые умеют только запускать процесс (stdio), есть мост на Node.js: он принимает JSON-RPC на stdin и пересылает его в /mcp. Это тот же протокол, просто другой транспорт.
Подтверждения: dry_run и confirm
Логика простая и предсказуемая:
dry_run: true— проверка без записи. Валидируются аргументы, каналы, время, медиа; возвращается предпросмотр.confirm: true— обязательное подтверждение для опасных операций: публикация, отмена, повтор, отправка сообщения, назначение, запуск сценария.- Без
confirmтакой вызов выполняется как проверка и возвращаетconfirmation_required— ничего не меняется.
Это защита от самой частой проблемы автономных агентов: «модель решила, что публикация готова». Человек подтверждает действие, а не переписывает заново.
Безопасность
- Токены хранятся в виде хеша, в интерфейсе виден только префикс.
- Каждый вызов пишется в журнал: инструмент, результат, длительность, хеш аргументов, IP. Сами аргументы не сохраняются.
- Токен привязан к рабочему пространству: чужие идентификаторы возвращают
not_found. - Медиа отдаются по короткоживущим подписанным ссылкам.
- Есть ограничения на размер аргументов и размер страницы, чтобы один запрос не «съел» память.
Что пока не поддерживается
- OAuth-поток для коннекторов ChatGPT — используется путь через API с заголовком авторизации.
- IP allow-list на токен и подпись запросов.
- Тонкие ограничения на аргументы: scope даёт доступ к инструменту, а не к конкретному каналу.
- Серверные уведомления: поток
GET /mcpработает как keepalive.
Эти ограничения стоит учитывать при проектировании агентских сценариев.
Частые вопросы
Нужен ли отдельный AI-ключ? Нейросеть работает со своей подпиской или ключом. Инструменты ai.* используют провайдера, настроенного в сервисе; без него вернётся понятная ошибка.
Можно ли подключить несколько нейросетей? Да, на каждую — свой токен. Так проще отзывать доступ точечно.
Что будет, если токен утечёт? Отзовите его: все клиенты сразу получат ошибку авторизации. Журнал покажет, какие вызовы были.
Что дальше
Полные конфиги клиентов и разбор ошибок — в инструкции для разработчиков. Общий список возможностей — на странице features, примеры процессов — в кейсах. Если хотите проверить коннектор на своём рабочем пространстве — зарегистрируйтесь; лимиты и тарифы — на странице тарифов.
Источники
modules-mcp/README.md, modules-mcp/docs/02-TOOLS.md, modules-mcp/docs/03-CLIENTS.md, modules-mcp/docs/04-SECURITY.md.