Threads by 1Social

1Social MCP

ソーシャルネットワークへの投稿を行う、OAuth で保護された Model Context Protocol サーバーです。

1Social MCP を使うと、AI アシスタントがあなたに代わって投稿できます。Claude、ChatGPT、Cursor、VS Code、または CLI クライアントを 1Social に接続して、Instagram、TikTok、X、LinkedIn、Bluesky、Threads、Facebook、YouTube Shorts への投稿、予約、確認、修正を自然言語で行えます。

• サーバー URL： https://mcp.1social.dev/mcp
• トランスポート： Streamable HTTP
• 認証： PKCE と Dynamic Client Registration による OAuth 2.1
• 紹介と設定： 1social.dev/mcp

インストール

1Social MCP はリモートの、OAuth で保護されたサーバーです。インストールするパッケージも、貼り付ける API キーもありません。クライアントの MCP 設定に以下を追加してください。

{
  "mcpServers": {
    "1social": {
      "url": "https://mcp.1social.dev/mcp"
    }
  }
}

ワンクリックでインストール： Cursor · VS Code · Claude connectors · ChatGPT connectors

CLI クライアント（Claude Code、Gemini CLI、Codex CLI）と手動で設定する場合のスニペットについては、対応クライアントをご覧ください。

クイックスタート

1. 1social.devで 1Social アカウントを作成します。
2. ブラウザーでソーシャルアカウントを接続します。 この手順にはブラウザーが必要で、チャットからは実行できません。各ネットワークの OAuth 同意画面で、あなた自身が承認する必要があります。
3. ワンクリックリンク、CLI コマンド、または上記の JSON/TOML スニペットを使って、サーバーをクライアントに追加します。
4. クライアントに同意画面が表示されたら、OAuth で認証します。
5. アシスタントに投稿を依頼します。

チャットからできること

• 📤 投稿と予約 — 選択したすべてのネットワークに、今すぐ、または最大 30 日先まで投稿できます。
• 🔍 投稿前に確認 — ネットワークごとの文字数、画像が必要かどうか、複数パートの投稿がネイティブでスレッド化されるか結合されるか、クォータに対する料金を確認できます。
• 🧾 結果を確認 — 各ネットワークに投稿できた内容、失敗した内容とその理由、そして実際に確認できなかった内容を把握できます。
• ♻️ 問題を修正 — すでに投稿済みのネットワークに触れることなく、1 つのネットワークだけ再試行できます。
• 🖼 メディアを添付 — チャットから画像や動画を投稿できます。Instagram と TikTok では、メディアのない投稿は拒否されます。
• ✏️ 編集、キャンセル、削除 — 予約投稿を変更、予約解除、または削除可能なネットワークから削除できます。

ツールの概要

意図的に絞った10個のツールです。今すぐ公開する場合と予約投稿する場合は同じツールを使います（scheduledAt: null は今すぐ公開することを意味します）。また、1件の投稿を読む場合は2つ目のツールではなく、postId を指定して list_posts を使います。選択肢が少ないほど、モデルは正確に選べます。

ツール	機能
list_accounts	接続済みアカウント、各ネットワークで投稿できる内容、現在のプラン、残りの利用枠を確認します。まずこれを呼び出してください。チャンネル ID はここで取得します。
preview_post	無料のドライランです。ネットワークごとの制限、メディア要件、スレッドの動作、利用枠の消費量を確認できます。何も公開されません。
publish_post	今すぐ公開するか、30日先まで予約投稿します。ネットワークごとの結果を返します。idempotencyKey を指定します。
list_posts	ネットワークごとの配信結果（配信済み、理由付きの失敗、キャンセル済み、または unknown）と、保存済みのエンゲージメント指標を含む投稿一覧を返します。
update_post	まだ送信されていない投稿を編集します。ネットワークには編集用のエンドポイントがないため、いったん取り下げて置き換えます。
cancel_post	予約投稿をキャンセルし、確保済みの利用枠を解放します。
delete_post	1Social から投稿を削除し、各ネットワークからの削除も試みます。削除できることとできないことをご覧ください。
retry_delivery	失敗したネットワークへの配信だけを再試行し、成功したネットワークには手を加えません。恒久的な失敗の場合は拒否されます。
upload_media	ツール呼び出しにファイルを添付できないクライアント向けに、署名済みアップロード先を提供します。
confirm_delivery	結果が不明だった配信について、お客様が確認した結果を記録します。そのネットワークで投稿が公開されているかどうかを指定します。

利用可能なツールはサーバーの応答どおりです。正確な最新のスキーマを確認するには、https://mcp.1social.dev/mcp に対して tools/list を実行してください。

不明な場合は、そのことを伝えます

4つのネットワークへの投稿が、3つのネットワークにだけ届くことがあります。各ツールの結果はネットワークごとに返されます。失敗の理由は対処できる言葉で示され、結果を本当に特定できなかった配信は、成功ではなく unknown として返されます。

unknown は行き止まりではありません。お客様がネットワークを確認し、見た内容をアシスタントに伝えると、confirm_delivery で結果を確定できます。公開されていると確認した場合は利用枠が確定し、公開されていないと確認した場合は配信が失敗として記録されるため、retry_delivery で再試行できます。アシスタントがお客様に代わって推測することはできません。

削除できることとできないこと

delete_post は必ず 1Social から投稿を削除します。ネットワークからの削除可否は、ネットワークによって異なります。

ネットワーク	リモート削除
X、LinkedIn、Bluesky、Facebook	✅ 削除できます
Instagram、TikTok、Threads	❌ 機能する削除 API がないため、投稿は公開されたままで、お客様だけが削除できます

複数パートのスレッドでは、最初の投稿だけが削除され、残りは孤立した状態で公開されたままになります。ツールは実際に削除された内容をネットワークごとに報告します。アシスタントは削除が完全に完了したと伝えるのではなく、実際の結果をお知らせするよう指示されています。

プランとアクセス

配信ごとに費用がかかるため、利用枠は投稿数ではなく配信数で計算されます。4つのネットワークへの投稿1件は、配信4件分です。X への配信は投稿ごとに料金がかかるため、他のネットワークより多くのユニットを消費します（最新の料金は料金表をご覧ください）。

	サブスクリプションなし	Solo	Pro
料金	$0	$19/mo	$39/mo
月間配信数	30 units	600 units	1,600 units
8つすべてのネットワーク	✅	✅	✅
配信結果と再試行	✅	✅	✅

新規アカウントには、少量の無料月間利用枠が付与されます。投稿の公開、配信結果の確認、再試行、予約投稿を行うのに十分な量なので、料金を支払う前にツールを試せます。失敗の原因がこちら側またはネットワーク側にある場合、その配信は利用枠にカウントされません。

支払いのためにチャットを離れる必要はありません。 利用枠がなくなった状態でツールを呼び出すと、お客様のアカウント用のチェックアウトリンクが返されます。

対応クライアント

• Claude（ウェブおよびデスクトップ）— Settings → Connectors → Add custom connector
• ChatGPT — Settings → Apps & Connectors → Advanced → Developer mode → Add custom connector
• Cursor — ワンクリックのディープリンク、または ~/.cursor/mcp.json
• VS Code — ワンクリックのディープリンク、または .vscode/mcp.json
• Claude Code (CLI) — claude mcp add --transport http 1social https://mcp.1social.dev/mcp
• Gemini CLI — gemini mcp add --transport http 1social https://mcp.1social.dev/mcp
• Codex CLI — codex mcp add 1social --url https://mcp.1social.dev/mcp
• 汎用 HTTP MCP クライアント — URL を指定すると、OAuth の検出が自動的に行われます

クライアントごとの詳しい手順：docs/setup.md。

Cursor プラグイン

このリポジトリは Cursor プラグインでもあります。MCP サーバー（1social）を 1 つ提供し、ルール、スキル、エージェント、フックは含まれません。

.cursor-plugin/plugin.json   ← plugin manifest
mcp.json                     ← the MCP server it contributes
assets/logo.svg              ← plugin logo

設定は不要です。サーバーが OAuth 2.1 メタデータを通知し、Cursor が動的に登録され、初回使用時に同意画面が開きます。

プロンプトの例

最初に確認してからクロスポストする

「新しい料金ページについて、LinkedIn、X、Bluesky 向けの投稿を作成し、文字数に収まるか確認してから公開してください。」

→ preview_post が各ネットワークの文字数と費用を報告し、publish_post がネットワークごとの受領確認を返します。

画像付きで予約投稿する

「このスクリーンショットを金曜日の午前9時に Instagram と Threads に投稿してください。」

→ 添付ファイルは media に入ります。これがない場合、Instagram は投稿を拒否していたでしょう。

実際に何が起きたか確認する

「昨日の投稿は、すべてのネットワークに届きましたか？」

→ list_posts は受領確認を返します。unknown のままの配信も含まれます。

再投稿ではなく、失敗した配信を再試行する

「LinkedIn で失敗しました。LinkedIn だけ再試行してください。」

→ retry_delivery は 1 件の配信だけを処理し、成功したネットワークには手を加えません。

詳しくはこちら：docs/examples.md。

認可

MCP 認可仕様に準拠した、PKCE を使用する OAuth 2.1 です。認可サーバーは https://1social.dev です。Dynamic Client Registration に対応しているため、互換性のあるクライアントは自動でセットアップされ、表示されるのは同意画面だけです。付与されるスコープは openid、profile、email、offline_access です。

アシスタントがソーシャルメディアの認証情報を見ることはありません。 ネットワークのトークンは 1Social に保管されます。アシスタントが保持するのは 1Social アカウント用のトークンのみで、ウェブアプリからいつでも取り消せます。

フローの詳細：docs/oauth.md。

トラブルシューティング

接続、OAuth、ツール呼び出しでよくあるエラー：docs/troubleshooting.md。

マーケットプレイスの掲載情報

このリポジトリは、次の 2 つの掲載情報のソースです。

レジストリ	レコード	マニフェスト
MCP Registry	dev.1social/1social	server.json — v* タグで CI により公開され、1social.dev の DNS TXT レコードで認証されます
LobeHub	sultanlive-1social-mcp	lhm.plugin.json — npx -y @lobehub/market-cli plugin publish --dir . で公開されます

lhm.plugin.json の tools 配列は、サーバー独自のコントラクト（プライベートリポジトリ内の packages/contract/src/mcp/tools.ts）にある TOOLS テーブルから生成されます。これは tools/list に応答するテーブルと同じです。これはスナップショットです。ツールの構成が変わったら手動で編集せずに再生成してください。そうしないと、実在しないサーバーが掲載情報に記載されることになります。

なお、2 つのレジストリでは意図的にバージョン番号が異なります。server.json は 0.1.0 ですが、LobeHub はインポート時に 1.0.0 を割り当てており、バージョン名は変更できません。

プロジェクトリンク

• 製品：1social.dev
• MCP ページ：1social.dev/mcp
• MCP サーバー：https://mcp.1social.dev/mcp
• OAuth 発行者：https://1social.dev
• 問題：github.com/sultanlive/1social-mcp/issues

ライセンス

MIT — LICENSE をご覧ください。

---

@sultanlive が開発しました。1Social はホスト型の投稿サービスです。このリポジトリは、公開 MCP サーバーのドキュメントです。サーバーのソースは公開されていません。