PostFast MCPサーバー

Name: postfast-mcp
Author: peturgeorgievv-factory

PostFast API用のMCPサーバーです。Claude、Cursor、VS CodeなどのAIツールを使用して、ソーシャルメディア投稿のスケジュールと管理を行います。

クイックスタート

1. APIキーを取得する

PostFastにログインし、サイドバーのAPIに移動してキーを生成します。

2. インストール

お好みの方法を選択してください：

Claude Desktop（推奨）

Claude Desktop拡張機能ディレクトリから拡張機能をダウンロードするか、手動でインストールします：

claude_desktop_config.jsonに追加します：

{
  "mcpServers": {
    "postfast": {
      "command": "npx",
      "args": ["-y", "postfast-mcp"],
      "env": {
        "POSTFAST_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Desktopを再起動します。

Claude Code

プラグイン経由（マーケットプレイスの承認待ち）：

/plugin install postfast@claude-plugins-official

インストール後、APIキーを設定します。以下のいずれかを選択してください：

# Option A: Add to your shell profile (~/.zshrc or ~/.bashrc)
export POSTFAST_API_KEY="your-api-key-here"

# Option B: Add to ~/.claude/settings.local.json
# { "env": { "POSTFAST_API_KEY": "your-api-key-here" } }

その後、Claude Codeを再起動します。

手動設定経由：

プロジェクトの.mcp.jsonまたは~/.claude/.mcp.json（グローバル）に追加します：

{
  "mcpServers": {
    "postfast": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "postfast-mcp"],
      "env": {
        "POSTFAST_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor / VS Code / Windsurf / その他のMCPクライアント

MCP設定（.mcp.json、mcp.json、またはツールの設定UI）に追加します：

{
  "mcpServers": {
    "postfast": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "postfast-mcp"],
      "env": {
        "POSTFAST_API_KEY": "your-api-key-here"
      }
    }
  }
}

3. 使用方法

AIアシスタントに以下のように尋ねてください：

「接続されているソーシャルアカウントをリストアップして」
「明日の午前9時にInstagramへの投稿をスケジュールして」
「今週のスケジュール済み投稿をすべて見せて」
「この画像をアップロードして、それを使ったLinkedIn投稿を作成して」
「この動画でFacebookリールを作成して」
「今月のInstagram投稿の分析を見せて」

利用可能なツール

ツール	説明
`list_accounts`	接続されているソーシャルメディアアカウントをリストアップ
`list_posts`	フィルター（プラットフォーム、ステータス、日付範囲）付きで投稿をリストアップ
`create_posts`	投稿を作成およびスケジュール（一括、最大15件）
`delete_post`	IDで投稿を削除
`upload_media`	ローカルファイルをアップロードしてメディアキーを取得（全フローを処理）
`get_upload_urls`	メディアファイルをアップロードするための署名付きURLを取得
`list_pinterest_boards`	アカウントのPinterestボードを取得
`list_youtube_playlists`	アカウントのYouTubeプレイリストを取得
`generate_connect_link`	クライアントがアカウントを接続するためのリンクを生成
`get_post_analytics`	公開済み投稿のパフォーマンス指標を取得 — Instagram、Facebook、TikTok、Threads、YouTube、LinkedIn（会社ページ）

対応プラットフォーム

Facebook、Instagram、X (Twitter)、TikTok、LinkedIn、YouTube、BlueSky、Threads、Pinterest、Telegram

プラットフォーム固有のコントロール

投稿を作成する際、controlsパラメーターを介してプラットフォーム固有の設定を渡すことができます：

プラットフォーム	コントロール
X (Twitter)	`xCommunityId`, `xQuoteTweetUrl`, `xRetweetUrl`
Instagram	`instagramPublishType` (TIMELINE/STORY/REEL), `instagramPostToGrid`, `instagramCollaborators`
Facebook	`facebookContentType` (POST/REEL/STORY), `facebookAllowComments`, `facebookPrivacy`, `facebookReelsCollaborators`
TikTok	`tiktokPrivacy` (PUBLIC/MUTUAL_FRIENDS/FOLLOWER_OF_CREATOR/ONLY_ME), `tiktokIsDraft`, `tiktokAllowComments`, `tiktokAllowDuet`, `tiktokAllowStitch`, `tiktokBrandOrganic`, `tiktokBrandContent`, `tiktokAutoAddMusic`, `tiktokIsAigc`
YouTube	`youtubeTitle`, `youtubePrivacy` (PUBLIC/PRIVATE/UNLISTED), `youtubeTags`, `youtubeCategoryId`, `youtubeIsShort`, `youtubeMadeForKids`, `youtubePlaylistId`, `youtubeThumbnailKey`
Pinterest	`pinterestBoardId` (必須), `pinterestLink`
LinkedIn	`linkedinAttachmentKey`, `linkedinAttachmentTitle`

メディアアップロード

upload_mediaツールは、1回の呼び出しで全フローを処理します：

ファイル拡張子からコンテンツタイプを検出
PostFastから署名付きアップロードURLを取得
ファイルをアップロード
create_postsで使用可能なkeyとtypeを返す

対応フォーマット：JPEG、PNG、GIF、WebP、MP4、WebM、MOV

アップロードプロセスをより詳細に制御する必要がある場合は、get_upload_urlsを直接使用することもできます。

環境変数

変数	必須	説明
`POSTFAST_API_KEY`	はい	ワークスペースのAPIキー
`POSTFAST_API_URL`	いいえ	APIベースURL (デフォルト: `https://api.postfa.st`)

テスト

MCP Inspectorを使用してすべてが動作することを確認します：

POSTFAST_API_KEY=your-key npx @modelcontextprotocol/inspector npx postfast-mcp

APIドキュメント

完全なREST APIドキュメント：postfa.st/docs

開発

npm install
npm run build
node dist/index.js

バッジ

peturgeorgievv-factory/postfast-mcp MCP server

ライセンス

MIT

postfast-mcp