Collega un agente

Un unico endpoint a cui collegare il client del tuo agente. L'agente può consultare i tuoi brand e canali, generare video e testi, caricare file, programmare e inviare post e consultarne i risultati.

L'agente non può collegare canali social né cambiare il tuo piano. Gli ambiti e il limite mensile di crediti del token tengono sotto controllo la spesa. Le chiavi di idempotenza evitano doppi addebiti se ripeti una chiamata. Per collegare un canale devi accedere dal browser, quindi questo passaggio va fatto nell'app.

Crea un token di accesso personale nelle impostazioni. Potrai vederlo una sola volta e usarlo solo su questo endpoint.

• Gli ambiti definiscono cosa puoi fare con il token: read consente la lettura, generate aggiunge le operazioni che consumano crediti e publish permette di pubblicare.
• Limitalo a un brand e vedrà solo i canali, le generazioni, i post e i testi di quel brand. Il portafoglio dei crediti, i file caricati, gli attori e i prodotti restano condivisi in tutto l'account.
• Imposta un limite mensile di crediti. Una volta raggiunto, il token non potrà avviare altre chiamate a pagamento. I testi già in fase di generazione vengono addebitati al costo effettivo, che può superare leggermente il limite.

1POST https://www.socialfaktory.com/mcp

Streamable HTTP, versione del protocollo 2025-06-18, autenticazione bearer nell'header Authorization. Non serve un ID di sessione: il token fa da sessione. Le richieste GET ricevono una risposta 405.

Aggiungi SocialFaktory come connettore personalizzato nelle impostazioni del client e incolla questo indirizzo come URL del server. Claude Desktop, claude.ai, ChatGPT e Gemini lo accettano allo stesso modo, senza bridge né processi locali.

1https://www.socialfaktory.com/mcp

• Non devi incollare token né creare un ID client. L'app si registra automaticamente.
• Nella schermata di consenso scegli quali ambiti concedere tra read, generate e publish, a quale brand limitare la connessione, il limite mensile di crediti e la durata della connessione.
• Scollegala quando vuoi da Impostazioni, Token API. L'app smette subito di funzionare.

1. 1Accedi a SocialFaktory se non l'hai già fatto. La schermata indica l'app che ti ha reindirizzato.
2. 2L'ambito Lettura è sempre attivo e consente di vedere i tuoi brand, media e post. Seleziona gli altri ambiti da concedere. Generazione crea video e testi usando i tuoi crediti. Pubblicazione programma e invia post sui tuoi canali: lascialo deselezionato finché non sei sicuro che il brief funzioni come vuoi.
3. 3Limita la connessione a un brand o scegli tutti i brand per consentire all'app di pubblicare su ogni canale collegato.
4. 4Scegli la durata della connessione, 30, 60 o 90 giorni.
5. 5Imposta un limite mensile di crediti o lascia il campo vuoto se non vuoi limiti, poi premi Collega. Tornerai all'app e potrai usarla subito. Non potrà mai collegare un canale, cambiare il tuo piano o accedere al tuo posto.

Per la directory dei connettori di Claude, SocialFaktory offre un indirizzo dedicato. Collegato a quell'indirizzo, Claude gestisce il tuo account, scrive post, carica i tuoi media e programma e pubblica su ogni canale collegato.

1. Apri la scheda di SocialFaktory nella directory dei connettori di Claude.
2. Premi Collega. Claude ti reindirizza a SocialFaktory.
3. Accedi al tuo account SocialFaktory.
4. Scegli se consentire a Claude di scrivere e pubblicare post, indica il brand su cui può lavorare e imposta il limite mensile di crediti e la durata della connessione. Conferma per tornare in Claude e affidargli un brief.

1https://www.socialfaktory.com/mcp/claude

• Non genera immagini, video, voci o musica AI. Creali nell'app: una volta nella tua libreria media, Claude può programmarli e pubblicarli.
• Una connessione creata dalla directory funziona solo su questo indirizzo. Una connessione creata su /mcp funziona solo su /mcp. Un token che incolli tu funziona su entrambi.

Con Claude Code, Codex e curl fai prima a incollare un token creato da te. Gli esempi qui sotto continuano a funzionare senza modifiche.

Invia JSON-RPC 2.0 tramite POST. Accetta sia JSON sia il tipo event-stream e indica la versione del protocollo in ogni richiesta.

1POST https://www.socialfaktory.com/mcp
2Authorization: Bearer sfp_…
3Content-Type: application/json
4Accept: application/json, text/event-stream
5MCP-Protocol-Version: 2025-06-18
6
7{ "jsonrpc": "2.0", "id": 1, "method": "tools/list" }

Ogni strumento indica l'ambito richiesto. Se il token non lo include, la chiamata viene rifiutata prima dell'esecuzione. Con quote_generation puoi verificare il prezzo di un video, ma non è obbligatorio. generate_text riserva alcuni crediti in anticipo e addebita solo quelli usati per scrivere il testo.

Passa questo argomento a ogni chiamata che consuma crediti o pubblica. Se la ripeti entro 24 ore, ottieni il risultato originale con l'indicazione che la chiamata è stata ripetuta. L'operazione non viene eseguita di nuovo.

• 120 chiamate al minuto per token e 300 richieste ogni 5 minuti per indirizzo.
• La clonazione di video da un link e la generazione di immagini statiche o caroselli non sono ancora disponibili tramite un agente.

App Gemini: aggiungi l'indirizzo come app personalizzata. L'app si registra automaticamente, quindi non devi inserire credenziali client nelle funzionalità avanzate. Per ora Google consente le app personalizzate solo con account personali, a partire dai 18 anni, negli Stati Uniti, in inglese e con il salvataggio dell'attività attivo. Il primo collegamento va fatto dal web.

Gemini Enterprise: un amministratore aggiunge un server MCP personalizzato usando gli indirizzi di autorizzazione e token del documento di discovery. Per ottenere un ID e un segreto client, deve registrarsi su /oauth/register con token_endpoint_auth_method client_secret_post e il proprio indirizzo di callback. Deve anche attivare PKCE e gli ambiti read, generate e publish. È supportato solo Streamable HTTP, il trasporto usato da questo endpoint.

Gemini CLI: installa l'estensione e la CLI gestisce l'accesso da sola, schermata di consenso inclusa.

1gemini extensions install https://github.com/socialfaktory/socialfaktory-gemini-extension

Agenti gestiti dell'API Gemini: indica l'endpoint come strumento server, con un token creato da te nell'header Authorization.

1{
2  "type": "mcp_server",
3  "name": "socialfaktory",
4  "url": "https://www.socialfaktory.com/mcp",
5  "headers": { "Authorization": "Bearer sfp_…" }
6}

Qualcosa non funziona o hai dubbi su una connessione? Ti rispondiamo entro un giorno lavorativo. Scrivi dall'indirizzo email del tuo account a [email protected]