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

Come aggiungere Onlypult a Claude Code

Crea una chiave API, esegui un comando e controlla il server con /mcp.

URL del server MCP https://mcp.onlypult.com/mcp
  1. 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. 2

    Esegui il comando qui sotto nel terminale. Aggiungi --scope user per avere Onlypult in ogni progetto.

  3. 3

    Avvia Claude Code ed esegui /mcp: onlypult deve risultare collegato.

Terminale
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. 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. 2

    Esegui il comando qui sotto. Claude Code avvia il pacchetto con npx al primo utilizzo.

  3. 3

    Esegui /mcp per controllare la connessione.

Terminale
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. 1

    Aggiungi .mcp.json alla radice del progetto con il blocco qui sotto e fai commit.

  2. 2

    Ogni sviluppatore imposta ONLYPULT_API_KEY nel profilo della shell con la propria chiave.

  3. 3

    Claude Code chiede a ogni sviluppatore di approvare i server del progetto la prima volta.

Configurazione del progetto .mcp.json
{
  "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.

Claude Code
/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.

SKILL.md

Cross-post

Lo stesso messaggio su più social, dopo aver controllato i limiti di testo e media di ogni piattaforma.

SKILL.md

Reels, Shorts e Stories

Lo strumento e le opzioni giuste per Reels di Instagram e Facebook, YouTube Shorts e Stories.

SKILL.md

Caricare i media

Scegliere tra un URL pubblico, un caricamento nel browser e un caricamento diretto da un file locale.

SKILL.md

Correggere i post falliti

Vedere cosa non è uscito, spiegare perché, sistemare la causa e riprovare solo quando un nuovo tentativo può funzionare.

SKILL.md

Report di analisi

Follower, reach, interazione e post migliori, letti nel modo giusto, con buchi nei dati e metriche derivate spiegate.

SKILL.md

Orario migliore per pubblicare

Trovare i giorni e le ore migliori dalla mappa di interazione e programmare i post in quelle fasce.

SKILL.md

Calendario dei contenuti

Pianificare una settimana o un mese partendo da ciò che funziona già: prima il piano, i post dopo la tua approvazione.

SKILL.md

Set di hashtag

Gestire i set di hashtag salvati di un profilo e riusarli invece di riscrivere i tag.

SKILL.md

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

14

Bozze, 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)

8

Copertura, 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

6

Fuso orario, limiti del piano, profili collegati, bacheche e categorie.

account_getprofiles_listprofiles_getprofiles_platforms_listprofiles_get_pinterest_boardsprofiles_get_youtube_categories

Set di hashtag

6

Riusa i gruppi di hashtag salvati per ogni profilo, senza riscriverli.

hashtags_listhashtags_createhashtags_deletehashtag_groups_createhashtag_groups_updatehashtag_groups_delete

Media

3

URL 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.

MCP è 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
Vedi i prezzi

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

Prova gratis