beehiiv/agents

Официальные инструменты beehiiv для AI-агентов на базе beehiiv MCP server.

В этом репозитории собраны манифесты плагинов для Claude Code, Grok Build, Gemini CLI, Cursor и

Codex, а также официальная запись в реестре MCP. Все они подключаются к одному и тому же размещённому

серверу по адресу https://mcp.beehiiv.com/mcp. На вашем компьютере ничего не запускается.

Возможности

После подключения агент напрямую работает с вашим рабочим пространством beehiiv:

Публикации. Создавайте, редактируйте и дублируйте публикации и шаблоны публикаций. Читайте содержимое публикаций, статистику,

клики, комментарии и данные о вовлечённости каждого подписчика. Публикацию и отправку выполняет человек в beehiiv: агент подготовит публикацию, а вам останется нажать кнопку отправки.

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

ролями, отправляйте приглашения и личные сообщения, просматривайте статистику сообщества.

Подкасты. Создавайте шоу и эпизоды, загружайте аудио, планируйте публикацию эпизодов, просматривайте расшифровки

и статистику эпизодов.

Автоматизации. Создавайте сценарии, этапы, триггеры и письма автоматизации, в том числе варианты для A/B-тестирования.

Активацию автоматизации по-прежнему выполняет человек в редакторе.

Аудитория. Управляйте подписками, сегментами, тегами, пользовательскими полями, списками рассылок и сценариями

подписки.

Монетизация. Управляйте продуктами, уровнями подписки, премиум-предложениями, заказами, платным доступом, рекламной сетью и

сетью спонсоров.

Рост аудитории. Работайте с рекомендациями, реферальными программами, опросами и анкетами.
Аналитика. Просматривайте аналитику публикаций и сайта, статистику публикаций и подкастов, ответы на опросы и анкеты,

а также доходы.

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

read_documentation или любой из инструментов learn_*, чтобы получить актуальные рекомендации по созданию публикаций

и материалов для сообществ, а не полагаться на догадки.

Навыки

В состав плагина также входят навыки для самых востребованных задач издателей: начало работы и настройка

новой публикации, отчёты об эффективности и доходах, всплески отписок, снижение активности в автоматизациях, медиакиты, сегменты, редактирование публикаций и кампании

по переходу на платный тариф. Полный список приведён в файле plugins/beehiiv/README.md. Клиенты,

поддерживающие Agent Skills, загружают их вместе с плагином; остальные получают только MCP server.

Установка

Claude

beehiiv доступен в каталоге коннекторов Claude. Добавьте его на странице

коннектора beehiiv, а затем войдите в систему, когда появится запрос.

ChatGPT

beehiiv доступен в общем каталоге плагинов ChatGPT и Codex. Добавьте его со страницы

плагина beehiiv.

Claude Code и Cursor

/plugin marketplace add beehiiv/agents
/plugin install beehiiv@beehiiv

Grok Build

grok plugin install beehiiv/agents

Gemini CLI

gemini extensions install https://github.com/beehiiv/agents

Codex

Запустите /plugins, выберите beehiiv, затем нажмите Install Plugin. Codex и ChatGPT используют

общий каталог плагинов, поэтому установка в одном из них подключит плагин и в другом.

Также можно вручную добавить сервер в ~/.codex/config.toml:

[mcp_servers.beehiiv]
url = "https://mcp.beehiiv.com/mcp"
enabled = true

Можно также клонировать этот репозиторий и подтвердить доверие к нему. Файл .codex/config.toml регистрирует сервер для

сеансов, запущенных внутри репозитория.

Другие MCP-клиенты

Подключитесь к https://mcp.beehiiv.com/mcp по протоколу Streamable HTTP. Примеры конфигурации доступны в рабочем пространстве beehiiv в разделе Settings → Workspace → MCP.

Аутентификация

OAuth 2.1. Копировать API-ключ или хранить секрет в этом репозитории не нужно.

При первом использовании клиент автоматически регистрируется (динамическая регистрация клиентов по RFC 7591) и

открывает страницу beehiiv в браузере, где вы входите в систему и предоставляете доступ. Клиент получает токен доступа

и токен обновления с областями доступа read и write.

Каждый вызов инструмента проверяется с учётом ваших разрешений в beehiiv. Агент может обращаться только к тем публикациям,

которые уже доступны вам.

Требования

Аккаунт beehiiv с тарифом, включающим доступ к MCP.
MCP должен быть включён для вашего рабочего пространства. Проверьте это в разделе

Settings → Workspace → MCP.

Если MCP отключён для рабочего пространства, вызовы инструментов будут завершаться ошибкой доступа. Актуальные требования к тарифам см. в статье

Начало работы с beehiiv MCP.

Доступ к некоторым группам инструментов регулируется отдельно, поэтому набор инструментов, доступных агенту, зависит от вашего тарифа и

настроек рабочего пространства.

Структура репозитория

.mcp.json lives at plugins/beehiiv/ and states the server URL once.
Every ecosystem manifest beside it delegates to that file.

.claude-plugin/marketplace.json     point their client at ./plugins/beehiiv
.cursor-plugin/marketplace.json
.grok-plugin/marketplace.json
plugins/beehiiv/.mcp.json           the shared server config
plugins/beehiiv/.claude-plugin/     per-ecosystem plugin manifests
plugins/beehiiv/.cursor-plugin/
plugins/beehiiv/.grok-plugin/
plugins/beehiiv/.codex-plugin/
gemini-extension.json               must sit at the repo root
server.json                         official MCP registry entry

Для Gemini манифест должен находиться в корне репозитория, а делегирование настроек общему файлу не поддерживается. Поэтому URL сервера указан там повторно.

Сетевые адреса и учётные данные

Этот список приведён для проверки и для всех, кто хочет убедиться, к каким ресурсам обращается плагин:

Endpoint	Назначение
`https://mcp.beehiiv.com/mcp`	MCP server. Все вызовы инструментов.
`https://mcp.beehiiv.com/.well-known/oauth-protected-resource`	Поиск OAuth-ресурса (RFC 9728).
`https://mcp.beehiiv.com/.well-known/oauth-authorization-server`	Метаданные OAuth-сервера (RFC 8414).
`https://mcp.beehiiv.com/register`	Динамическая регистрация клиента (RFC 7591).
`https://mcp.beehiiv.com/authorize`	Запуск процедуры входа. Перенаправляет на `app.beehiiv.com`.
`https://mcp.beehiiv.com/token`	Обмен и обновление токенов.

Необходимые учётные данные: аккаунт beehiiv. Плагин запрашивает области доступа read и write.

В репозитории нет исполняемого кода, кроме scripts/validate.sh, установочных хуков и локальных процессов. Плагины представляют собой JSON-манифесты, указывающие на размещённый HTTPS-адрес.

Проверка

./scripts/validate.sh

Лицензия

MIT. См. LICENSE.