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

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

Codex читает репозиторий, запускает команды и правит файлы. С calmposts как MCP-сервером он может ещё и рассказать о работе: тред, когда смёржен пул-реквест, короткий пост к каждому релизу, черновик к каждому пункту списка изменений.

Codex читает инструкции, которые calmposts присылает при подключении, и следует им вместе с инструментами: сначала проверить аккаунты и лимиты, предпочитать очередь или черновик, никогда не отвечать, не подписываться и не писать в личку. Один и тот же config.toml обслуживает Codex CLI, расширение для IDE и десктопное приложение ChatGPT, так что calmposts настраивается один раз.

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

Настройка calmposts в Codex 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: Одна команда, ключ в переменной окружения

Codex хранит только имя переменной; ключ остаётся в вашей оболочке.

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

   export CALMPOSTS_API_KEY=cp_live_…

2. Добавьте сервер. Значение переменной Codex отправит как Bearer-токен:

   codex mcp add calmposts --url https://calmposts.com/mcp --bearer-token-env-var CALMPOSTS_API_KEY

3. Проверьте: calmposts в списке со своим URL. В TUI Codex команда /mcp показывает его с инструментами.

   codex mcp list

Способ 2: Прямо в config.toml

Та же запись вручную — в ~/.codex/config.toml или в .codex/config.toml доверенного проекта.

1. Добавьте таблицу. Последняя строка необязательна: writes заставляет Codex спрашивать перед любым инструментом, не помеченным как только для чтения, а calmposts помечает так list_* и get_*.

   [mcp_servers.calmposts]
   url = "https://calmposts.com/mcp"
   bearer_token_env_var = "CALMPOSTS_API_KEY"
   default_tools_approval_mode = "writes"

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

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

bearer_token_env_var называет переменную окружения, и Codex отправляет её значение как Authorization: Bearer в каждом запросе. Если переменная не задана там, где запускается Codex, ключ не уходит, и calmposts отвечает 401 missing_api_key.

Codex умеет входить на MCP-серверы и через OAuth (codex mcp login calmposts), но с calmposts этот путь ещё не проверен. Эта страница проверена с ключом.

Дайте Codex собственный ключ только с нужными правами, чтобы отозвать его в «API и MCP», не трогая других агентов.

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

• codex mcp list показывает calmposts с его URL.
• В TUI /mcp показывает calmposts и его инструменты; /mcp verbose добавляет диагностику сервера.
• Спросите «Какие у меня сегодня лимиты в calmposts?» — Codex вызовет get_limits и перескажет тариф и остаток постов на сегодня.
• Попросите черновик и найдите его в разделе «Посты» calmposts, с источником mcp.

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

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

• «Прочитай дифф последнего смёрженного PR и напиши пост для X о том, что изменилось. Сохрани в calmposts черновиком».
• «Сделай из раздела 3.1 в CHANGELOG.md тред для X и Bluesky и поставь его в очередь calmposts».
• «Набросай по посту на каждый тег релиза за этот месяц и разложи их по свободным слотам следующей недели».
• «Что запланировано в calmposts на пятницу? Исправь посты, которые длиннее лимита X».

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

Посты уходят в 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.

Тарифы→

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

• По умолчанию Codex даёт серверу 10 секунд на запуск и 60 секунд на вызов инструмента (startup_timeout_sec, tool_timeout_sec). calmposts отвечает намного быстрее секунды; дольше всего идёт create_post с картинками, пока calmposts их скачивает.
• enabled_tools и disabled_tools сокращают то, что видит Codex, например disabled_tools = ["delete_post"].
• .codex/config.toml проекта читается только в доверенных проектах; ~/.codex/config.toml действует везде.
• Документация Codex просит серверы делать первые 512 символов инструкций самодостаточными; инструкции calmposts начинаются с того, что вызвать первым, — list_accounts и get_limits.

Без 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→

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

• Codex docs: Model Context Protocol (CLI)
• Codex docs: Configuration reference
• Codex docs: Commands

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