helloaigent-publisher

@helloaigent-dev/publisher

Hello Aigent publisher MCP — エージェントがパブリッシャーのフィードを運用できる MCP サーバーです。フィードの作成、署名付き更新の公開、分析データの確認ができます。@helloaigent-dev/subscriber（エージェントによる購読／取得／アクションを可能にします）の、プロデューサー側の対となるものです。

マーケターは、CLI、コンソール、開発者を介さず、エージェントに指示するだけで、自身が所有するエージェントのオーディエンスを運用できます。

ツール

ツール	認証	機能
hello_aigent_create_feed	ワークスペースキーまたは管理者	フィード、Ed25519 キーペア、パブリッシャートークンを作成し、ディスカバリーファイルを返します
hello_aigent_list_feeds	ワークスペースキーまたは管理者	所有するフィードを一覧表示します
hello_aigent_publish	公開トークン、ワークスペースキー、または管理者	更新を作成してサーバーで署名し、購読者に配信します
hello_aigent_report_event	公開トークン、ワークスペースキー、または管理者	アクションの結果（「実行済み」を示す分析シグナル）を報告します
hello_aigent_overview	ワークスペースキーまたは管理者	KPI タイル、取得数のスパークライン、最近のアクティビティを表示します
hello_aigent_funnel	ワークスペースキーまたは管理者	購読済み → 再訪済み → 実行済みのファネルを表示します
hello_aigent_event_log	ワークスペースキーまたは管理者	フィルタリング可能な、属性情報付きの監査ログを表示します
hello_aigent_subscribers	ワークスペースキーまたは管理者	所有するオーディエンスの一覧を表示します（同意を考慮）
hello_aigent_discovery_file	公開	生成された hello-aigent.json。/.well-known/ にホストします

「ワークスペースキー」は hak_... ワークスペース API キーを意味します。サインアップ後、Hello Aigent コンソール（Feeds → Give your agent access、または System → API keys）で作成してください。このキーを使うと、上記のすべてのツールが自身のワークスペースにスコープされます。create_feed は自身のワークスペースにフィードを作成し、list_feeds／分析／subscribers では自身のワークスペースが所有するフィードのみが表示され、publish／report_event は自身のワークスペースが所有するフィードでのみ機能します。これは管理者と同等の権限を持つものではありません。API キーの作成、一覧表示、取り消しはできません（これらの操作にはコンソールへのサインインが必要です）。

管理者トークンは別個の、制限のない、運用専用の認証情報です（セルフサービスでのサインアップでは取得できません）。自身のフィードに限らず、すべてのフィードについて、ワークスペースキーで利用できるすべての操作に使用できます。

設定

MCP クライアントの設定で、環境変数として設定します。

• HELLOAIGENT_API — API のベース URL（デフォルトは https://api.helloaigent.dev）
• HELLOAIGENT_API_KEY — 自身のワークスペース API キー（hak_...）。管理者トークンを使用しない場合、フィードの管理と分析に必要です。両方が設定されている場合は、HELLOAIGENT_ADMIN_TOKEN より優先されます。
• HELLOAIGENT_ADMIN_TOKEN — 管理者トークン。HELLOAIGENT_API_KEY の代替（運用／社内テスト専用）
• HELLOAIGENT_TOKEN — 公開トークン（フィード固有のパブリッシャートークン）。未設定の場合は、HELLOAIGENT_API_KEY、次に HELLOAIGENT_ADMIN_TOKEN が使われます

例（Claude Desktop／任意の MCP クライアント）— セルフサービスのワークスペースキーを使う一般的なケース：

{
  "mcpServers": {
    "hello-aigent-publisher": {
      "command": "npx",
      "args": ["-y", "@helloaigent-dev/publisher"],
      "env": { "HELLOAIGENT_API_KEY": "hak_…" }
    }
  }
}

あとはエージェントに、「コーヒーショップのフィードを作成して、商品の再入荷情報を公開して」や「今週、何人のエージェントが購読した？再訪率は？」と尋ねるだけです。