Постинг в X из Gemini CLI

Что Gemini CLI умеет с calmposts

Gemini CLI читает файлы, запускает команды и ищет в интернете прямо из терминала. С calmposts как MCP-сервером он может набросать тред о запуске по README, посты на неделю по плану или продолжение того, что вы запланировали вчера, и сохранить каждый пост в calmposts.

Gemini спрашивает разрешение перед запуском MCP-инструмента, если сервер не помечен как доверенный, так что вы видите каждый вызов create_post и его текст заранее. Команда /mcp показывает состояние подключения calmposts и его инструменты.

MCP-сервер для X (Twitter) даёт Gemini CLI 11 инструментов — тех же, что и любому другому клиенту:

Настройка calmposts в Gemini CLI

Сначала проверьте ключ

Создайте ключ в calmposts в разделе «API и MCP» (он показывается один раз) и запросите у сервера список инструментов. Список из 11 инструментов значит, что адрес и ключ верны; 401 — ключ неверный или отправлен без «Bearer ».

curl -s https://calmposts.com/mcp \
  -H "Authorization: Bearer cp_live_…" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
# 200 {"jsonrpc":"2.0","id":1,"result":{"tools":[…]}}

Способ 1: Одна команда для всех проектов

gemini mcp add пишет в .gemini/settings.json текущего проекта, если не передать -s user — тогда calmposts попадёт в ~/.gemini/settings.json.

1. Создайте ключ в calmposts в разделе «API и MCP» и экспортируйте его, например в ~/.zshrc:

   export CALMPOSTS_API_KEY=cp_live_…

2. Добавьте сервер. Одинарные кавычки сохраняют в settings.json имя переменной, а Gemini подставит её значение из окружения при загрузке настроек:

   gemini mcp add -s user --transport http \
     --header 'Authorization: Bearer ${CALMPOSTS_API_KEY}' calmposts https://calmposts.com/mcp

3. Проверьте: в списке calmposts в состоянии Connected.

   gemini mcp list

Способ 2: settings.json вручную

Используйте httpUrl: в Gemini CLI url означает старый транспорт SSE, а calmposts говорит только на Streamable HTTP.

1. Добавьте calmposts в mcpServers в ~/.gemini/settings.json или в .gemini/settings.json проекта:

   {
     "mcpServers": {
       "calmposts": {
         "httpUrl": "https://calmposts.com/mcp",
         "headers": {"Authorization": "Bearer ${CALMPOSTS_API_KEY}"}
       }
     }
   }

2. Запустите gemini и выполните /mcp: calmposts в состоянии CONNECTED, с 11 инструментами.

Вход: ключ или OAuth

Gemini CLI отправляет заданные заголовки в каждом запросе. Любая строка в settings.json может ссылаться на переменную окружения ($VAR_NAME или ${VAR_NAME}, в том числе из файлов .env), так что ключ в файле хранить не нужно.

Gemini CLI умеет входить и сам: когда сервер отвечает 401, он находит OAuth-адреса, регистрируется и открывает браузер, а токены хранит в ~/.gemini/mcp-oauth-tokens.json. Для этого нужны локальный браузер и возврат на localhost, поэтому по обычному SSH это не работает. С calmposts эта страница проверена с ключом.

Не помечайте calmposts как доверенный (trust): это отключает все подтверждения для инструментов сервера, включая delete_post.

Как проверить, что всё работает

• gemini mcp list показывает calmposts, его URL и Connected.
• /mcp в сессии показывает calmposts в состоянии CONNECTED и его 11 инструментов.
• Спросите «Какие у меня сегодня лимиты в calmposts?» — Gemini попросит разрешение на get_limits и ответит.
• Попросите черновик и найдите его в разделе «Посты» calmposts, с источником mcp.

Что попросить

Просите своими словами — агент сам выберет инструменты. Хорошо работают такие просьбы:

• «Прочитай README.md и напиши тред о запуске для X. Сохрани в calmposts черновиком».
• «Сделай из docs/roadmap.md пять постов, по одному на пункт, и поставь их в очередь calmposts».
• «Найди в интернете новости недели по нашей категории продуктов и набросай два поста со свежим углом; оставь черновиками».
• «Покажи завтрашнюю очередь calmposts и перенеси пост с 9:00 на полдень».

Соцсети, треды и одобрение

Посты уходят в X и Bluesky. В X и Bluesky тред выходит цепочкой ответов. Скоро: Threads и LinkedIn.

Пишете один раз — выходит везде: агент передаёт один текст для всех выбранных аккаунтов. Если текст длиннее, чем разрешает соцсеть, calmposts публикует его там тредом из постов, каждый из которых помещается: делит по абзацу, затем по предложению, затем по пробелу, ничего не нумерует и не добавляет. Правила каждой соцсети и квоты тарифа проверяются до сохранения поста, а ошибка возвращается с указанием поля, так что агент может поправить текст и повторить.

По умолчанию посты агента ждут вас: они возвращаются со статусом pending_approval, и вы одобряете или отклоняете каждый в приложении, в Telegram или из письма calmposts. Владелец рабочего пространства может разрешить агентам публиковать самим; для этого и пространство, и API-ключ должны быть переключены на публикацию. X ждёт, что у аккаунта, который постит автоматически, стоит метка Automated (Settings → Your account → Account information → Automation).

Какие соцсети уже работают→

Лимиты и стоимость

• Агентам нужен платный тариф: на Free нет API-ключей и нельзя одобрить подключение приложения. API-ключей по тарифам: Pro 3 · Advanced 10 · Agency 25.
• Посты агента считаются так же, как ваши. Постов в день: Pro 20 · Advanced 100 · Agency 300. Постов со ссылкой в месяц: Pro 30 · Advanced 300 · Agency 600. Каждый пост треда считается отдельно.
• Ссылки считаются отдельно, потому что X берёт с каждого приложения $0,015 за пост и $0,20 за пост со ссылкой. Плата X входит в тариф: свой аккаунт разработчика X и свой счёт за X API не нужны.
• Попробовать: 7 дней бесплатно. Нужна карта. 5 постов со ссылкой за пробный период.
• Каждый ключ может сделать 60 запросов в минуту, MCP и REST вместе; дальше сервер отвечает 429 с Retry-After.

Тарифы→

Что важно знать про Gemini CLI

• Используйте httpUrl, а не url: в Gemini CLI url выбирает SSE, которого у calmposts нет.
• Не используйте подчёркивания в имени сервера. Gemini называет инструменты mcp_{server}_{tool} и делит имя по первому подчёркиванию, поэтому calmposts работает, а calm_posts — нет.
• Чтобы ограничить инструменты, добавьте includeTools или excludeTools, например "excludeTools": ["delete_post"].
• Таймаут запроса по умолчанию 10 минут — намного больше, чем нужно calmposts; дольше всего идёт create_post с картинками, пока calmposts их скачивает.

Без MCP: REST API

Всё, что делают инструменты, доступно и обычными REST-запросами к /api/v1 с тем же ключом. Это удобно для скрипта или шага, который умеет только HTTP. calmposts публикует через своё одобренное приложение X, поэтому ключи X API для запроса не нужны.

export CALMPOSTS_API_KEY=cp_live_…
curl -H "Authorization: Bearer $CALMPOSTS_API_KEY" https://calmposts.com/api/v1/accounts
curl -X POST https://calmposts.com/api/v1/posts \
  -H "Authorization: Bearer $CALMPOSTS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"parts":[{"text":"Calm posts, scheduled."}],"targets":[{"account_id":"ACCOUNT_ID"}],"schedule":{"mode":"queue"}}'

Документация REST API→

Документация Gemini CLI, по которой написана страница

• Gemini CLI docs: MCP servers with Gemini CLI
• Gemini CLI docs: Configuration
• Gemini CLI source docs: mcp-server.md

calmposts — независимый сервис, он не связан с создателями Gemini CLI и не одобрен ими. Названия продуктов принадлежат их владельцам.