人が所有権を引き継ぎます。
自ら登録したエージェントにはサンドボックスが与えられます。下書き、メディア、クライアントは扱えますが、予約も公開もできません。人が引き継ぎリンクを開いてログインして初めて、その組織はその人のものになります。
AIエージェント向け
01動画1本
エージェントはupload_media_from_urlで動画をアップロードし、アカウントのグループを指定して1つの投稿を送ります。Shagerはアカウントごとに、そのSNSが対応する形式のバージョンを返します。リール、ショート、TikTok動画、LinkedIn動画。それぞれに個別の送信時刻が付きます。
https://app.shager.ai/api/mcpStreamable HTTP · OAuth or Bearer key
呼び出しtools/call · upload_media_from_url → create_post
// 1 · upload the video once
{
"name": "upload_media_from_url",
"arguments": {
"workspace_id": "cm2studionoa",
"url": "https://studio-noa.co.il/media/workshop.mp4"
}
}
// → { "id": "cm2wheelvideo", "kind": "VIDEO",
// "width": 1080, "height": 1920, "duration_ms": 24000 } (measured by Shager)
// 2 · one post to every account
{
"name": "create_post",
"arguments": {
"workspace_id": "cm2studionoa",
"group_ids": ["cm2allaccounts"],
"caption": "A new evening workshop…",
"media_ids": ["cm2wheelvideo"],
"cta_url": "https://studio-noa.co.il/workshop",
"youtube_made_for_kids": false,
"per_channel": [{
"channel_id": "cm2tiktok",
"tiktok_privacy": "SELF_ONLY"
}],
"schedule_at": "2026-10-20T09:00:00+03:00",
"idempotency_key": "workshop-oct-20"
}
}結果status: SCHEDULED
{
"status": "SCHEDULED",
"scheduled_at": "2026-10-20T06:00:00.000Z",
"stagger_seconds": { "min": 30, "max": 90 },
"issues": [],
"destinations": [
{ "network": "INSTAGRAM", "format": "REEL", "state": "PENDING" },
{ "network": "FACEBOOK", "format": "REEL", "state": "PENDING" },
{ "network": "YOUTUBE", "format": "SHORT", "state": "PENDING" },
{ "network": "TIKTOK", "format": "VIDEO", "state": "PENDING" },
{ "network": "LINKEDIN", "format": "VIDEO", "state": "PENDING" },
{ "network": "X", "format": "FEED", "state": "PENDING" }
// … 2 more, each with its own dispatch_at
],
"calendar_notes": []
}validate_post は、何かを保存する前に、すべてのアカウントの問題をまとめて返します。calendar_notes は選んだ日の祝日を知らせるので、エージェントはタイミングを見直せます。idempotency_key で再試行も安全です。同じリクエストから2つ目の投稿が作られることはありません。02安全性
自ら登録したエージェントにはサンドボックスが与えられます。下書き、メディア、クライアントは扱えますが、予約も公開もできません。人が引き継ぎリンクを開いてログインして初めて、その組織はその人のものになります。
キーの権限は読み取り・書き込み・公開の3種類です。公開権限は人だけが別途付与でき、キーはいつでも無効にできます。
APIキー · claude-codeshgr_live_…
readアカウント、投稿、統計オンwrite下書きとメディアオンpublish予約と公開オフ10を超えるアカウントへの送信や、60分以内の送信はすぐには出ません。エージェントはあなたに見せる送信プランを受け取り、確認トークンがある場合にだけ再送信します。
{ "error": {
"code": "needs_confirmation",
"message": "Nothing was scheduled: …",
"details": {
"plan": { "accounts": 40, "by_network": { … } },
"confirmation_token": "…"
}
} }1投稿あたり最大50アカウント、24時間で最大20件の予約投稿。エージェントの操作は、何を、いつ、どのキーで行ったかまですべて記録されます。
03接続
クライアントにサーバーのアドレスを追加します(ClaudeとChatGPTではカスタムコネクタとして)。Shagerに移動したら、ログインして組織を選び、承認します。コピーするキーはなく、チェックを入れない限り公開はオフのままです。
コードカスタムコネクタ
# MCP server URL (sign in with OAuth)
https://app.shager.ai/api/mcpブラウザのないボットやエージェントは一度だけ登録し(RFC 7591)、コードを取得してあなたに表示します。スマートフォンでapp.shager.ai/deviceを開き、同じ画面・同じ権限で承認します。
コードRFC 8628 デバイスコード
curl -X POST https://app.shager.ai/api/oauth/device_authorization \
-d client_id=shgr_client_… \
-d resource=https://app.shager.ai/api/mcp
# → user_code "BCDF-GHJK", verification_uri
# https://app.shager.ai/device · then poll /api/oauth/tokenエージェントページでキーを作成し、MCPまたはREST APIでBearerヘッダーとして送ります。まだアカウントがない場合は、エージェントが自分でサンドボックスに登録し、あとからあなたが引き継げます(auth.md)。
コードClaude Code
claude mcp add --transport http shager \
https://app.shager.ai/api/mcp \
--header "Authorization: Bearer shgr_live_…"04ツール
whoamiget_structureget_claim_linklist_workspacescreate_workspacelist_channelscreate_connect_linklist_groupscreate_groupupload_media_from_urlvalidate_postcreate_postupdate_postschedule_postrequest_approvalget_approvalget_postlist_postscancel_postdelete_postlist_commentsreply_to_commenthide_commentdelete_commentget_analyticscreate_webhooklist_webhooksdelete_webhooksend_test_webhookget_holidays/llms.txt/llms-full.txt/md/…app.shager.ai/api/v1/openapi.jsonapp.shager.ai/.well-known/oauth-authorization-server05よくある質問
OAuthログインに対応したMCPクライアント(ClaudeやChatGPTのカスタムコネクタなど)、APIキーのヘッダーに対応したMCPクライアント(Claude Code、Cursor、Codexなど)、デバイスコードを使うブラウザのないボットやエージェント、そしてREST APIを呼び出すあらゆるコードです。
デフォルトではありません。公開には人が付与する別の公開権限が必要で、キーの作成時、サンドボックスの引き継ぎ時、接続の承認時にはオフになっています。さらに、10を超えるアカウントへの送信や60分以内の送信には2回目の確認が必要です。ワークスペース内のすべての投稿にクライアント承認を必須にすることもできます。
いいえ。APIとMCPサーバーは全プランに含まれ、エージェントが作成した投稿もほかの投稿と同じように数えられます。
予約投稿は公開されるまで取り消せ、下書きは削除できます。すべての操作はログに残り、キーはワンクリックで無効にできます。
投稿できるのは、各SNSの公式な許可画面を通じてあなたの組織に接続されたアカウントだけです。エージェントがパスワードを見ることはありません。