Una persona ne prende possesso.
Un agente che si registra da solo riceve una sandbox: bozze, media e clienti, senza programmare né pubblicare. Una persona apre il link di rivendicazione, accede, e solo allora l’organizzazione è sua.
Per agenti IA
Collega Claude, ChatGPT, Cursor o qualsiasi client MCP con l’accesso OAuth, un bot con un codice dispositivo, e tutto il resto con una chiave API o la REST API. Il tuo agente carica un video o delle immagini, prepara un post per tutti gli account (un Reel, uno Short, una storia, un video TikTok o un post) e lo verifica con le regole di ogni social. La pubblicazione resta disattivata finché una persona non la attiva.
Server MCP, REST API e documentazione OpenAPI in ogni piano, gratis durante il periodo di lancio.
01Un video
L’agente carica il video con upload_media_from_url e invia un post con un gruppo di account. Shager restituisce una versione per account, in un formato supportato dal suo social: un Reel, uno Short, un video TikTok, un video LinkedIn. Ognuna ha il suo orario di invio.
https://app.shager.ai/api/mcpStreamable HTTP · OAuth or Bearer key
Chiamatatools/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"
}
}Risultatostatus: 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 restituisce tutti i problemi di tutti gli account insieme, prima di salvare qualsiasi cosa.calendar_notes segnala le festività nel giorno scelto, così l’agente può rivedere l’orario.idempotency_key rende sicuri i tentativi ripetuti: la stessa richiesta non crea mai un secondo post.02Sicurezza
Un agente che si registra da solo riceve una sandbox: bozze, media e clienti, senza programmare né pubblicare. Una persona apre il link di rivendicazione, accede, e solo allora l’organizzazione è sua.
Ogni chiave ha permessi di lettura, scrittura e pubblicazione. La pubblicazione si concede a parte, solo da una persona, e la chiave si può revocare in qualsiasi momento.
Chiave API · claude-codeshgr_live_…
readAccount, post, statisticheAttivowriteBozze e mediaAttivopublishProgrammare e pubblicareDisattivoUn invio a più di 10 account o entro 60 minuti non parte subito. L’agente riceve un piano di invio da mostrarti e reinvia solo con un token di conferma.
{ "error": {
"code": "needs_confirmation",
"message": "Nothing was scheduled: …",
"details": {
"plan": { "accounts": 40, "by_network": { … } },
"confirmation_token": "…"
}
} }Fino a 50 account per post e 20 post programmati in 24 ore. Ogni azione di un agente viene registrata: cosa, quando e con quale chiave.
03Connessione
Aggiungi l’indirizzo del server nel client (in Claude e ChatGPT, come connettore personalizzato). Il client ti porta su Shager: accedi, scegli l’organizzazione e approva. Nessuna chiave da copiare, e la pubblicazione resta disattivata se non la selezioni.
CodiceConnettore personalizzato
# MCP server URL (sign in with OAuth)
https://app.shager.ai/api/mcpUn bot o un agente senza browser si registra una volta (RFC 7591), chiede un codice e te lo mostra. Approvi dal telefono su app.shager.ai/device, con la stessa schermata e gli stessi permessi.
CodiceCodice dispositivo 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/tokenCrea una chiave nella pagina Agenti e inviala come header Bearer, via MCP o REST API. Non hai ancora un account? L’agente si registra da solo in una sandbox e tu la rivendichi dopo (auth.md).
CodiceClaude Code
claude mcp add --transport http shager \
https://app.shager.ai/api/mcp \
--header "Authorization: Bearer shgr_live_…"04Strumenti
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-server05Domande
Qualsiasi client MCP che supporta l’accesso OAuth (come un connettore personalizzato in Claude o ChatGPT) o un header con chiave API (come Claude Code, Cursor o Codex), bot e agenti senza browser tramite codice dispositivo, e qualsiasi codice che chiami la REST API.
Non di default. Pubblicare richiede un permesso di pubblicazione separato concesso da una persona, ed è disattivato quando crei una chiave, rivendichi una sandbox o approvi una connessione; inoltre un invio a più di 10 account o entro 60 minuti richiede una seconda conferma. Puoi anche richiedere l’approvazione del cliente per ogni post in un workspace.
No. L’API e il server MCP sono inclusi in ogni piano, e un post creato dal tuo agente conta come qualsiasi altro post.
Un post programmato si può annullare finché non esce, e una bozza si può eliminare. Ogni azione finisce nel registro, e la chiave si può revocare con un clic.
Solo sugli account collegati alla tua organizzazione, tramite la schermata ufficiale dei permessi di ogni social. L’agente non vede mai le password.
Inizia gratis durante il lancio, crea una chiave e collega il tuo agente con una riga. Decidi tu quando pubblica.