Sociality.io MCP

Sociality.io MCP

Sociality.io のソーシャルメディア MCP サーバーを使って、AI をソーシャルメディアのインテリジェンス、分析、インサイトに接続できます。

Sociality.io MCP は、Facebook、X、Instagram、YouTube、LinkedIn、TikTok にわたる自社ソーシャルアカウントの分析、公開済みコンテンツ、競合他社の公開情報、競合ベンチマーク、投稿インサイト、レポート作成ワークフローへの構造化された OAuth アクセスを、MCP 互換クライアントに提供します。

ダッシュボードの外部でソーシャルメディアのインテリジェンスを必要とするチーム、ビルダー、AI ワークフロー向けに構築されています。対象には、レポート作成アシスタント、社内コパイロット、競合モニタリング、クロスチャネル分析、Sociality.io のデータを活用したカスタム製品が含まれます。

リモート MCP サーバー

https://api.sociality.io/mcp

トランスポート：streamable-http

認証：OAuth

OAuth スコープ：mcp:use

Sociality.io MCP の機能

Sociality.io MCP は、MCP ツール、リソース、プロンプトを通じて、ソーシャルメディアアカウントとソーシャルメディア上の競合情報を提供します。

自社のソーシャルアカウントについて、クライアントは次の操作を実行できます。

• 認証済みユーザーが利用できる、接続済みソーシャルアカウントの一覧を取得します。
• 日、週、月単位で集計された、指定期間のアカウントレベルの分析データを取得します。
• 投稿タイプで絞り込み、アカウントレベルの分析に使う公開済みの投稿やストーリーズを取得します。
• プラットフォームや期間をまたいで、自社アカウントのパフォーマンスを比較します。

競合ワークフローでは、クライアントは次の操作を実行できます。

• 現在のワークスペースで追跡している公開競合他社の一覧を取得します。
• 明示的に依頼された場合に、ソーシャルプロフィールの URL から競合他社の追跡レコードを追加します。
• ベンチマーク用に、競合他社の公開統計データを取得します。
• コンテンツやエンゲージメントの分析用に、競合他社の公開済み投稿を取得します。
• 対応チャネルで、自社アカウントと追跡中の競合他社を比較します。

ワークフローの計画と安全性確保のため、クライアントは次の操作を実行できます。

• ワークスペースのコンテキストと MCP クレジットの状況を確認します。
• 対応チャネル、機能、指標、集計方法を確認します。
• 利用可能なツール、請求状況、読み取り／書き込みの動作を確認します。
• MCP クライアントがプロンプトに対応している場合、ツールのガイダンスや準備状況の確認に組み込みプロンプトを使用します。

ドキュメント

• 製品ページ：https://sociality.io/mcp
• MCP ドキュメント：https://sociality.io/docs
• ツールリファレンス：https://sociality.io/docs/reference/tools
• クライアントのセットアップ：https://sociality.io/docs/getting-started/connect-your-client
• 安全な使用方法：https://sociality.io/docs/security/safe-mcp-usage

対応ツール

ツール	アクセス	クレジットの使用	目的
social_accounts_list	読み取り	無料	認証済みユーザーが利用できるソーシャルメディアアカウントの一覧を取得します。
social_account_stats_list	読み取り	有料	日、週、月単位で集計された、指定期間の自社アカウントの分析データを取得します。
social_account_posts_list	読み取り	有料	指定期間の自社アカウントの公開済み投稿やストーリーズを取得します。
social_competitors_list	読み取り	無料	現在のワークスペースで追跡している競合他社の一覧を取得します。
social_competitors_create	書き込み	無料	ソーシャルプロフィールの URL から、追跡対象の競合他社を追加します。
social_competitor_stats_list	読み取り	有料	日、週、月単位で集計された、指定期間の競合他社の公開統計データを取得します。
social_competitor_posts_list	読み取り	有料	指定期間の競合他社の公開済み投稿を取得します。

ツールのパラメーター

ツール	必須	任意
social_accounts_list	—	channel、name、page
social_account_stats_list	account_id、since、until	period（day、week、month。デフォルトは day）
social_account_posts_list	account_id、since、until	type、order、limit（1～50。デフォルトは50）、page
social_competitors_list	—	channel、name、page
social_competitors_create	url	timezone（デフォルトはワークスペースのタイムゾーン）
social_competitor_stats_list	competitor_id、since、until	period（day、week、month。デフォルトは day）
social_competitor_posts_list	competitor_id、since、until	type、order、limit（1～50。デフォルトは50）、page

日付には YYYY-MM-DD を使用します。order は published_at_desc（デフォルト）または published_at_asc です。

統計ツールは、アカウントまたは競合のチャンネルで利用可能な、カタログに登録されたすべての指標を返します。指標名、説明、集計動作については、social_platform_capabilities を参照してください。

投稿タイプ

所有アカウントの投稿は、status、photo、gif、video、link、album、carousel、story、reels、document、poll、repost で絞り込めます。Facebook のストーリーはアカウントの投稿に含まれません。

競合の投稿タイプはチャンネルによって異なります。

チャンネル	競合の投稿タイプ
Facebook	status、photo、video、link、album
Instagram	photo、video、carousel、reels
LinkedIn	status、photo、video、link、document
TikTok	video
X	status、photo、video
YouTube	video

対応チャンネル

• Facebook
• X
• Instagram
• YouTube
• LinkedIn
• TikTok

チャンネル、機能、指標、集計の対応状況を最も正確に把握するには、MCP サーバーの social_platform_capabilities リソースを参照してください。

対応リソース

リソース	URI	用途
social_workspace_context	sociality://workspace/context	現在のチームとユーザーのコンテキストに加え、MCP クレジットの usage、limit、resets_at を返します。
social_tools_catalog	sociality://tools/catalog	クレジットの使用状況と読み取り専用／書き込み可能のステータスを含む、登録済みツールのカタログを返します。
social_platform_capabilities	sociality://platform/capabilities	対応チャンネル、機能の対応状況、指標名、指標の説明、集計動作を返します。

対応プロンプト

プロンプト	用途
social_guide_tool_usage	推奨されるツールの使い方、クレジットの動作、ページネーション、対応チャンネル、指標の選択パターンを説明します。
social_guide_readiness_check	クレジットのステータス、接続済みアカウント数、トークンの期限切れなどの警告を含む、ワークスペースの準備状況を返します。

プロンプトのサポート状況はMCPクライアントによって異なります。プロンプトを直接表示するクライアントもあれば、ツールとリソースのみを表示するクライアントもあります。

ユースケース

• Sociality.io のライブデータから、ソーシャルメディアのパフォーマンスに関する定期的なサマリーを生成します。
• チャンネル、キャンペーン、レポート期間をまたいで、所有アカウントのパフォーマンスを比較します。
• フォロワー、エンゲージメント、投稿、公開パターンを基に競合を評価します。
• 競合のコンテンツを分析し、投稿頻度、クリエイティブ形式、エンゲージメントの指標を特定します。
• 構造化データを基に、アカウント、投稿、競合に関する質問に回答する社内コパイロットを構築します。
• ソーシャルメディアのインテリジェンスを、レポート作成ワークフロー、監視システム、顧客向け製品に取り込みます。
• 大規模なワークフローの前に準備状況を確認し、ワークスペースへのアクセス、利用可能なデータソース、対応指標、クレジットのステータスを確認します。

クライアントのセットアップ

リモート HTTP MCP サーバーに対応するクライアントの場合：

{
  "mcpServers": {
    "sociality": {
      "url": "https://api.sociality.io/mcp"
    }
  }
}

ChatGPT、Claude、Gemini Enterprise、Gemini CLI、その他の対応クライアントについては、セットアップドキュメントを参照してください：

https://sociality.io/docs/getting-started/connect-your-client

Claude Code の場合：

claude mcp add --transport http sociality https://api.sociality.io/mcp

Codex の場合：

codex mcp add --url https://api.sociality.io/mcp sociality

クライアントが stdio MCP サーバーにしか対応していない場合は、mcp-remote などのブリッジを使用してください：

{
  "mcpServers": {
    "sociality": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.sociality.io/mcp"]
    }
  }
}

セットアップの確認

クライアントを接続したら、大規模なワークフローを実行する前に、クレジットを消費しない次のセットアップ確認を行います。

1. social_workspace_context を読み取り、OAuth、アクティブなワークスペース、ユーザーコンテキスト、クレジットの状態を確認します。
2. social_accounts_list と social_competitors_list を呼び出し、アクセス可能な自社アカウントと追跡中の競合他社を確認します。
3. social_platform_capabilities を読み取り、対応チャネル、指標、集計の動作を確認します。
4. social_tools_catalog を読み取り、無料ツール、課金対象ツール、読み取り専用ツール、書き込み操作を区別します。

定期的なレポート作成、競合他社のベンチマーク、社内コパイロット、本番環境のエージェントワークフローを始める前に特に役立ちます。

対応が必要な場合の応答

Sociality.io でユーザーが操作するまでリクエストに回答できない場合、ツールはプロトコルエラーではなく、空のデータブロックと action_required オブジェクトを含む通常の結果を返します。この方法でブロックされた呼び出しは、MCP クレジットを消費しません。

{
  "action_required": {
    "code": "credits_exhausted",
    "message": "This workspace has used all of its MCP credits for the current period.",
    "action": "Credits reset at the start of the next period. To continue before then, review the plan in Sociality.",
    "link": "https://..."
  }
}

コード	意味
no_channels	ソーシャルメディアアカウントがまだ接続されていません。
no_competitors	競合他社がまだ追跡されていません。
channel_token_expired	アカウントの接続が期限切れです。再接続が必要です。
credits_exhausted	ワークスペースは現在の期間の MCP クレジットを使い切っています。
data_retention_limited	since がプランで許可されているデータ保持期間より前の日付です。メッセージにはリクエスト可能な最も古い日付が含まれます。
page_limit_reached	ワークスペースでは、プランに含まれるページ数をすでに追跡しています。
page_change_limit_reached	ワークスペースは現在の期間のページ変更回数を使い切っています。

クライアントは message をユーザーに表示し、link を案内してください。data_retention_limited の場合のように、action に呼び出しの調整方法が示されていない限り、引数を変えて再試行しても解決しません。

クレジット、制限、安全性

• 課金対象ツールは、返される行数に応じて MCP クレジットを消費します。
• 無料のセットアップツールと検出ツールは、MCP クレジットを消費しません。
• リストツールは、ページあたり最大 50 行を返します。page を使用し、さらに結果があるかどうかは pagination.has_more で確認してください。
• 投稿ツールは、呼び出しごとに最大 50 件の投稿を返します。limit で件数を減らし、ページ分割には page を使用してください。
• 統計ツールは、呼び出しごとに最大 50 件の集計済み行を返します。長い期間のデータがこの上限を超えないよう、period を使用してください。
• リクエスト可能な最も古い日付は、ワークスペースのプランのデータ保持期間によって異なります。
• 一部のプラットフォームでは、指標の報告に遅延があります。この指標の遅延は予想されるもので、取得可能なデータはリクエストされた日付まで返されます。チャネルごとの遅延の詳細は social_platform_capabilities を読み取ってください。
• ユーザーが現在使用している Sociality.io ワークスペースが非アクティブな場合、ツールはダッシュボードでワークスペースの状態を確認するよう求めるメッセージを返します。
• 現在のツールのほとんどは読み取り専用です。
• social_competitors_create は書き込み操作です。ユーザーが追跡対象の競合他社を追加することを明示的に希望している場合にのみ使用してください。プランのページ数上限とページ変更回数上限に算入されます。
• MCP アクセスには、接続済みの Sociality.io ユーザーとワークスペースの権限が適用されます。
• 本番環境や自動化されたワークフローでは、最小権限の Sociality.io アカウントを使用してください。

MCP と Sociality.io ダッシュボードの比較

Sociality.io は、製品インターフェースを通じて、公開、交流、リスニング、レポートを一元的に行うユーザー向けのプラットフォームです。

Sociality.io MCP は、ツール呼び出しを通じたエージェント主導のアクセスを提供します。AI クライアントやカスタムシステムが、構造化されたワークフローで Sociality.io のアカウント情報や競合他社のインテリジェンスを活用できます。

チームは、エージェントから直接アクセスする MCP のみのワークフロー、または Sociality.io での人間によるワークフローとエージェントを活用した分析・自動化を組み合わせるダッシュボード＋MCP のどちらも利用できます。

リポジトリの目的

このリポジトリは、リモート Sociality.io MCP サーバーを公開・発見・登録するための拠点です。公式 MCP レジストリのメタデータと利用ガイドを収録しています。ホストされた MCP エンドポイントは https://api.sociality.io/mcp で稼働しています。

公式 MCP レジストリ

このリポジトリには、Sociality.io MCP を公式 MCP レジストリに公開するために使用される server.json メタデータが含まれています。

レジストリのサーバー名：

io.sociality/sociality-mcp

現在のバージョン：1.0.0。公開後にレジストリのバージョンを変更することはできないため、掲載情報を更新するたびに、server.json の version を新しい値にする必要があります。サーバーが報告するバージョンと一致させてください。