qpost-mcp

qpost-mcp

QPost 用 MCP サーバーです。QPost の REST API を通じて、AI エージェントが YouTube、TikTok、Instagram に動画や画像の投稿を予約・公開できます。

インストール

QPost ダッシュボード（Settings → API Keys）から API キーを生成し、以下の 2 つの方法から選択してください。

ホステッド（推奨 — インストール不要）

QPost は Streamable HTTP 経由で、同じサーバーを https://qpost.dev/mcp で実行しています。

claude mcp add --transport http qpost https://qpost.dev/mcp \
  --header "x-api-key: YOUR_API_KEY"

Streamable HTTP に対応する MCP クライアントであれば、x-api-key（または Authorization: Bearer）ヘッダーを設定して、この URL を指定できます。エンドポイントはステートレスなので、セッションを管理する必要はありません。

ローカル（stdio）、npx 経由

QPost をセルフホストする場合や、サーバーを自分で実行する場合に使用してください。

claude mcp add qpost -e QPOST_API_KEY=your_key_here -- npx -y qpost-mcp

Claude Desktop／その他の MCP クライアント

{
  "mcpServers": {
    "qpost": {
      "command": "npx",
      "args": ["-y", "qpost-mcp"],
      "env": {
        "QPOST_API_KEY": "your_key_here"
      }
    }
  }
}

QPost をセルフホストする場合は、QPOST_BASE_URL も設定してください（デフォルトは https://qpost.dev です）。

ツール

ツール	説明
list_connected_accounts	接続済みの YouTube／TikTok／Instagram アカウントとそのステータスを一覧表示します
create_post	URL またはローカルパスから動画や画像のメディアを指定して、投稿を作成し、公開（または予約）します
list_posts	投稿を一覧表示します。ステータスやプラットフォームで絞り込むこともできます
get_post	ID を指定して単一の投稿を取得します
update_post	投稿のキャプション／予約日時／タイムゾーン／ステータスを更新します
delete_post	投稿を削除します
retry_post	失敗した投稿を再試行します

メディアの扱いはトランスポートによって異なります

ローカルの stdio サーバーはマシン上のファイルを読み取れるため、create_post では mediaUrl に加えて mediaPath も指定できます。ホステッドエンドポイントからディスクにはアクセスできないため、mediaUrl／imageUrls、または MIME タイプを指定するための任意の mediaFilename を付けた mediaBase64 を使用します。

完全なリクエスト／レスポンスの形式と、プラットフォームごとのメタデータオプション（YouTube のカテゴリ／プライバシー、TikTok のプライバシーレベル、Instagram のメディアタイプなど）は、qpost.dev/docs に記載されています。このサーバーは、同じ REST API を薄くラップしたものです。

ローカル開発

npm install
npm run dev   # runs src/index.ts directly via tsx
npm run build # compiles to dist/

ライセンス

MIT