Recurpost

RecurPost MCP サーバー

AI アシスタントから RecurPost のソーシャルメディア管理 API を利用できるようにする MCP（Model Context Protocol） サーバーです。

何ができますか？

• 接続済みのソーシャルアカウントとコンテンツライブラリを一覧表示する
• ワークスペースを一覧表示し、メンバーになっている任意のワークスペースで作業する
• コンテンツをすぐに投稿する、または後で投稿するように予約する
• 繰り返し投稿やエバーグリーン投稿に使うコンテンツをライブラリに追加する
• エンゲージメント指標付きで投稿履歴を確認する
• AI でソーシャルメディア用コンテンツや画像を生成する
• 新しいソーシャルアカウントを接続するための URL を取得する

セットアップ

1. API キーを取得する

1. RecurPost にログインします
2. Account Settings に移動します
3. API Password Key を生成します（ログインパスワードではありません）

2. インストールする

Claude Desktop（推奨）：ワンクリック拡張機能

macOS と Windows で動作します。ほかにインストールするものはありません。Claude Desktop は内蔵の Node.js で拡張機能を実行します。

1. recurpost.mcpb をダウンロードします。
2. ファイルをダブルクリックするか、Claude Desktop の Settings > Extensions にドラッグして、Install をクリックします。
3. 求められたら、RecurPost のメールアドレスと API Password Key を入力します。キーはプレーンテキストファイルではなく、オペレーティングシステムのキーチェーンに保存されます。

RecurPost のツールは、新しいチャットですぐに利用できます。更新するには、最新のファイルをダウンロードして再度インストールします。

手動セットアップ

以下の手動での方法には Node.js 18 以降が必要です。ターミナルで node -v を実行してもバージョンが表示されない場合は、https://nodejs.org から LTS インストーラーをダウンロードしてください。

macOS の Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "recurpost": {
      "command": "npx",
      "args": ["-y", "recurpost-mcp"],
      "env": {
        "RECURPOST_EMAIL": "[email protected]",
        "RECURPOST_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Desktop を完全に終了し（ウィンドウを閉じるだけではなく Cmd+Q を押します）、再度開きます。

Windows の Claude Desktop

Windows では npx を使用しないでください。Windows には npx 実行ファイルがありません（npx.cmd のみで、Claude Desktop からは起動できません）。また、cmd /c 経由でも、初回のパッケージダウンロードには通常 60 秒のハンドシェイク制限を超える時間がかかるため、サーバーは「実行中」と表示されても、呼び出しはすべて失敗します。

パッケージを一度インストールしたら、Claude Desktop から直接パッケージを指定します。

1. コマンドプロンプトを開き、次を実行します。

   npm install -g recurpost-mcp
   

2. インストール先を確認します。次のコマンドでグローバルフォルダーが表示されます。

   npm root -g
   

   通常は C:\Users\YOUR-USERNAME\AppData\Roaming\npm\node_modules です。

3. まず Claude Desktop を完全に終了します。 ウィンドウを閉じるだけでは不十分です。システムトレイの Claude アイコンを右クリックして Quit を選ぶか、タスクマネージャーですべての Claude.exe を終了します。アプリは終了時に設定ファイルを書き換えるため、起動中に行った編集は破棄されます。

4. %APPDATA%\Claude\claude_desktop_config.json を開き、手順 2 のフォルダーを使って、以下に示すとおりバックスラッシュを 2 つずつ入力して追加します。

   {
     "mcpServers": {
       "recurpost": {
         "command": "C:\\Program Files\\nodejs\\node.exe",
         "args": [
           "C:\\Users\\YOUR-USERNAME\\AppData\\Roaming\\npm\\node_modules\\recurpost-mcp\\build\\index.js"
         ],
         "env": {
           "RECURPOST_EMAIL": "[email protected]",
           "RECURPOST_API_KEY": "your-api-key"
         }
       }
     }
   }
   

   メモ帳で保存する場合は、ファイルの種類を すべてのファイル に設定してください（そうしないと、気付かないうちに .txt が追加されます）。また、エンコードは UTF-8 with BOM ではなく UTF-8 に設定してください。

5. Claude Desktop を起動します。数秒以内にツールが表示されます。

macOS / Linux の Claude Code

claude mcp add recurpost --scope user \
  -e [email protected] \
  -e RECURPOST_API_KEY=your-api-key \
  -- npx -y recurpost-mcp

Windows の Claude Code

1 行で指定します（上記のバックスラッシュによる改行は bash 専用です）。npm install -g recurpost-mcp の後に、次を実行します。

claude mcp add recurpost --scope user -e [email protected] -e RECURPOST_API_KEY=your-api-key -- "C:\Program Files\nodejs\node.exe" "C:\Users\YOUR-USERNAME\AppData\Roaming\npm\node_modules\recurpost-mcp\build\index.js"

どのプラットフォームでも、-e フラグは -- より前に指定する必要があります。-- の後の内容はサーバーコマンドに渡されるため、サーバーは認証情報なしで起動します。--scope user を指定すると、すべてのプロジェクトでサーバーを利用できます。省略すると、現在のプロジェクトのみに追加されます。

3. 動作を確認する

"Verify my RecurPost connection"（user_login を実行）と質問し、続けて "Show me all my connected social accounts" と質問します。

トラブルシューティング

Claude Desktop はサーバーごとにログを書き込みます。

• macOS：~/Library/Logs/Claude/mcp-server-recurpost.log
• Windows：%APPDATA%\Claude\logs\mcp-server-recurpost.log

表示される内容	原因	対処方法
Settings > Developer にサーバーがまったく表示されず、ログファイルもない	設定が読み込まれていません。.json.txt として保存された、BOM 付きで保存された、または終了時にアプリによって上書きされた可能性があります	すべてのファイル／UTF-8 として再保存し、編集前に Claude を完全に終了してください
ログに spawn npx ENOENT と表示される	Windows から npx を起動できません	上記の Windows 用設定（node.exe ＋フルパス）を使用してください
サーバーは実行中と表示されるものの、initialize から約 60 秒後にログに Request timed out と表示され、すべての呼び出しが失敗する	npx の起動にハンドシェイクの制限時間を超える時間がかかりました	同じ対処方法です。グローバルにインストールし、node.exe で直接起動してください
ツールの結果に Could not reach https://social.recurpost.com ... [ENOTFOUND] または [ECONNREFUSED] と表示される	起動されたプロセスが機能するネットワークに接続できません	VPN／プロキシ／ウイルス対策ソフトを確認してください。ターミナルでは node -e "fetch('https://social.recurpost.com')" が動作するのに Claude からは動作しない場合、アプリが子プロセスをサンドボックス化しています
Error: RECURPOST_EMAIL and RECURPOST_API_KEY environment variables are required.	認証情報が env に設定されていないか、Claude Code で -- の後に指定されています	env ブロック内、または -- の前に移動してください

利用可能なツール

ツール	説明
user_login	API 認証情報を確認します
workspace_list	メンバーになっているすべてのワークスペース（自分のものと共有されたもの）を一覧表示します
social_account_list	接続済みのソーシャルメディアアカウントをすべて一覧表示します
library_list	すべてのコンテンツライブラリを一覧表示します
connect_social_account_urls	新しいソーシャルアカウントを接続するための URL を取得します
history_data	ソーシャルアカウントの投稿履歴を取得します
post_content	ソーシャルアカウントにコンテンツを投稿するか、投稿予約します
add_content_in_library	定期投稿用のコンテンツをライブラリに追加します
generate_content_with_ai	AI でソーシャルメディア投稿文を生成します
generate_image_with_ai	テキストの説明から画像を生成します

ワークスペース

social_account_list、library_list、history_data、post_content、add_content_in_library は、省略可能な workspace_id（workspace_list の ws_id）を受け付けます。省略した場合は、デフォルトのワークスペースが使用されます。指定した場合、結果と操作はそのワークスペースに限定されます。ソーシャルアカウントとライブラリは、そのワークスペースに属している必要があります。

プロンプトの例

• 「接続済みのソーシャルアカウントをすべて表示して」
• 「明日の午前 9 時に Facebook ページで夏のセールに関する投稿を予約して」
• 「リモートワークの生産性向上のヒントについて、LinkedIn の投稿を生成して」
• 「今週、Twitter アカウントでどの投稿が公開された？」
• 「ソーシャルメディアマーケティングに関する、いつでも使えるヒントを 5 つ『Tips』ライブラリに追加して」
• 「ワークスペースを一覧表示してから、『Client A』ワークスペースのソーシャルアカウントを表示して」

セキュリティ

• 認証情報はローカル設定に保存され、RecurPost API との直接認証を除き、お使いのマシンの外部に送信されることはありません
• サーバーはサブプロセスとしてローカルで実行されます。外部サーバーは関与しません
• API キーとメールアドレスは環境変数経由で渡され、AI モデルに公開されることはありません

ライセンス

MIT