beehiiv

beehiiv/agents

beehiiv MCP サーバー上に構築された、AI エージェント向けの beehiiv 公式ツールです。

このリポジトリには、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 サーバーのみを利用できます。

インストール

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 クライアント

Streamable HTTP 経由で https://mcp.beehiiv.com/mcp に接続してください。セットアップ用の記述例は、beehiiv ワークスペースの Settings → Workspace → MCP にあります。

認証

OAuth 2.1 を使用します。コピーする API キーも、このリポジトリに保存するシークレットもありません。

初回使用時に、クライアントは自動的に自身を登録し（RFC 7591 動的クライアント登録）、ブラウザーで beehiiv を開きます。そこでサインインしてアクセスを許可すると、クライアントは read と write のスコープが設定されたアクセストークンとリフレッシュトークンを受け取ります。

すべてのツール呼び出しは、ユーザー自身の beehiiv 権限に基づいて認可されます。エージェントがアクセスできるのは、ユーザーがすでにアクセスできるパブリケーションのみです。

要件

• MCP アクセスが含まれるプランの beehiiv アカウント。
• ワークスペースで MCP が有効になっていること。設定 → ワークスペース → 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 がここにもう一度記載されています。

ネットワークエンドポイントと認証情報

このプラグインが接続する先を確認・監査する人のために記載しています。

エンドポイント	用途
https://mcp.beehiiv.com/mcp	MCP サーバー。すべてのツール呼び出しに使用します。
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 以外の実行可能コード、インストールフック、ローカルプロセスは含まれていません。プラグインは、ホストされた HTTPS エンドポイントを参照する JSON マニフェストです。

検証

./scripts/validate.sh

ライセンス

MIT。LICENSEをご覧ください。