HumanPost

HumanPost MCP とエージェントプラグイン

HumanPost の公式連携パッケージです。AI アシスタントからソーシャルアカウントを管理し、動画や画像の下書きを作成し、承認済みコンテンツをキューに登録して、人による投稿状況や分析を確認できます。

HumanPost はホスト型 MCP サービスを運営しています。このリポジトリにはクライアント設定と公開スキルが含まれており、ホスト型サーバーの実装は含まれていません。HumanPost アカウントと会社へのアクセス権が必要です。OAuth 対応クライアントでは HumanPost にサインインします。会社単位の API キーも手動設定で引き続き利用できます。サービスの利用や一部の操作には、HumanPost のプランに応じて料金が発生する場合があります。

接続

• トランスポート：Streamable HTTP
• エンドポイント：https://humanpost.com/mcp
• 認証：S256 PKCE と動的クライアント登録を使用した OAuth 2.1 認可コードフロー。会社単位の API キーもサポートされています。
• セットアップとツール · API リファレンス · エージェント向け完全ドキュメント

Dashboard → Settings → API & MCP でキーを作成してください。accounts:read から始め、ワークフローで必要なスコープのみを追加してください。各キーは 1 つの会社に属します。クライアントのシークレット設定に保存し、コミットしたり、会話に貼り付けたりしないでください。OAuth ユーザーは同意画面で会社を 1 つ選び、最小限の権限を指定します。書き込みはデフォルトで無効です。アクセストークンの有効期限は 15 分です。リフレッシュトークンはローテーションし、有効期限は 7 日間です。Settings → API Keys で接続を取り消せます。このパッケージに認証情報は含まれていません。

Cursor

Cursor プラグインは標準の OAuth エンドポイントを使用します。プラグインをインストールし、Cursor の接続アクションを使用して HumanPost にサインインしてください。手動で設定する場合：

{
  "mcpServers": {
    "humanpost": { "url": "https://humanpost.com/mcp" }
  }
}

代わりに会社の API キーを使用する場合は、非公開の Cursor 設定で、Bearer ${env:HUMANPOST_API_KEY} を指定した Authorization ヘッダーを設定してください。

Cline

config-cline.json を Cline の MCP 設定にマージしてください。ローカル設定の YOUR_HUMANPOST_API_KEY を、スコープを設定したキーに置き換えてください。この設定ファイルは非公開にしてください。トランスポートの値は streamableHttp です。autoApprove は空のままにして、ツール呼び出しを確認してください。Cline CLI はデフォルトで ~/.cline/data/settings/cline_mcp_settings.json を使用し、分離された設定には CLINE_MCP_SETTINGS_PATH をサポートしています。

Claude Code

このリポジトリをマーケットプレイスとして追加し、プラグインをインストールしてください。

/plugin marketplace add HumanPost-co/humanpost-mcp
/plugin install humanpost@humanpost

Claude Code を起動する前に、プロセス環境で HUMANPOST_API_KEY を設定してください。または、プロジェクト内の .mcp.json エントリを使用してください。互換性用の .mcp.json は、環境変数で指定された API キーを使用します。代わりにネイティブ OAuth を使用するには、claude mcp add --transport http humanpost https://humanpost.com/mcp を実行し、Claude Code の MCP 認証フローを使用してください。Claude のウェブディレクトリでの承認は、このプラグインのインストールとは別です。

Grok Build

Grok Build は Claude 互換プラグインをサポートしています。マーケットプレイスコマンドを使用してリポジトリを追加してください。

grok plugin marketplace add HumanPost-co/humanpost-mcp

Marketplace タブから humanpost をインストールし、クライアント環境で HUMANPOST_API_KEY を指定してください。このパッケージには .grok-plugin/plugin.json と .claude-plugin/plugin.json の両方が含まれています。有効にする前に、設定済みの MCP を確認してください。公式マーケットプレイスへの掲載は、この発行元のマーケットプレイスを追加することとは別です。

Grok Bot

Grok Bot には独立したアプリディレクトリへの提出フォームがあり、Cursor も対象となります。上記の Grok Build CLI の手順は Build に適用されますが、Bot アプリプラグインはインストールされません。このリポジトリには、Cursor のマーケットプレイスマニフェストと、アプリディレクトリ審査用の標準 OAuth MCP エントリが含まれています。

Bot 専用の掲載はまだ確認されていません。提出フォームでは、アプリ内での実際のテストが必須です。バックエンド SDK テストとブラウザーでの OAuth 同意確認は別途記録されており、その証明の代わりにはなりません。

Muse Code

config-muse.json の mcp_servers.humanpost エントリを Muse Code の設定に統合します。Muse が文書化している streamable_http トランスポートと ${HUMANPOST_API_KEY} 環境変数の展開を使用します。公開スキルをインストールするには、次を実行します。

muse skills install ./skills/humanpost-publishing --scope user

Muse Code の設定と、コンシューマー向け Muse ディレクトリへのコネクターの掲載は別のものです。コンシューマー向けディレクトリでの承認は主張していません。

Agent Skills / skills.sh / OpenClaw

npx skills add HumanPost-co/humanpost-mcp --skill humanpost-publishing

このスキルは、接続された MCP、または HTTP リクエストを実行できるホスト上で、文書化された REST API を使用します。ホストに備わっていないネットワーク機能やシェル機能を提供することはできません。スキルをインストールしても、認証情報は設定されず、会社へのアクセス権も付与されません。

ChatGPT and Codex

ルートの plugin.json と mcp.json は、移植可能な Agent Plugins 形式を使用します。移植可能な MCP エントリは OAuth エンドポイントを使用し、認可サーバーを検出します。

OpenAI ポータルにアップロードするには、リリースの humanpost-openai-plugin-1.0.2.zip を使用します。ルートの mcp.json は、openai/mcp.json にある文書化済みの OpenAI 認証拡張機能を使用し、DCR を使った OAuth と、デフォルトで読み取り専用のスコープを設定します。この別個のバンドルにより、他のホストとの厳格な移植可能スキーマ互換性が保たれます。クライアントシークレット、アクセストークン、API キーは同梱されていません。

エンドポイントはデプロイ済みであり、分離されたテスト会社を使用して、ブラウザーでの同意、スコープの適用、更新、取り消しを実環境でテスト済みです。OpenAI の開発者本人確認、パブリッカーの設定、マーケットプレイスの審査は引き続き必要です。パッケージの準備が完了していても、掲載が承認されたことにはなりません。

公開済みリリースを再現するには、まず対応する Git タグをチェックアウトしてから、python3 scripts/build_release.py --output-dir /tmp/humanpost-release で両方のアーカイブをビルドします。それ以降のドキュメントへのコミットによって、すでに公開済みのアーカイブが変更されることはありません。

一般的なワークフロー

1. get_context を呼び出して会社とスコープを確認し、次に list_accounts を呼び出して正しいアカウントを選択します。
2. 検出されたツールを使って、アカウント、投稿キュー、下書き、分析データを確認します。
3. メディアをアップロードし、レビュー用の下書きを準備します。必要に応じて、実際のプレビューをリクエストします。
4. ユーザーの認可範囲内でのみコンテンツをキューに入れます。再試行時は、冪等性キーと返された操作 ID を保持してください。
5. 作成された投稿／タスクのステータスを確認します。キュー登録済みや承認待ちの状態は、公開が確定したことを意味しません。

サーバーはツールカタログを公開し、各ツールの呼び出し時にキーのスコープを適用します。ツールを検出しただけでは、そのツールの呼び出し権限は付与されません。アカウントのプロビジョニング、タスクの作成、レンダリング、投稿、スケジュールの変更、キャンセルは、外部への影響やクレジットの消費を引き起こす場合があります。すべてのツールを自動承認しないでください。利用可能なツールとスキーマは、ライブのツール検出によって決まります。詳細と制限事項については、公開ドキュメントを参照してください。

セキュリティとネットワークアクセス

OAuth クライアントは humanpost.com/mcp に接続し、同じ HumanPost オリジン上の認可エンドポイントを検出します。API キーを使う互換性設定では、キーは HumanPost の Firebase ホスト型サービスである us-central1-clickbaitcarousel.cloudfunctions.net/mcp にのみ送信されます。REST フォールバックも、同じホストの /publishingApi を使用します。ドキュメントへのリンク先は humanpost.com です。アップロードでは、サービスが発行した署名付きストレージ URL が使われる場合があります。その URL に API キーを送信しないでください。このパッケージには、ライフサイクルフック、バックグラウンドプロセス、テレメトリー、依存関係インストーラー、リモートコード実行機能はありません。

キーを使わずに読み取り専用のヘルスチェックを行うには、python3 scripts/check_endpoint.py を実行すると、公開エンドポイントが未認証の初期化を拒否することを確認できます。認証済み接続テストは HumanPost ダッシュボードから利用できます。認証なしのチェックに成功しても、すべてのツールや会社のワークフローが検証されたことにはなりません。

プライバシーとサポート

ホステッドサービスは、接続または API キーによって認証された会社のアカウント、コンテンツ、タスク、分析データを処理します。HumanPost プライバシーポリシーと利用規約をご確認ください。[email protected]にお問い合わせいただくか、統合に関する問題を報告してください。公開の問題報告には、認証情報や顧客の非公開コンテンツを絶対に含めないでください。

統合パッケージは MIT ライセンスです。このライセンスでは、ホステッド HumanPost サービスおよび HumanPost のブランドは許諾されません。プラットフォーム互換性設定や提出によって、マーケットプレイスの推奨や承認が示されるわけではありません。