Claude Code MCP
Pubblica sui social media da Claude Code
Un comando aggiunge Onlypult a Claude Code. Trasforma un registro delle modifiche, un rilascio o una cartella di schermate in bozze e post programmati su oltre 15 social network, senza uscire dal terminale.
- Un comando
- Ospitato o locale
- Caricamento dal disco
Leggi CHANGELOG.md per la v2.4 e crea una bozza di post LinkedIn e una di post su X per annunciarla. Allega ./docs/release.png.
Due bozze create, con la schermata allegata:
- BozzaLinkedIn — «v2.4 è uscito: esportazioni più veloci e SSO»
- BozzaX — 3 punti chiave + link alle note di rilascio
Come aggiungere Onlypult a Claude Code
Crea una chiave API, esegui un comando e controlla il server con /mcp.
https://mcp.onlypult.com/mcp - 1
In Onlypult apri Impostazioni → Chiavi API e crea una chiave. Inizia con
op_e viene mostrata una sola volta: copiala in un posto sicuro. - 2
Esegui il comando qui sotto nel terminale. Aggiungi
--scope userper avere Onlypult in ogni progetto. - 3
Avvia Claude Code ed esegui
/mcp: onlypult deve risultare collegato.
claude mcp add --transport http onlypult https://mcp.onlypult.com/mcp \
--header "Authorization: Bearer op_your_api_key" Esegue il server MCP di Onlypult sulla tua macchina, così Claude Code può caricare immagini e video direttamente dal repository con media_upload_file. Serve Node.js 18+.
- 1
In Onlypult apri Impostazioni → Chiavi API e crea una chiave. Inizia con
op_e viene mostrata una sola volta: copiala in un posto sicuro. - 2
Esegui il comando qui sotto. Claude Code avvia il pacchetto con
npxal primo utilizzo. - 3
Esegui
/mcpper controllare la connessione.
claude mcp add onlypult --env ONLYPULT_API_KEY=op_your_api_key \
-- npx -y @onlypult/mcp@latest Condividi il server con il team tramite un file di progetto. La chiave resta nell’ambiente di ogni sviluppatore, non in git.
- 1
Aggiungi
.mcp.jsonalla radice del progetto con il blocco qui sotto e fai commit. - 2
Ogni sviluppatore imposta
ONLYPULT_API_KEYnel profilo della shell con la propria chiave. - 3
Claude Code chiede a ogni sviluppatore di approvare i server del progetto la prima volta.
{
"mcpServers": {
"onlypult": {
"type": "http",
"url": "https://mcp.onlypult.com/mcp",
"headers": {
"Authorization": "Bearer ${ONLYPULT_API_KEY}"
}
}
}
} Controlla che funzioni: chiedi a Claude Code «Mostra i miei profili social collegati in Onlypult».
Prompt Claude Code che funzionano
Claude Code vede il repository, quindi può scrivere i post a partire da note di rilascio, documentazione e file veri.
Annuncio di rilascio
“Leggi l’ultima voce di CHANGELOG.md e crea bozze di post per LinkedIn, X e il nostro canale Telegram. Solo bozze.”
Dalle schermate a un carosello
“Carica ogni PNG in ./launch/screens e crea una bozza di post Instagram a più immagini, con una didascalia che spiega ogni funzionalità.”
Dalla documentazione a una serie di consigli
“Scorri docs/guides e crea otto brevi consigli per LinkedIn, uno per guida, programmati ogni martedì e giovedì alle 10:00.”
Dal registro dei commit a un aggiornamento settimanale
“Riassumi i commit uniti di questa settimana in un post «Novità» per gli utenti, per Telegram, e programmalo per venerdì alle 17:00.”
Sistema i fallimenti di stanotte
“Elenca i post Onlypult non riusciti delle ultime 24 ore, spiega gli errori e riprova quelli con retryable.”
Controlla prima i limiti
“Controlla posts_limits per i profili X e Threads e accorcia le bozze in ./social/*.md perché ci stiano, prima di crearle.”
Skill per Claude Code
Installa il plugin Onlypult in Claude Code con due comandi
Il plugin unisce gli skill di Onlypult alla connessione MCP, così Claude Code conosce le regole di ogni lavoro: quale strumento chiamare, come scrivere l’orario, come leggere le analisi e come capire un post fallito prima di riprovarlo. Dato che legge i file del repository, gli skill che trasformano un testo già scritto in post sono il punto in cui rende di più.
Installa per Claude Code
Aggiungi il marketplace, poi installa il plugin. Due comandi in qualsiasi sessione di Claude Code. Accedi a Onlypult alla prima chiamata di uno strumento.
/plugin marketplace add onlypult/agent-skills
/plugin install onlypult@onlypult Hai già aggiunto il server MCP a mano? Esegui prima claude mcp remove onlypult, così Claude Code non tiene due connessioni allo stesso server.
Programmare un post
Bozza, programmazione o pubblicazione nel fuso orario giusto e sul profilo giusto, con i limiti del piano e le opzioni della piattaforma.
Cross-post
Lo stesso messaggio su più social, dopo aver controllato i limiti di testo e media di ogni piattaforma.
Reels, Shorts e Stories
Lo strumento e le opzioni giuste per Reels di Instagram e Facebook, YouTube Shorts e Stories.
Caricare i media
Scegliere tra un URL pubblico, un caricamento nel browser e un caricamento diretto da un file locale.
Correggere i post falliti
Vedere cosa non è uscito, spiegare perché, sistemare la causa e riprovare solo quando un nuovo tentativo può funzionare.
Report di analisi
Follower, reach, interazione e post migliori, letti nel modo giusto, con buchi nei dati e metriche derivate spiegate.
Orario migliore per pubblicare
Trovare i giorni e le ore migliori dalla mappa di interazione e programmare i post in quelle fasce.
Calendario dei contenuti
Pianificare una settimana o un mese partendo da ciò che funziona già: prima il piano, i post dopo la tua approvazione.
Set di hashtag
Gestire i set di hashtag salvati di un profilo e riusarli invece di riscrivere i tag.
L’agente fa il lavoro, non preme pubblica
La maggior parte delle configurazioni di «pubblicazione con IA» è tutto o niente. Onlypult ti lascia affidare all’agente il lavoro ripetitivo e tenere l’ultima parola, su ogni post.
Bozze per impostazione predefinita
Se chiedi una bozza, l’agente invia is_draft: true. Il post viene salvato nel calendario e non va da nessuna parte finché una persona, o un «pubblica ora» esplicito, non lo decide.
Permessi per ogni strumento
In Claude, ChatGPT, Cursor e nella maggior parte dei client MCP approvi gli strumenti uno per uno. Lascia letture e bozze su «Consenti sempre» e pubblicazione ed eliminazione su «Chiedi ogni volta».
Tutto finisce nel tuo calendario
Ogni post creato da un agente compare nel calendario Onlypult accanto a quelli del team. Puoi modificarlo, riprogrammarlo o mandarlo in approvazione prima che vada online.
OAuth per le chat, chiavi per il codice
Claude e ChatGPT si collegano con OAuth 2.1: accedi su onlypult.com e l’app di chat non vede mai la password. Gli agenti di codice usano una chiave API op_ da Impostazioni → Chiavi API.
Errori su cui l’agente può agire
Gli errori di validazione tornano con un codice e un flag retryable. L’agente spiega «il piano finisce il 5, scegli una data precedente» invece di riprovare all’infinito.
Attento alle istruzioni nascoste
Didascalie e commenti letti dalle analisi sono segnati come contenuto esterno non attendibile, così l’agente li riassume invece di seguire istruzioni nascoste al loro interno.
Tutti gli strumenti a disposizione dell’agente
Un solo server MCP copre l’intero ciclo di vita del post: contesto, pubblicazione, media, hashtag, ripristino e analisi. 37 strumenti.
Post e programmazione
14Bozze, programmazione, pubblicazione, crosspost, modifica, eliminazione e nuovo tentativo.
posts_createposts_create_storyposts_create_reelsposts_create_shortsposts_publish_nowposts_cross_postposts_listposts_list_failedposts_getposts_updateposts_deleteposts_retryposts_retry_all_failedposts_limits Analisi (sola lettura)
8Copertura, follower, post migliori, orario migliore, periodo su periodo.
analytics_profiles_listanalytics_metrics_listanalytics_overviewanalytics_audienceanalytics_postsanalytics_top_postsanalytics_best_timeanalytics_compare_periods Account e profili
6Fuso orario, limiti del piano, profili collegati, bacheche e categorie.
account_getprofiles_listprofiles_getprofiles_platforms_listprofiles_get_pinterest_boardsprofiles_get_youtube_categories Set di hashtag
6Riusa i gruppi di hashtag salvati per ogni profilo, senza riscriverli.
hashtags_listhashtags_createhashtags_deletehashtag_groups_createhashtag_groups_updatehashtag_groups_delete Media
3URL pubblici, caricamento dal browser o caricamento diretto dal disco.
media_get_upload_urlmedia_check_statusmedia_upload_file Pubblica su oltre 15 social da un’unica chat
L’agente sceglie i profili dal tuo spazio di lavoro Onlypult: ogni account collegato con OAuth ufficiale è disponibile, con opzioni per social come Reels, Shorts, Stories, bacheche e primo commento.
Consigli Claude Code e risoluzione dei problemi
Ospitato o locale
Il server ospitato basta per il testo e per gli URL pubblici delle immagini. Usa il pacchetto locale quando Claude Code deve caricare file dal repository: il server ospitato non può leggere il disco.
Il server risulta non riuscito in /mcp
Per il server ospitato, controlla che l’header sia esattamente Authorization: Bearer op_…. Per il pacchetto locale, controlla che Node.js 18+ sia installato e che npx sia nel PATH.
Tieni le chiavi fuori da git
Usa ${ONLYPULT_API_KEY} in .mcp.json e tieni la chiave vera nell’ambiente. Ogni chiave appartiene a un account Onlypult: creane una distinta per ogni membro del team.
Permessi
Claude Code chiede prima di eseguire gli strumenti MCP. Consenti gli strumenti di lettura e di bozza per la sessione; lascia posts_publish_now e posts_delete su chiedi.
«Non puoi programmare oltre la fine del piano»
I post non si possono programmare dopo la data di fine del piano. L’agente la legge da account_get e deve scegliere una data precedente oppure chiederti di rinnovare. Questo errore è segnato retryable: false, così un agente ben fatto si ferma invece di riprovare all’infinito.
Claude Code e Onlypult: FAQ
Claude Code può pubblicare sui social media?
Sì. Con il server MCP di Onlypult aggiunto, Claude Code può creare bozze, programmare e pubblicare post su oltre 15 social network e allegare immagini dal repository.
Qual è il comando per aggiungere Onlypult a Claude Code?
claude mcp add --transport http onlypult https://mcp.onlypult.com/mcp --header "Authorization: Bearer op_your_api_key". Per il caricamento locale dei file: claude mcp add onlypult --env ONLYPULT_API_KEY=op_your_api_key -- npx -y @onlypult/mcp@latest.
Claude Code può caricare immagini dal progetto?
Sì, con il pacchetto locale. Aggiunge media_upload_file, che carica un file da un percorso locale e restituisce un ID per posts_create.
Posso usarlo in CI o negli script?
Per le pipeline fisse, chiama direttamente l’API REST di Onlypult con la stessa chiave API: è più prevedibile di un agente. Usa Claude Code quando vuoi che decida lui cosa scrivere.
È incluso nel mio piano?
Sì. MCP e l’API sono in tutti i piani Onlypult, prova di 7 giorni gratis compresa.
Collega un altro agente IA
Claude.ai e Claude Desktop. Aggiungi un connettore personalizzato, accedi con Onlypult: nessuna chiave API da incollare.
Guida alla configurazioneConnettore personalizzato su Plus e Pro, oppure modalità sviluppatore su qualsiasi piano. Accesso con OAuth, poi menziona @Onlypult.
Guida alla configurazioneAggiungi Onlypult a .cursor/mcp.json: server ospitato, oppure il pacchetto locale che carica i file direttamente dal disco.
Guida alla configurazioneAggiungi Onlypult alla CLI di Codex o all’estensione IDE tramite config.toml oppure codex mcp add.
Guida alla configurazioneAggiungi Onlypult a Cascade in Windsurf tramite mcp_config.json: server ospitato o pacchetto locale.
Guida alla configurazioneMCP è incluso in tutti i piani
- Funziona con i 7 giorni gratis
- Nessuna carta per iniziare
- Nessun piano sviluppatori a parte
- Nessun costo API per profilo
Pubblica il rilascio e i post insieme
Aggiungi Onlypult a Claude Code e lascia che annunci ciò che hai appena costruito, come bozze che approvi tu.
7 giorni gratis · Nessuna carta · MCP e API in tutti i piani
