Pubblicare sui social dal tuo agente di IA
PlanVortex è una piattaforma di pubblicazione sui social con API pubblica e server MCP ufficiale. Un agente può programmare pubblicazioni, leggere la casella dei commenti e rispondere ai messaggi diretti su tutti i tuoi social, e chiedere al nostro pianificatore di scrivere l'intera settimana. In Claude si collega dalla directory dei connettori senza installare nulla; in qualsiasi altro client è un comando, con le credenziali del tuo account.
npx -y planvortex-mcpIl server MCP ufficiale. Non c'è nulla da installare: lo avvia il tuo client di IA.In Claude ti basta il tuo account PlanVortex. Per farlo girare sulla tua macchina ti serve un'app di PlanVortex, e ce ne sono su tutti e quattro i piani: 1 nel gratuito, 2 in Basic, 5 in Pro e fino a 10 in Custom. Non serve pagare per collegare un agente.
Nella directory dei connettori di Claude, e pubblicato nel registro ufficiale MCP, su Glama e su Smithery.
Cosa può fare un agente con PlanVortex
Trentuno strumenti, raggruppati per ciò su cui agiscono. Ventidue leggono e nove scrivono. Il trentaduesimo, create_ai_plan, non compare nell'elenco finché non lo accendi tu, perché consuma crediti di IA del tuo account.
| Gruppo | Strumenti |
|---|---|
| Contesto | list_organizationslist_accountsget_plan_useget_unread_counts |
| Pubblicazione | list_publicationsget_publicationlist_destinationscreate_publicationupdate_publicationretry_publication |
| Pianificatore di IA | get_planner_templateslist_store_productslist_ai_plansget_ai_planget_ai_plan_results(create_ai_plan) |
| Media | upload_media |
| Commenti | list_commentsget_comment_threadreply_to_commenthide_commentmark_comment_read |
| Messaggi | list_conversationslist_messagessend_message |
| Numeri | get_dashboard_summaryget_publication_statsget_top_publicationsget_account_metrics |
| Catalogo | get_social_limitsget_social_capabilitiescreate_connect_link |
In più: tre prompt pronti all'uso (weekly_plan, inbox_triage e publish_from_brief) e quattro risorse con i limiti di ogni rete, le sue capacità, la matrice dei commenti e le tue organizzazioni. Le differenze tra le reti viaggiano come dati, così il modello non deve indovinare cosa permette ciascuna.
Le reti disponibili
Facebook, Instagram, Threads, LinkedIn, TikTok, X, WhatsApp, YouTube, Bluesky, Discord, Telegram, Slack e Pinterest. Pubblicano tutte tranne WhatsApp, che è messaggistica, quindi lì l'agente legge, risponde e misura. Slack fa esattamente il contrario: pubblica e misura, ma non ha commenti né messaggi diretti, perché è un canale di team e non un pubblico. Pinterest pubblica e misura, ma nemmeno lui ha commenti (la sua API non li dà), e ogni pin va in una bacheca: l'agente le elenca con list_destinations e ne sceglie una a ogni pubblicazione.
La chiamata che scrive la settimana
Quasi tutti i server MCP per i social lasciano che sia il modello a scrivere i testi. Questo non ne ha bisogno: PlanVortex ha il suo pianificatore, e un agente può chiedergli una settimana intera partendo da un tema, dalle tue foto, da un articolo o dal catalogo del tuo negozio.
> Preparami la settimana per il forno: pane a lievitazione naturale, usa le mie foto di agosto e pubblicalo su Instagram e LinkedIn. get_planner_templates() → from_images: 0 crediti immagine · 7 pubblicazioni create_ai_plan({ template: "from_images", accounts: [...] }) → preventivo: 350 crediti · stato: pending get_ai_plan(plan) // minuti dopo → generated · 7 bozze con testo e foto
Generare richiede minuti e non è una sola chiamata: create_ai_plan mette in coda il piano e restituisce il preventivo, get_ai_plan si interroga finché non finisce, e ciò che esce sono bozze. Programmarle resta una tua decisione, una alla volta.
Il costo si sa prima di generare
Il server calcola quanto costa il piano e lo restituisce quando lo mette in coda. Un piano che non rientra nei tuoi crediti viene rifiutato per intero invece di essere generato a metà, così un agente in loop non può svuotarti l'account senza che tu te ne accorga.
E lo accendi tu, con una riga
create_ai_plan è l'unico strumento che spende denaro, quindi viene registrato solo con PLANVORTEX_MCP_ALLOW_AI=1 nella tua configurazione. Spento non compare nemmeno nell'elenco degli strumenti: non c'è modo di chiamarlo. Quella riga la scrive una persona, una volta, prima che parta qualsiasi agente.
Cinque modelli, e due non consumano immagini
get_planner_templates pubblica tutti e cinque con quanto costa ciascuno, così l'agente può spiegarti il prezzo prima di chiederti il permesso. Quelli che partono dalle tue foto o dal tuo catalogo non consumano un solo credito immagine.
Come si installa il server MCP
In Claude non c'è nulla da installare. Sulla tua macchina sono tre passi, e nessuno passa da noi: il server gira lì, con le tue credenziali.
In Claude, senza installare nulla
Nel browser, nell'app desktop o sul telefono: apri PlanVortex nella directory dei connettori di Claude, clicca Connect, accedi con il tuo account PlanVortex e clicca Allow. Niente Node, niente app e niente client_secret, e funziona su tutti e quattro i piani. Claude ti chiede conferma prima di pubblicare, rispondere o nascondere qualcosa.
In Claude Code è una riga, anche qui senza credenziali. Poi scrivi /mcp, scegli planvortex e seleziona Authenticate: il browser apre lo stesso accesso.
claude mcp add --transport http planvortex \ https://mcp.planvortex.com/mcp
Claude agisce come te, con quello che i tuoi ruoli ti permettono nel pannello. Rispetto al server locale cambiano tre cose: gli account social si collegano nel pannello, anche i piani di IA si creano lì (Claude li legge) e upload_media prende un URL pubblico, perché il server non vede il tuo disco.
Apri PlanVortex nella directory di Claude →Crea un'app nel pannello
In Impostazioni → App. Ti dà un client_id e un client_secret. Le app ci sono su tutti e quattro i piani, quindi nel gratuito questo non costa nulla.
Aggiungi il server al tuo client di IA
Un comando in Claude Code, oppure il blocco JSON qui sotto in Claude Desktop, Cursor e VS Code. Non c'è nulla da installare: npx lo scarica all'avvio.
Chiedigli qualcosa
«Cosa ho programmato questa settimana, e quali commenti sono ancora da leggere?». Se risponde con i tuoi account veri, funziona.
claude mcp add planvortex \ --env PLANVORTEX_CLIENT_ID=... \ --env PLANVORTEX_CLIENT_SECRET=... \ -- npx -y planvortex-mcp
{ "mcpServers": { "planvortex": { "command": "npx", "args": ["-y", "planvortex-mcp"], "env": { "PLANVORTEX_CLIENT_ID": "...", "PLANVORTEX_CLIENT_SECRET": "...", "PLANVORTEX_ORGANIZATION_ID": "..." } } } }
PLANVORTEX_ORGANIZATION_ID è facoltativa e conviene impostarla: senza, l'agente spende una chiamata per conversazione per capire di quale organizzazione parli.
Non hai Node? Ogni versione pubblica anche un pacchetto .mcpb che Claude Desktop installa con un doppio clic.
Scarica il .mcpb dell'ultima versione →Tutte le variabili d'ambiente
| Variabile | Obbligatoria? | Cosa fa |
|---|---|---|
| PLANVORTEX_CLIENT_ID | sì | Il client_id della tua app. Tutti i piani hanno app. |
| PLANVORTEX_CLIENT_SECRET | sì | Il suo segreto. Non viaggia mai come argomento di uno strumento. |
| PLANVORTEX_ORGANIZATION_ID | no | Organizzazione predefinita. Risparmia una chiamata di scoperta per conversazione. |
| PLANVORTEX_BASE_URL | no | Punta a un altro deployment di PlanVortex. |
| PLANVORTEX_MCP_UPLOAD_DIRS | no | Le cartelle da cui upload_media può leggere. Vuota significa nessuna. |
| PLANVORTEX_MCP_AUTH_TOKEN | con --http fuori da locale | Il token che l'endpoint HTTP richiede per legarsi a qualcosa che non sia locale. |
| PLANVORTEX_MCP_READ_ONLY | no | 1 toglie dall'elenco i nove strumenti che scrivono. |
| PLANVORTEX_MCP_ALLOW_AI | no | 1 aggiunge create_ai_plan, che consuma crediti di IA. |
| PLANVORTEX_MCP_LOG_LEVEL | no | debug, info, warn, error o silent. Sempre su stderr. |
Cosa non può fare, e come spegnere ciò che può
Questo server mette nel contesto del modello testo scritto da sconosciuti (un commento, una recensione, un messaggio diretto) mentre quello stesso modello ha strumenti per pubblicare sui tuoi account. I limiti qui sotto sono la risposta a questo.
Non cancella nulla, e non si può accendere
Nessuno strumento cancella una pubblicazione, un account o un commento. Non è un'opzione spenta di default: il codice non esiste. Il caso peggiore possibile deve essere qualcosa che vedi e annulli.
Modalità di sola lettura
Con PLANVORTEX_MCP_READ_ONLY=1 i nove strumenti che scrivono non vengono registrati, quindi non compaiono nell'elenco e il modello non può nemmeno provare a chiamarli. Restano ventidue che leggono soltanto.
Gira sulla tua macchina
Il client_secret vive nel processo che avvia il tuo client di IA, mai su un nostro server. E se preferisci ospitarlo tu, la modalità --http porta il suo Dockerfile, ascolta solo in locale ed esige un token per legarsi a qualsiasi altra cosa.
Non legge il tuo disco
upload_media apre soltanto i file dentro le cartelle che dichiari in PLANVORTEX_MCP_UPLOAD_DIRS, e quell'elenco è vuoto di fabbrica. Senza configurarlo, l'agente non può caricare un tuo file nemmeno se il modello lo chiede.
Se il tuo agente non parla MCP, parla HTTP
Tutto ciò che fa il server MCP è anche nell'API pubblica, aperta su tutti e quattro i piani, quello gratuito compreso.
L'API, 135 operazioni
OAuth 2.0 con client_credentials, JSON, e lo stesso catalogo di errori numerato che usano le librerie. La documentazione completa è pubblica.
Vedi la documentazione →Due librerie ufficiali
npm i planvortex e pip install planvortex. Entrambe pubblicano con provenance e portano il gestore di token, il caricamento di file e gli errori tipizzati.
Per sviluppatori →Un nodo per n8n
Se il tuo agente vive in un flusso di n8n, il nodo verificato di PlanVortex pubblica, carica file e risponde ai commenti senza scrivere una sola richiesta. Usa le stesse credenziali dell'app.
Vedi il nodo →E quattro file leggibili senza scansionare nulla
Stanno nella radice del sito, sono testo semplice e non hanno JavaScript davanti. Se sei un agente che valuta questo strumento, comincia da qui.
/llms.txtCos'è PlanVortex, per chi, con i prezzi verificati/llms-full.txtL'API intera in testo semplice: tutte le 135 operazioni con i parametri/openapi.jsonL'OpenAPI completo, per generarti un client in qualsiasi linguaggio/pricing.mdLa tariffa, in markdown e senza compilare un modulo
Domande frequenti
Cos'è il server MCP di PlanVortex?
È il server ufficiale Model Context Protocol che collega un assistente di IA ai tuoi account social. Offre trentuno strumenti per programmare pubblicazioni, leggere commenti, rispondere ai messaggi e consultare le metriche su tutti i tuoi social. Si installa con npx e gira sulla tua macchina con le credenziali di un'app, oppure, in Claude, si collega dalla directory dei connettori con il tuo account PlanVortex.
Serve un piano a pagamento per collegare un agente?
No. Le app che danno le credenziali ci sono su tutti e quattro i piani, quello gratuito compreso, che include 1 app, 2 account collegati, pubblicazioni illimitate e 1 GB di spazio, senza carta. Con il piano cambia quante app separate hai e il ritmo delle chiamate.
Su quali social può pubblicare un agente?
Su Facebook, Instagram, Threads, LinkedIn, TikTok, X, YouTube, Bluesky, Discord, Telegram, Slack e Pinterest. Su WhatsApp non si pubblica: è messaggistica, quindi l'agente legge, risponde e misura.
Un agente può cancellare una pubblicazione o un account?
No. Nessuno dei trentadue strumenti cancella una pubblicazione, un account o un commento, e non è un'opzione lasciata spenta: quel codice non esiste nel server. È l'unica garanzia seria che si può dare a un modello che legge testo di sconosciuti mentre può pubblicare a tuo nome.
Dove finisce il mio client_secret?
Nel processo che avvia il tuo client di IA, sulla tua macchina. Non passa da nessun nostro server e non viaggia mai come argomento di uno strumento, quindi non finisce nella cronologia della conversazione né nel contesto del modello.
L'agente può scrivere il contenuto, non solo programmarlo?
Sì, e non lo scrive il modello: lo scrive il pianificatore di PlanVortex partendo da un tema, dalle tue foto, da un articolo o dal catalogo del tuo negozio. Generare consuma crediti di IA, quindi quello strumento va acceso a mano con PLANVORTEX_MCP_ALLOW_AI=1. Ciò che esce sono bozze.
Funziona con Claude Desktop, Cursor e VS Code?
Sì. In Claude (browser, app desktop e telefono) è nella directory dei connettori: accedi con il tuo account PlanVortex e non installi nulla. Claude Code si configura con un comando, e Cursor e VS Code con lo stesso blocco JSON nel loro file dei server MCP.
E se il mio agente non usa MCP?
Allora usa l'API pubblica via HTTP: 135 operazioni con OAuth 2.0, aperte su tutti e quattro i piani. Ci sono librerie ufficiali di Node e Python, l'OpenAPI completo pubblicato nella radice del sito e una versione della documentazione in testo semplice pensata perché la legga un modello. E se lavora dentro n8n, c'è un nodo verificato: n8n-nodes-planvortex.
Un comando, e il tuo assistente pubblica
Crea un'app nel piano gratuito, incolla le due credenziali nel tuo client di IA e chiedigli cosa hai programmato questa settimana. Non serve la carta.