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 tredici reti, e chiedere al nostro pianificatore di scrivere l'intera settimana. Si installa con un comando e si autentica 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.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.
Pubblicato nel registro ufficiale MCP, su Glama e su Smithery.
Cosa può fare un agente con PlanVortex
Ventotto strumenti, raggruppati per ciò su cui agiscono. Diciannove leggono e nove scrivono. Il ventinovesimo, 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_publicationcreate_publicationupdate_publicationretry_publication |
| Pianificatore di IA | get_planner_templateslist_ai_plansget_ai_plan(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 tredici reti
Facebook, Instagram, Threads, LinkedIn, TikTok, X, WhatsApp, YouTube, Google Business, Bluesky, Discord, Telegram e Slack. Undici di esse pubblicano; WhatsApp e Google Business non hanno dove farlo —una è messaggistica, l'altra una scheda con recensioni—, quindi lì l'agente legge, risponde e misura. Slack fa esattamente il contrario, e conviene dirlo: pubblica e misura, ma non ha commenti né messaggi diretti, perché è un canale di team e non un pubblico.
La chiamata che scrive e pubblica insieme
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 uno non consuma immagini
get_planner_templates pubblica tutti e cinque con quanto costa ciascuno, così l'agente può spiegarti il prezzo prima di chiederti il permesso. Quello che parte dalle tue foto non consuma un solo credito immagine.
Come si installa il server MCP
Tre passi, e nessuno passa da noi: il server gira sulla tua macchina, con le tue credenziali.
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, e il primo non è un'impostazione.
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.
Sola lettura, davvero
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 diciannove 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
MCP è la porta comoda, non l'unica. Tutto ciò che fa il server è anche nell'API pubblica, aperta su tutti e quattro i piani e senza alcun piano a pagamento per integrarsi.
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 è pubblicata ed è 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 →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 ventotto strumenti per programmare pubblicazioni, leggere commenti, rispondere ai messaggi e consultare le metriche su tredici reti. Si installa con npx, gira sulla tua macchina e usa le credenziali di un'app del 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, 3 account collegati, pubblicazioni illimitate e 1 GB di spazio, senza carta. Con il piano cambia quante app separate hai e il ritmo delle chiamate, non se puoi integrarti.
Su quali social può pubblicare un agente?
Su undici: Facebook, Instagram, Threads, LinkedIn, TikTok, X, YouTube, Bluesky, Discord, Telegram e Slack. WhatsApp e Google Business completano le tredici, ma lì non si pubblica: sono messaggistica e scheda di recensioni, quindi l'agente legge, risponde e misura.
Un agente può cancellare una pubblicazione o un account?
No. Nessuno dei ventinove 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ì. Claude Code si configura con un comando e gli altri tre con lo stesso blocco JSON nel loro file dei server MCP. Se non hai Node, ogni versione pubblica anche un pacchetto .mcpb che Claude Desktop installa con un doppio clic.
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.
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.