AIエージェントによるパブリッシャーフィードの管理、署名付きアップデートの公開、およびオーディエンス分析へのアクセスを可能にします。
別名 helloaigent-dev/helloaigent-publisher, @helloaigent-dev/publisher
- スター
- 0
- ツール
- 9
- ダウンロード数(30日間)
- —
- 最新バージョン
- 0.1.1
- 最終コミット
- 2026年10月22日
- ライセンス
- MIT
helloaigent-publisher MCPとは
helloaigent-publisherはMCPサーバーです。 AIエージェントによるパブリッシャーフィードの管理、署名付きアップデートの公開、およびオーディエンス分析へのアクセスを可能にします。. 9個のツールを提供しており、hello_aigent_create_feed, hello_aigent_list_feeds, hello_aigent_publishなどがあります。
プロジェクトのREADMEから生成された概要
helloaigent-publisher MCP server について
このMCP serverは、マーケターがAIエージェントを通じてパブリッシャーフィードとオーディエンス分析を管理できるようにします。コマンドラインやデベロッパーコンソールを使用する代わりに、ユーザーはエージェントに対して、初期作成から署名付きアップデートの公開まで、フィードのライフサイクル全体を処理するよう指示できます。このツールは、購読者側のMCPに対応するプロデューサー側の役割を果たし、コンテンツ配信とパフォーマンス追跡の完全なループを実現します。
このサーバーを使用するには、hak_ で始まるワークスペースAPIキーまたは管理者トークンを使用して、MCPクライアントを設定する必要があります。サーバーはこれらの認証情報を使用して、すべての操作を特定のワークスペースに限定し、自身が所有するフィードの管理と分析の閲覧のみを保証します。Ed25519キーペアを使用して新しいフィードを発行する hello_aigent_create_feed や、購読者に署名付きアップデートを配信する hello_aigent_publish といった特定のツールを提供します。また、hello_aigent_funnel や hello_aigent_overview などのツールを使用して、購読者のコンバージョン率や最近のアクティビティを監視し、パフォーマンスを追跡することも可能です。
できること
- 1新しいフィードの作成と立ち上げエージェントに新しいフィードのセットアップ、および必要なセキュリティキーとディスカバリーファイルの生成を依頼します。
- 2署名付きコンテンツアップデートの配信AIに、現在のすべての購読者に対して署名付きアップデートを作成し、送信するよう指示します。
- 3オーディエンスのコンバージョン指標の分析購読からアップデートへの実際の反応に至るまでのユーザー数に関するレポートを要求します。
- 4オーディエンスのエンゲージメントとログの監査エージェントにイベントのフィルタリングされたリストを取得させ、ユーザーがフィードとどのようにやり取りしているかを確認します。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
helloaigent-publisher MCPのインストール方法
フォーマット検証日 2026年11月10日Claude Codeにhelloaigent-publisher MCPをインストール
$ claude mcp add --env HELLOAIGENT_ADMIN_TOKEN=<YOUR_HELLOAIGENT_ADMIN_TOKEN> --env HELLOAIGENT_TOKEN=<YOUR_HELLOAIGENT_TOKEN> helloaigent-publisher -- npx -y @helloaigent-dev/publisherCursorにhelloaigent-publisher MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"helloaigent-publisher": {
"command": "npx",
"args": [
"-y",
"@helloaigent-dev/publisher"
],
"env": {
"HELLOAIGENT_ADMIN_TOKEN": "<YOUR_HELLOAIGENT_ADMIN_TOKEN>",
"HELLOAIGENT_TOKEN": "<YOUR_HELLOAIGENT_TOKEN>"
}
}
}
}VS Codeにhelloaigent-publisher MCPをインストール
.vscode/mcp.json
{
"servers": {
"helloaigent-publisher": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@helloaigent-dev/publisher"
],
"env": {
"HELLOAIGENT_ADMIN_TOKEN": "<YOUR_HELLOAIGENT_ADMIN_TOKEN>",
"HELLOAIGENT_TOKEN": "<YOUR_HELLOAIGENT_TOKEN>"
}
}
}
}Claude Desktopにhelloaigent-publisher MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"helloaigent-publisher": {
"command": "npx",
"args": [
"-y",
"@helloaigent-dev/publisher"
],
"env": {
"HELLOAIGENT_ADMIN_TOKEN": "<YOUR_HELLOAIGENT_ADMIN_TOKEN>",
"HELLOAIGENT_TOKEN": "<YOUR_HELLOAIGENT_TOKEN>"
}
}
}
}Codexにhelloaigent-publisher MCPをインストール
~/.codex/config.toml
[mcp_servers.helloaigent-publisher] command = "npx" args = ["-y", "@helloaigent-dev/publisher"] [mcp_servers.helloaigent-publisher.env] HELLOAIGENT_ADMIN_TOKEN = "<YOUR_HELLOAIGENT_ADMIN_TOKEN>" HELLOAIGENT_TOKEN = "<YOUR_HELLOAIGENT_TOKEN>"
Gemini CLIにhelloaigent-publisher MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"helloaigent-publisher": {
"command": "npx",
"args": [
"-y",
"@helloaigent-dev/publisher"
],
"env": {
"HELLOAIGENT_ADMIN_TOKEN": "<YOUR_HELLOAIGENT_ADMIN_TOKEN>",
"HELLOAIGENT_TOKEN": "<YOUR_HELLOAIGENT_TOKEN>"
}
}
}
}helloaigent-publisher MCPツール 9
READMEから検出hello_aigent_create_feedhello_aigent_list_feedshello_aigent_publishhello_aigent_report_eventhello_aigent_overviewhello_aigent_funnelhello_aigent_event_loghello_aigent_subscribershello_aigent_discovery_file
| hello_aigent_create_feed | — | |
| hello_aigent_list_feeds | — | |
| hello_aigent_publish | — | |
| hello_aigent_report_event | — | |
| hello_aigent_overview | — | |
| hello_aigent_funnel | — | |
| hello_aigent_event_log | — | |
| hello_aigent_subscribers | — | |
| hello_aigent_discovery_file | — |
設定
HELLOAIGENT_ADMIN_TOKENシークレットAdmin token — required for feed management and analytics tools
HELLOAIGENT_TOKENシークレットPublish token (a feed's publisher token); falls back to the admin token
HELLOAIGENT_APIAPI base URL (default https://api.helloaigent.dev)
HELLOAIGENT_API_KEY
| 名前 | 説明 | 種類 |
|---|---|---|
| HELLOAIGENT_ADMIN_TOKEN | Admin token — required for feed management and analytics tools | シークレット |
| HELLOAIGENT_TOKEN | Publish token (a feed's publisher token); falls back to the admin token | シークレット |
| HELLOAIGENT_API | API base URL (default https://api.helloaigent.dev) | |
| HELLOAIGENT_API_KEY | — |
自動チェック
実行日 2026年11月13日詳細レポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能合格
- オープンソースライセンス (OSI)合格
- 過去1年以内にコミットまたはリリースあり合格
- パッケージ名が有名なパッケージに酷似していない合格
- リモートエンドポイントがHTTPSを使用未チェック
- 破壊的なツールがラベル付けされている合格
- モデルへの隠れた指示がない合格
- パッケージと依存関係に重大なアドバイザリがない合格
README
GitHubで見る@helloaigent-dev/publisher
Hello Aigent publisher MCP — an MCP server that lets an agent run a publisher's feed: create feeds, publish signed updates, and read analytics. The producer-side counterpart to @helloaigent-dev/subscriber (which lets an agent subscribe/fetch/act).
A marketer operates their owned agent audience by telling their agent — no CLI, console, or developer.
Tools
| Tool | Auth | What it does |
|---|---|---|
hello_aigent_create_feed |
workspace key or admin | Mint a feed + Ed25519 keypair + publisher token; returns the discovery file |
hello_aigent_list_feeds |
workspace key or admin | List feeds you own |
hello_aigent_publish |
publish token, workspace key, or admin | Build + server-sign an update; delivered to subscribers |
hello_aigent_report_event |
publish token, workspace key, or admin | Report an action outcome (the "acted" analytics signal) |
hello_aigent_overview |
workspace key or admin | KPI tiles, fetch sparkline, recent activity |
hello_aigent_funnel |
workspace key or admin | subscribed → returned → acted funnel |
hello_aigent_event_log |
workspace key or admin | Filterable, attributed audit log |
hello_aigent_subscribers |
workspace key or admin | The owned-audience list (consent-aware) |
hello_aigent_discovery_file |
public | Generated hello-aigent.json to host at /.well-known/ |
"workspace key" means a hak_... workspace API key — mint one from the Hello Aigent console (Feeds → Give your agent access, or System → API keys) once you've signed up. It scopes every tool above to your own workspace: create_feed creates in your workspace, list_feeds/analytics/subscribers only ever see feeds your workspace owns, and publish/report_event only work on feeds your workspace owns. It is not admin-equivalent — it cannot create, list, or revoke API keys (that requires signing in to the console itself).
The admin token is a separate, unrestricted, ops-only credential (not something a self-serve signup ever receives) — it still works everywhere a workspace key does, for every feed, not just your own.
Configure
Set in your MCP client config (env vars):
HELLOAIGENT_API— API base (defaulthttps://api.helloaigent.dev)HELLOAIGENT_API_KEY— your workspace API key (hak_...); required for feed management + analytics unless using the admin token. Preferred overHELLOAIGENT_ADMIN_TOKENwhen both are set.HELLOAIGENT_ADMIN_TOKEN— admin token; alternative toHELLOAIGENT_API_KEY(ops/dogfood use only)HELLOAIGENT_TOKEN— publish token (a feed's own publisher token); falls back toHELLOAIGENT_API_KEY, thenHELLOAIGENT_ADMIN_TOKEN
Example (Claude Desktop / any MCP client) — the common case, a self-serve workspace key:
{
"mcpServers": {
"hello-aigent-publisher": {
"command": "npx",
"args": ["-y", "@helloaigent-dev/publisher"],
"env": { "HELLOAIGENT_API_KEY": "hak_…" }
}
}
}
Then just ask your agent: "Create a feed for my coffee shop and publish a restock update," or "How many agents subscribed this week, and what's the return rate?"
helloaigent-publisher MCPのよくある質問
helloaigent-publisher MCPをClaude Codeに追加するには
ターミナルでclaude mcp add --env HELLOAIGENT_ADMIN_TOKEN=<YOUR_HELLOAIGENT_ADMIN_TOKEN> --env HELLOAIGENT_TOKEN=<YOUR_HELLOAIGENT_TOKEN> helloaigent-publisher -- npx -y @helloaigent-dev/publisherを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
helloaigent-publisher MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
helloaigent-publisher MCPが提供するツールは
9個のツールを提供しており、hello_aigent_create_feed, hello_aigent_list_feeds, hello_aigent_publish, hello_aigent_report_event, hello_aigent_overviewなどがあります。
新しいフィードを作成するにはどうすればよいですか?
hello_aigent_create_feed ツールを使用します。フィードの発行には、ワークスペースキーまたは管理者トークン、Ed25519キーペア、およびパブリッシャートークンが必要です。
ワークスペースキーとは何ですか?
ワークスペースキーは、Hello Aigentコンソールから発行される hak_... で始まるAPIキーであり、ツールを特定のワークスペースに制限する役割を持ちます。
ワークスペースキーを使用して他人のフィードを管理することはできますか?
いいえ、ワークスペースキーでは、自身のワークスペースが所有するフィードのみを表示および管理できます。