Socialync

Socialync MCP サーバー

Socialync ホスト型 MCP サーバーの公式ドキュメント、レジストリマニフェスト、Cursor プラグインです。Socialync はクリエイター向けのクロスポストおよびスケジュール管理ツールです。一度アップロードするだけで、TikTok、Instagram、YouTube、Facebook、X、LinkedIn、Threads、Bluesky に公開できます。

この MCP サーバーを使うと、Claude、ChatGPT、Cursor、Google Antigravity、Gemini CLI、OpenAI Codex、Grok Bot、およびあらゆる MCP 対応 AI エージェントが、ご自身の OAuth 認証済み Socialync アカウントを通じて、ソーシャルメディアの投稿を作成、予約、公開できます。ワークフローには、人間が承認するプロセスが組み込まれています。また、分析データ（閲覧数、いいね、コメント、シェア、保存数、フォロワー数、投稿のパフォーマンスのベストとワースト）を読み取るため、エージェントは実際の成果に基づいて翌週のコンテンツを計画できます。

すべてのプラットフォーム連携は、各プラットフォームの公式 API で動作します。ブラウザーの自動操作、スクレイピング、非公式エンドポイントは使用しません。エージェントが代理でアカウントを制限されることはありません。

重複投稿防止機能により、再試行しても二重に公開されることはなく、失敗した投稿は自動的に再試行されます。エージェントが投稿を行う際には、どちらも重要な機能です。

注記： Socialync のサーバーはホスト型（リモート）で、クローズドソースです。このリポジトリに含まれるのは、ドキュメント、MCP Registry マニフェスト、Cursor プラグインファイルのみです。ここからインストールしたり実行したりするものはありません。

エンドポイント

https://mcp.socialync.io/mcp

トランスポート：Streamable HTTP。ディスカバリードキュメント（ツール、プラットフォーム、認証、制限を JSON 形式で掲載）：https://mcp.socialync.io/.well-known/mcp

MCP と API へのアクセスは無料プランで利用できます。 月額 0 ドル、クレジットカード不要。7 つのプラットフォームで月 5 件まで投稿できます（X は有料プランで利用できます）。エージェントは、誰もカードを用意することなく接続して公開できます。有料プランは、無制限の投稿と 5 アカウント接続で月額 20 ドルからです（Starter は 20 ドル、Creator は 10 アカウントで 30 ドル、Agency は 100 アカウントで 99 ドル、追加アカウントは月額 2 ドルから）。プランと料金。

知っておきたい制限：ブランドごとに API キーは 1 つまで。有料プランでは、ブランドごとに AI が作成できる投稿は 1 日 10 件まで（無料プランでは 5 件まで）です。

認証方法（2 種類）

A）OAuth 2.1（推奨）。 URL をヘッダーなしで追加します。クライアントが自身を登録し（動的クライアント登録、PKCE、クライアントシークレットなし）、ブラウザーを開きます。Socialync アカウントでサインインし、エージェントに管理を許可するブランドを選択します。Claude.ai、Claude Code、Cursor、ChatGPT、Google Antigravity、Gemini CLI、Codex は、いずれもこの方法で自動的に認証します。

B）Bearer API キー。 ブラウザーを使った OAuth フローを完了できないクライアント向けです（Grok Bot、ヘッドレスエージェント、手動編集した設定ファイルなど）。https://www.socialync.io/go/github-api-keys でキーを生成し、Authorization: Bearer <key> を送信します。ブランドごとにキーは 1 つで、すべてのプランに含まれています。キーをコミットしないでください。

エンドツーエンドで動作確認済みの OAuth コールバック（任意の https リダイレクト URI に加え、任意のポートを使用する http://localhost および http://127.0.0.1 を受け付けます）：

• https://www.cursor.com/agents/mcp/oauth/callback
• http://localhost:8787/callback
• https://claude.ai/api/mcp/auth_callback
• http://localhost/callback
• http://127.0.0.1/callback

接続

Claude（claude.ai）： Socialync は Claude のコネクタディレクトリに掲載されています。設定から「コネクタ」、「コネクタを閲覧」の順に開き、Socialync を検索してサインインしてください。代わりに URL で追加するには、「カスタムコネクタを追加」を選択し、上記のエンドポイントを貼り付けてください。詳しい手順はこちらをご覧ください：Socialync MCP コネクタガイド。

Claude Code：

claude mcp add --transport http socialync https://mcp.socialync.io/mcp

Cursor ／ Grok Bot（OAuth、URL のみ）：

{
  "mcpServers": {
    "socialync": {
      "url": "https://mcp.socialync.io/mcp"
    }
  }
}

OAuth を完了できない Grok Bot またはその他のクライアント（Bearer キー）：

{
  "mcpServers": {
    "socialync": {
      "url": "https://mcp.socialync.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_SOCIALYNC_API_KEY"
      }
    }
  }
}

Grok Bot はお使いのマシンではなく、Cursor のクラウドから OAuth を実行します。同じ URL が Cursor IDE では機能しても、Grok Bot では失敗する場合があります。IDE だけでなく、Grok Bot の「設定」から「プラグイン」を開いてテストしてください。OAuth が開始されない場合や、「fetch failed」と表示される場合は、Bearer キー形式を使用してください。

Google Antigravity： これを ~/.gemini/config/mcp_config.json（またはワークスペース内の .agents/mcp_config.json）に追加してください。Antigravity は serverUrl を使用し、動的クライアント登録によって OAuth サインインを自動的に処理します。

{
  "mcpServers": {
    "socialync": {
      "serverUrl": "https://mcp.socialync.io/mcp"
    }
  }
}

Gemini CLI： 拡張機能をインストールしてから、/mcp auth socialync を実行してください。

gemini extensions install https://github.com/JackVitick/socialync-mcp

または、以下を ~/.gemini/settings.json に自分で追加してください。

{
  "mcpServers": {
    "socialync": {
      "httpUrl": "https://mcp.socialync.io/mcp"
    }
  }
}

OpenAI Codex CLI：

codex mcp add socialync --url https://mcp.socialync.io/mcp
codex mcp login socialync

ChatGPT： 開発者モードを有効にし、エンドポイント URL を使ってカスタムコネクタを追加してください。カスタムコネクタを追加できる ChatGPT のプランは変更されているため、お使いのプランについては OpenAI の開発者モードのヘルプページをご確認ください。

OpenClaw：

openclaw mcp add socialync --url https://mcp.socialync.io/mcp --transport streamable-http
openclaw mcp login socialync

その他の MCP クライアント（汎用設定）：

{
  "mcpServers": {
    "socialync": {
      "type": "streamable-http",
      "url": "https://mcp.socialync.io/mcp"
    }
  }
}

Claude Code プラグイン

このリポジトリは Claude Code プラグインであり、独自のプラグインマーケットプレイスでもあります。ホスト型サーバー（.mcp.json、シークレット不要）と、以下のスキルを追加します。

/plugin install socialync --marketplace JackVitick/socialync-mcp

2.1.275 より前の Claude Code バージョンでは、次の 2 つの手順を実行してください。

/plugin marketplace add JackVitick/socialync-mcp
/plugin install socialync@socialync

Socialync のツールが初めて実行されると、ブラウザーでサインインが開きます。セットアップの説明はこちらをご覧ください：SETUP.md。プラグインを使わない場合は、サーバーを直接追加してください（「接続」の Claude Code を参照）。

スキル

6 つのスキルが、サーバーをうまく使う方法をエージェントに教えます。どのスキルも、投稿を公開する前に毎回承認を求めます。

スキル	内容
schedule-social-post	8 つのプラットフォームへの下書き作成、予約投稿、または公開を行います。投稿ごとに承認を求めます
film-once-week-of-shorts	1 回の撮影で、TikTok、Reels、Shorts 向けの 1 週間分の動画を作成します
blog-to-a-week-of-posts	1 本の記事から LinkedIn と X 向けの 1 週間分の投稿を作成し、リンクを最初のコメントに載せます
weekly-what-worked	分析データに基づく週次レビューと、翌週のアイデアを作成します
notes-to-carousel	メモから、Instagram、LinkedIn、Threads 向けのレンダリング済み画像カルーセルを作成します
social-queue-analytics	予約済みの投稿の確認、移動、キャンセルを行い、投稿が失敗した理由を確認できます

インストール方法：

• Claude Code： 上記のプラグインを使用します。
• Cursor、Codex、Windsurf、Gemini CLI、その他のエージェント： npx skills add JackVitick/socialync-mcp
• OpenClaw： openclaw skills install @jackvitick/social-media-scheduler
• Claude（ウェブ版とデスクトップ版）： スキルのフォルダーをダウンロードして ZIP に圧縮し、「カスタマイズ」、「スキル」、「＋」ボタン、「スキルを作成」、「スキルをアップロード」の順に進みます（「設定」、「機能」でコード実行をオンにする必要があります）。

スキルは任意のガイダンスです。スキルがなくてもサーバーは動作します。

Cursor と Grok Bot のプラグイン

このリポジトリは Cursor プラグイン（.cursor-plugin/plugin.json、mcp.json、skills/、assets/logo.png）でもあります。掲載後は Cursor Marketplace から「Socialync」を検索してインストールするか、上記のように MCP URL を直接追加してください。skills/ 内のスキルは、下書きの作成、投稿の予約、1 週間分の投稿の計画、またはキューの確認方法をエージェントに伝えます。提出チェックリストはこちらです：MARKETPLACE-SUBMIT.md。

ツール

28 個のツールがあります。同じ一覧は https://www.socialync.io/.well-known/mcp でも公開されています。

ツール	機能
list_profiles	Socialync のブランドプロフィールを一覧表示します（最初に呼び出してください。書き込みにはすべて profileId が必要です）
list_connections	接続済みで正常なソーシャルアカウントを表示します
list_audiences	投稿のターゲットにできる保存済みオーディエンスを一覧表示します
list_media	Socialync にすでにあるメディアを参照します。動画の添付には mediaId を使用します
create_media_upload / finalize_media_upload	画像または生成済み動画をアップロードします
import-claude-motion-from-url	Claude Motion の動画をライブラリに取り込み、投稿できる状態にします
check_quota	プラン、残りの投稿数、プラットフォームごとの1日あたりの上限、予約可能期間を確認します
validate_post	読み取り専用の事前チェックです。キャプションの長さ、リンク、メディア、アスペクト比、動画の長さ、接続の状態を確認します
create_post_draft	テキストまたは画像の投稿を下書きします（アプリで承認します）
schedule_post_draft	将来の日時に投稿するための、テキスト、画像、または動画の下書きを作成します（アプリで承認します）
get_draft_status	下書きの処理状況を確認します
approve_draft	チャットで確認した後、保留中の下書きを公開します
publish_now	チャットで確認した後、テキストまたは画像の投稿をすぐに公開します
publish_scheduled	TikTok や YouTube への動画投稿を含め、チャットで確認した後、投稿を直接予約します
create_x_article_draft / publish_x_article_now	長文形式の X Articles を作成・公開します（X Premium アカウントが必要です）
get_scheduled_posts	今後の予約投稿を一覧表示します
update_scheduled_post	予約投稿の日時、キャプション、タイトル、または最初のコメントを変更するか、プラットフォームを削除します
delete_scheduled_post	予約投稿をキャンセルします
get_post_history	公開済み投稿の履歴とステータスを確認します
get_top_posts	動画の視聴時間や3秒時点の視聴維持率を含む、パフォーマンスが最も高いコンテンツを表示します
get_post_insights	個々の投稿を詳しく確認します。視聴維持率の推移、最も大きな離脱箇所、プラットフォームごとの比較を表示します（アプリ対応クライアントではインタラクティブなグラフを表示します）
get_comments	投稿のコメントと返信を読み取ります
reply_to_comment	チャットで確認した後、1件のコメントに返信します（Instagram、Threads、LinkedIn Pages、Bluesky）
get_best_times	独自の投稿履歴に基づく、プラットフォームごとの最適な投稿時間帯を表示します
get_analytics	フォロワーとエンゲージメントの分析データを取得します
generate_content	AI で各プラットフォームに適したキャプションを生成します（有料プラン）

テキストと画像の投稿は、Instagram、Facebook、X、LinkedIn、Threads、Bluesky にすぐに公開されます。TikTok や YouTube（タイトルが必要です）を含む動画投稿は、Socialync ライブラリでホストされているメディア、または公開動画 URL を使った予約投稿として公開されます。動画ファイルをそのままチャットに貼り付けることはできません。まず Socialync にアップロードしてください。

推奨される呼び出し順、プラットフォームごとの制限、エラー処理を含む完全なリファレンスは、docs/tools.md をご覧ください。

MCP による分析

Socialync は TikTok、YouTube、Instagram、Facebook、Threads、Bluesky の投稿とアカウントの分析データを収集し、MCP サーバーは Socialync の分析ページと同じ数値を返します（有料プラン）。

• get_analytics は、過去1週間または1か月のビュー、いいね、コメント、シェア、保存、フォロワーの合計、前の期間との比較、任意のプラットフォーム別内訳、グラフ用の日別時系列データを返します。
• get_top_posts は、ビュー、いいね、コメント、シェア、エンゲージメント率、パフォーマンスのステータス（バイラル、好調、平均的、不調）を含む投稿を返します。エンゲージメント順または日付順に並べ替えられ、プラットフォームと最低ステータスで絞り込めます。
• get_post_history は、どのプラットフォームに何が投稿されたかを返します。失敗した投稿については、わかりやすい理由と再試行のヒントも表示します。

Bluesky ではエンゲージメントは報告されますが、ビューは報告されないため、投稿はエンゲージメントのみで評価されます。

ワークフローの例

接続済みのエージェントに貼り付けてください。ツール名を指定するかどうかは任意ですが、実行内容を追いやすくなります。上記の各スキルの末尾には、貼り付けて使える「試してみる」プロンプトがあります。

うまくいった内容をもとに今週の計画を立てる

get_top_posts を使って、過去30日間の最もパフォーマンスが良かった投稿を5件取得し、共通点を教えてください。そのスタイルで、今週の投稿アイデアを5つ提案してください。

1週間分の投稿を作成してスケジュールする

各アイデアを TikTok、Instagram、LinkedIn、Threads 向けの投稿にし、それぞれのプラットフォームに合ったキャプションを付けてください。すべての投稿で validate_post を実行し、その後、私の現地時間で月曜日から金曜日の午後6時に下書きとしてスケジュールし、承認用に一覧表示してください。

1本の動画をあらゆる場所に投稿する

list_media で最新の動画を一覧表示してください。最新の動画を、明日の午後5時に TikTok、Instagram Reels、YouTube Shorts にスケジュールしてください。YouTube のタイトル：「How I edit a Short in 10 minutes」。スケジュールする前にすべて表示してください。

週次レポート

get_analytics を使って、過去1週間を by_platform で内訳表示してください。どのプラットフォームが成長し、どのプラットフォームが低迷したか、それぞれで最もパフォーマンスが良かった投稿を教えてください。

投稿キューを確認する

get_scheduled_posts で来週の投稿を表示し、get_post_history で今週失敗した投稿も表示してください。

人間が承認に関与する仕組み

Socialync は、接続されているすべてのエージェントに、投稿の正確な内容（プラットフォームごとの投稿先、テキスト、メディア、日時）を表示し、publish_now、publish_scheduled、または approve_draft を呼び出す前に、チャットであなたの承認を待つよう指示します。これらのツールは破壊的な操作としてマークされているため、Claude などのクライアントは実行前にあなたの許可を求めます。このリポジトリのスキルも、複数の投稿をまとめて処理する場合に同じように動作します。各投稿の全内容を番号付きで表示し、あなたが承認した番号の投稿だけが公開されます。TikTok の場合、エージェントは各動画の視聴者（Everyone、Friends、Followers、Only me）を誰にするか尋ね、あなたに代わって選ぶことはありません。アプリ内で確認する場合は、下書きを依頼してください。create_post_draft と schedule_post_draft は Socialync で承認できるよう保存し、承認するまで何も公開されません。

Socialync 自体による2回目の確認を行うには、Socialync の設定で確認ダイアログを有効にしてください。MCP エリシテーションに対応したクライアントでは、公開前に投稿が表示され、却下すると公開が停止されます。

Socialync はあなたが承認した内容をそのまま公開し、各投稿を誰がいつ承認したかを記録します。投稿はあなたが接続したアカウントを通じて公開され、アカウントはいつでも切断できます。無人で投稿するモードはありません。

リンク

• ウェブサイト：socialync.io
• MCP 機能の概要：socialync.io/features/mcp
• コネクター設定ガイド：socialync.io/mcp-connector-guide
• ディスカバリードキュメント：socialync.io/.well-known/mcp
• 公式 MCP レジストリ：io.github.JackVitick/socialync
• 利用規約：socialync.io/terms-of-service
• 開発者契約（API および MCP）：socialync.io/developer-terms
• プライバシーポリシー：socialync.io/privacy-policy

サポート

質問や問題がある場合は、こちらで issue を作成するか、[email protected] までメールでお問い合わせください。

Socialync をフォロー

• X：https://x.com/Socialync_io
• Instagram：https://www.instagram.com/socialync.io/
• TikTok：https://www.tiktok.com/@socialync.io
• YouTube：https://www.youtube.com/@Socialync-io
• LinkedIn：https://www.linkedin.com/company/socialync
• Threads：https://www.threads.com/@socialync.io
• Bluesky：https://bsky.app/profile/socialync.bsky.social