MCP-сервер Smmly: постинг в соцсети из вашего агента

1. 1

   Возьмите ключ в кабинете

   Ключи доступа → «Создать ключ». Он показывается один раз и начинается с smk_ — скопируйте сразу. Потеряли — удалите его и выпустите новый: удалённый ключ перестаёт работать сразу.

2. 2

   Вставьте конфиг

   Подставьте свой ключ вместо smk_ВАШ_КЛЮЧ. Подойдёт любой клиент, который умеет MCP по HTTP и свои заголовки — ниже два самых частых.

   Claude Code — одна команда в терминалеСкопировать

   claude mcp add --transport http smmly https://smmly.ru/api/mcp --header "Authorization: Bearer smk_ВАШ_КЛЮЧ"

   Claude Desktop — в claude_desktop_config.jsonjsonСкопировать

   {
     "mcpServers": {
       "smmly": {
         "command": "npx",
         "args": [
           "-y",
           "mcp-remote",
           "https://smmly.ru/api/mcp",
           "--transport",
           "http-only",
           "--header",
           "Authorization:${SMMLY_KEY}"
         ],
         "env": {
           "SMMLY_KEY": "Bearer smk_ВАШ_КЛЮЧ"
         }
       }
     }
   }

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%\Claude\claude_desktop_config.json.
   • Это запасной путь с ключом. Проще — коннектор: адрес сервера и вход в Smmly, без ключа и Node.js (см. ниже и страницу Claude). Обёртка mcp-remoteподставляет ключ заголовком за вас; нужен установленный Node.js.
   • Ключ стоит в env, а не прямо в аргументе, и двоеточие без пробела — это не опечатка. На Windows запуск рвёт аргументы по пробелам, и Bearer smk_… доезжает до нас половиной: вместо подключения будет 401 без объяснений.
   • Клиент читает список серверов при запуске: Claude Desktop после правки конфига надо перезапустить, а в Claude Code — начать новую сессию. Уже открытый разговор про свежеподключённый сервер не узнает.
3. 3

   Проверьте связку

   Скажите агенту: «покажи мои каналы в smmly». Пришёл список с площадками и ярлыками — всё подключено, можно постить. Пришёл отказ — почти всегда это неподтверждённая почта аккаунта или отозванный ключ.

   ChatGPT, Claude в браузере и другие клиенты с OAuth ключ не спрашивают: дайте им только адрес сервера — клиент сам откроет окно входа в Smmly, где надо нажать «Разрешить». Права те же, что у ключа, отключить приложение можно в Ключах.

   Клиент не из этих двух? Настройка отличается деталями —разобрали по клиентам отдельно: Claude, ChatGPT, Cursor, Codex.

• smmly_channels

  Показать каналы

  Площадка, имя канала и его ярлыки. С этого агент начинает: без списка он постит вслепую.

• smmly_tag_channels

  Расставить ярлыки

  «Помечай этот канал как тестовый» — ярлыки, которыми потом адресуются посты, агент вешает и снимает сам. Подключить канал он всё так же не может.

• smmly_upload_media

  Загрузить вложение

  Картинка или видео с вашего диска — прямо из разговора, без выкладывания куда-то ради ссылки. Файл ложится в хранилище smmly и сразу готов к посту.

• smmly_post

  Опубликовать сейчас

  Текст, картинки, выбор каналов ярлыком, площадкой или списком. Пост уходит в ту же очередь, что и из кабинета.

• smmly_schedule_post

  Поставить на время

  То же самое, но с датой и временем публикации. До отправки пост виден в календаре и правится руками.

• smmly_post_status

  Что стало с постом

  По каждому каналу: состояние, ссылка на опубликованное, текст ошибки — если площадка отказала.

• smmly_posts

  Найти свой пост

  Что стоит в отложке и что уже ушло — с текстом, временем и каналами. Отсюда агент берёт пост, который вы просите поправить: помнить его с прошлого разговора он не обязан.

• smmly_edit_post

  Поправить пост

  Опечатка, новая формулировка, другое время. Неотправленный пост меняется целиком; уже вышедший в Телеграме переписывается прямо в канале — там меняется только текст и только пока посту не больше двух суток.

• smmly_cancel_post

  Снять пост

  Отложенный снимается с очереди и не уйдёт. Уже опубликованный по умолчанию остаётся в канале — стереть его оттуда агент может, только если вы прямо об этом попросите.

Поля каждого инструмента, разбор отказов и грабли со временем публикации — в документации.

• «покажи мои каналы в smmly»

  Список: площадка, имя канала, ярлыки. С этого стоит начинать — дальше можно ссылаться на ярлыки словами.

• «запости в новости: сегодня привезли новую обжарку, ждём с утра»

  Пост уходит во все каналы с ярлыком «новости» — сразу, во все площадки разом.

• «вот картинка с моего компьютера — приложи её к посту»

  Агент сам загрузит файл в smmly и приложит. Выкладывать его куда-то ради ссылки не нужно; ссылка тоже подойдёт, если файл уже в интернете.

• «то же самое, но в телеграм — и текст подписью к картинке»

  Пост с вложением. Если текст не влезет в подпись, он уедет вторым сообщением, а не обрежется.

• «в телеграм текст подлиннее, в ВК — короткий анонс со ссылкой»

  Один вызов, две разные формулировки. Каналы всё те же, разъезжается только текст.

• «добавь под постом кнопку Записаться на мой сайт»

  Кнопка-ссылка под сообщением в телеграм-каналах. ВК и MAX получат тот же пост без неё.

• «поставь это на завтра в 9 утра по Москве во все телеграм-каналы»

  Пост в календаре на 9:00 МСК. Часовой пояс лучше называть городом: без него агент может понять время как всемирное — и пост уйдёт на три часа раньше.

• «что с последним постом?»

  По каждому каналу: ушёл или ждёт, ссылка на опубликованное, текст ошибки — если площадка отказала.

• «в завтрашнем посте замени «в среду» на «в четверг»»

  Агент найдёт пост в отложке и поправит текст во всех каналах, куда он поставлен. Время публикации остаётся прежним, если не просить его перенести.

• «во вчерашнем посте опечатка в первой строке — поправь»

  Текст перепишется прямо в телеграм-канале. ВК и MAX так не умеют — там агент честно скажет, что пост придётся снять и опубликовать заново; Телеграм не даёт трогать сообщения старше двух суток.

• «отмени пост, который стоит на понедельник»

  Снимается с очереди и не уйдёт. Уже опубликованное этой просьбой не трогается — из канала агент удалит его, только если прямо сказать «удали из канала».

• «помечай мой второй канал как тестовый»

  Агент повесит на него ярлык «тестовый» — раньше это можно было сделать только в кабинете. Снять ярлык он тоже умеет, подключить канал — нет.

• «проверь на тестовом канале, боевые не трогай»

  Ровно то, что сказано, — если у тестового канала есть свой ярлык. Заведите его до первого настоящего поста.

Частые вопросы

Мелким шрифтом

• Ключ — это доступ к публикации в ваших каналах. Не коммитьте его в репозиторий и не пересылайте в переписке: утёкший ключ удаляется в кабинете, но всё, что успели опубликовать до этого, останется опубликованным.
• Потолок — 60 запросов в минуту на ключ. Дальше сервер отвечает отказом до конца минуты.
• Кнопки-ссылки под постом и ответ-комментарий умеет только Телеграм. ВКонтакте и MAX получат тот же пост без них, ВК вдобавок снимает разметку текста.
• Постить можно только в каналы, подключённые в кабинете, и только со своего аккаунта.
• Постит не человек словами, а крон или ваш бэкенд? Тем же ключом работаетобычный HTTP API — с защитой от повторной отправки.