本文へ移動
ログイン

AI 連携（MCP）

AI 連携（MCP）

Soshark はリモート MCP サーバーを公開しています。Claude など MCP に対応した AI から、数字の読み取り・投稿案づくり・予約の依頼ができます。AI が書き込んだものは人の承認を通り、各 SNS の公式 API で投稿されます。

AI に頼んでから投稿されるまで

AI に頼んでから投稿されるまで

  1. 01

    AI に頼む

    「来週の投稿案を 3 本、火曜の夜に予約して」

  2. 02

    AI が下書き・予約

    MCP で Soshark の道具を呼びます

    schedule_post

  3. 03

    承認待ちに入る

    AI の予約は、既定で承認の依頼になります

    承認待ち

  4. 04

    人が確かめて承認

    本文の全文・出す先・時刻を見て決めます

  5. 05

    公式 API で投稿

    予約の時刻に、各 SNS の公式 API で出します

    投稿済み

流れのイメージ（頼む内容は例）

安全の仕組み

AI が誤った指示を受けても、最悪で「下書き」と「承認の依頼」にとどまるように作っています。

  • 投稿の前に、人の承認

    AI の予約と今すぐ投稿は、既定で承認待ちになります。AI が自分で承認する道具はありません。

  • 許す範囲を段で選ぶ

    接続するときに「読み取りだけ／下書きまで／予約まで／今すぐ投稿まで」から選びます。メンバーのロールより上は許せません。

  • すべての操作を記録

    監査の記録に、実行したのが人・AI・API キーのどれかを残します。

  • いつでも取り消せる

    管理者は、AI の接続と API キーをいつでも取り消せます。

  • 各社の公式 API だけ

    投稿は各 SNS の公式 API で行い、各社の投稿の上限と間隔を守ります。

  • 反応の自動化はしない

    いいね・フォロー・DM・大量の反応を自動で行う道具はありません。今後も作りません。

  • SNS の文章はデータとして扱う

    SNS から読んだ本文などは第三者のデータとして AI に渡し、指示としては扱わせません。

つなぎ方

MCP サーバーの URL

https://app.soshark.app/mcp

Claude Code

  1. ターミナルで次のコマンドを実行します。
  2. Claude Code の中で /mcp を開き、soshark を選んで認証します。
  3. 開いた Soshark の画面で組織と許可の段を選び、「許可する」を押します。
claude mcp add --transport http soshark https://app.soshark.app/mcp

claude.ai（Claude Desktop）

  1. 設定 → コネクタ →「カスタムコネクタを追加」を開きます。
  2. 名前に Soshark、URL に上の MCP サーバーの URL を入れて追加し、「連携」を押します。
  3. 開いた Soshark の画面で組織と許可の段を選び、「許可する」を押します。

ほかの MCP クライアント

  1. Streamable HTTP の MCP サーバーとして、上の URL を登録します。
  2. 認証は OAuth 2.1（PKCE）です。サーバーが返す案内（保護資源のメタデータ）に従えば、Soshark の許可の画面が開きます。

動作の確認は Claude Code で行っています。ほかのクライアントは同じ標準（MCP の認可の仕様）に沿う設計ですが、まだ確認していません。

人の操作なしで動かす（API キー）

CI やサーバーで動くエージェントには、ブラウザの許可の代わりに組織の API キーを使います。管理者が「設定 → AI 連携 → API キー」で作り、許す範囲・ロールの上限・ブランドを絞れます。キーは HTTP の Authorization ヘッダで送り、MCP と公開 API の両方で使えます。書き込みは API キーでも承認の依頼になり、API キーは承認できません。

Authorization: Bearer <API キー>

許可の段

接続するときに、AI に許す範囲を段で選びます。上の段は下の段を含みます。選べるのはメンバー本人のロールまでです。あとから広い操作が要ると、AI がその操作を呼んだときに許可の画面がもう一度開きます。

段AI ができること承認必要なロール
読み取りだけreadアカウント・予定・投稿・分析・ブランドの規則を見るなし（読むだけ）閲覧者以上
下書きまでdraft＋ 投稿案の作成・編集・投稿前チェック・タグ不要（SNS には出ません）編集者以上
予約までschedule＋ 予約・時刻の変更・取り消し・依頼の取り下げ予約と時刻の変更は既定で要編集者以上
今すぐ投稿までpublish＋ 今すぐ投稿の依頼常に要（オーナーだけが変更できます）編集者以上

どの段でも、AI にできないこと: 承認、SNS の接続・解除、メンバー・請求・API キーの変更、いいね・フォロー・DM。

Claude Code の版によっては、もう一度の許可の画面が開かないことがあります。書き込みも頼むときは、最初の接続で段を選んでおくのが確実です。

道具の一覧

全 28 本

AI が呼べる道具（MCP の tools）です。公開 API（/api/v1）にも同じものがあります。この一覧はサイトを作るときに Soshark の道具の目録から作っています。

読む必要な許可: read · 19

道具説明人の承認
アカウントの健康get_account_health1 つのアカウントの健康: 接続・トークンの期限・SNS の 24 時間の投稿上限・収集の状態・要対応。不要
アカウントの推移get_account_trend1 つのアカウントの日ごとのフォロワー・インプレッションなどの推移。不要
期間の分析get_analytics_overview期間の KPI と前の期間との比較、上位の投稿、アカウントごとの行。不要
承認の依頼get_approval承認の依頼の状態・判断・メモ。承認は人が Soshark で決めるので、すぐには下りません。不要
要対応get_attention人の対応が要るもの: 失敗・見逃し・結果確認中の投稿、再接続、収集の失敗、承認。不要
ブランドの規則get_brand_rulesブランドの開示の表記（PR・AI）・NG ワード・投稿の最短間隔・説明。投稿前チェックが守らせるもの。不要
予約の詳細get_job1 つの予約の詳細（試行・状態の履歴・承認）。不要
組織の設定get_org_settings組織のタイムゾーン・承認の方針・AI の設定と、この接続にできること。秘密は含みません。不要
投稿の推移get_post_detail1 つの投稿の指標の記録、経過時間のチェックポイント、アカウントの基準線。不要
タグ別の集計get_trends_by_tag期間の投稿をタグ別に集計（合計と中央値）。不要
時刻・曜日・形式の傾向get_trends_by_time時刻・曜日・形式ごとの相対スコアの中央値と投稿数。不要
直近の予定get_upcoming今から指定した日数のあいだの予約（組織のタイムゾーン、最大 10 件）。不要
X の費用get_usage_x組織の今月の X の API の費用と上限。不要
アカウントの一覧list_accounts接続中の SNS アカウントと、接続の状態・できること。不要
承認の依頼の一覧list_approvals承認の依頼の一覧（古い順）。この接続が出したものだけに絞れます。不要
ブランドの一覧list_brands組織のブランドの一覧（この接続で見られるものだけ）。不要
予約の検索list_jobs予約を状態・アカウント・時刻で探す。取り消しや時刻の変更の前に使います。不要
タグの一覧list_tags組織のタグと、使われている数。不要
投稿の検索search_postsSNS 上の投稿（Soshark の外で出したものを含む）と、最新の指標・相対スコア。保存済みのデータだけを読みます。不要

下書き必要な許可: draft · 4

道具説明人の承認
投稿前チェックcheck_post投稿案を保存せずにチェックする（本文の長さ・開示の表記・NG ワード・間隔・メディア・SNS の上限・X の費用の見積り）。不要
投稿案を作るcreate_post_draft1 つのブランドの投稿案（下書き）を、出す先のアカウントつきで作る。投稿も予約もしません。不要
タグを付け替えるtag_post投稿か下書きのタグを付け替える。不要
投稿案を直すupdate_post_draft予約の入っていない下書きを直す（ほかの人の保存と食い違えば止まります）。不要

予約必要な許可: schedule · 4

道具説明人の承認
予約を取り消すcancel_job予約か承認待ちを取り消す。取り消しは元に戻せません。AI からは AI が作った予約だけを取り消せます。不要
予約の時刻を変えるreschedule_job予約の時刻を変える。方針で承認が要るときは、新しい時刻の承認の依頼に置き換わります。人が作った予約は AI から変えられません。組織の方針（AI は既定で要）
予約するschedule_post下書きを時刻に予約する。AI からは組織の方針により通常は承認の依頼になり、人が承認するまで投稿されません。組織の方針（AI は既定で要）
承認の依頼を取り下げるwithdraw_approvalこの接続が出した承認の依頼を取り下げる。待っていた予約は取り消されます。不要

投稿必要な許可: publish · 1

道具説明人の承認
今すぐ投稿を依頼するrequest_publish_now下書きを今すぐ投稿するよう依頼する。AI からは常に承認の依頼になり、人が承認するまで投稿されません。要

開発者向け

公開 API（/api/v1）は MCP と同じ道具を REST で提供します。仕様は OpenAPI 3.1 で公開しています。認証は API キーか OAuth のアクセストークンです。

OpenAPI の仕様（JSON）: https://app.soshark.app/api/v1/openapi.json

各社の規約との関係

Soshark の AI 連携は、各社の公式 API と開発者規約に沿うように設計しています。各社による認定・提携・推奨を受けたものではありません。

投稿は、本人が公式の連携（OAuth）で許したアカウントに、各社の公式 API で行います。各社の投稿の上限（例: Threads は 24 時間あたりの投稿数）と、ブランドで決めた投稿の間隔を守ります。

Meta と TikTok の開発者向けの規約は、利用者の同意と把握のもとで投稿することを求めています。X は自動のいいね・フォロー・大量の投稿を禁じ、Meta は「いいね」やフォロワーの売買などの偽りの反応を禁じています。Soshark にはこうした操作をする道具が無く、AI の書き込みは人の承認を通ります。

AI で作った画像・動画の表示の決まりは SNS ごとにあり、変わることもあります。ブランドの規則に AI の開示の表記を決めておくと、投稿前チェックで確かめられます。

各社の規約は 2026 年 11 月 9 日に確認しました。

トップへ戻る