Windsurf MCP
Pubblica sui social media da Windsurf
Aggiungi Onlypult a Windsurf e Cascade può trasformare la documentazione, il registro delle modifiche e i file in bozze e post programmati su oltre 15 social network, senza uscire dall’editor.
- Un blocco JSON
- Ospitato o locale
- Caricamento dal disco
Crea tre bozze di post LinkedIn da docs/whats-new.md e programmale per lunedì, mercoledì e venerdì alle 10:00.
Tre post programmati sulla tua pagina LinkedIn:
- BozzaLun 10:00 — Cartelle intelligenti
- BozzaMer 10:00 — Modelli condivisi
- BozzaVen 10:00 — Modalità scura
Come aggiungere Onlypult a Windsurf
Windsurf tiene i server MCP in ~/.codeium/windsurf/mcp_config.json. Aprilo dal pannello MCP di Cascade (Gestisci MCP → Vedi configurazione grezza).
https://mcp.onlypult.com/mcp Gira sulla tua macchina, così Cascade può caricare file dal progetto. 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
Aggiungi il blocco qui sotto a
mcp_config.jsone sostituisci la chiave. - 3
Fai clic su Aggiorna nel pannello MCP di Cascade e controlla che onlypult elenchi i suoi strumenti.
{
"mcpServers": {
"onlypult": {
"command": "npx",
"args": ["-y", "@onlypult/mcp@latest"],
"env": {
"ONLYPULT_API_KEY": "op_your_api_key"
}
}
}
} Niente da eseguire in locale. Windsurf usa serverUrl per i server remoti.
- 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
Aggiungi il blocco qui sotto a
mcp_config.jsone sostituisci la chiave. - 3
Aggiorna il pannello MCP.
{
"mcpServers": {
"onlypult": {
"serverUrl": "https://mcp.onlypult.com/mcp",
"headers": {
"Authorization": "Bearer op_your_api_key"
}
}
}
} Controlla che funzioni: chiedi a Cascade «Mostra i miei profili social collegati in Onlypult».
Prompt Windsurf che funzionano
Cascade vede il progetto, quindi i post nascono da modifiche vere e da file veri.
Annuncia ciò che hai costruito
“Leggi la descrizione dell’ultima PR unita e crea una bozza di post LinkedIn e una di post su X sulla funzionalità. Solo bozze.”
Dai file ai post
“Carica ./marketing/launch.mp4 e crea una bozza di Reel Instagram e di Short YouTube con titolo «Novità nella 2.4».”
Contenuti dalla documentazione
“Trasforma README.md in una serie di cinque post LinkedIn, uno ogni lunedì alle 10:00.”
Controllo della coda
“Cosa è programmato in Onlypult per la prossima settimana? Elenca i buchi e crea bozze per riempirli.”
Sistema i fallimenti
“Elenca i post non riusciti degli ultimi 7 giorni, spiega il perché e riprova quelli con retryable.”
Istantanea dei risultati
“Mostra copertura e coinvolgimento della nostra pagina LinkedIn questo mese rispetto al mese scorso.”
Skill per Windsurf
Aggiungi gli skill di Onlypult a Windsurf
Gli skill sono semplici file SKILL.md. Insegnano a Cascade il flusso intorno a ogni strumento Onlypult: la modalità giusta, il fuso orario, i limiti e le alternative. Copiali nello spazio di lavoro e Cascade usa quello che corrisponde alla richiesta.
Installa per Windsurf
Clona il repository e copia gli skill in .windsurf/skills/ dello spazio di lavoro.
git clone https://github.com/onlypult/agent-skills.git
mkdir -p .windsurf/skills
cp -r agent-skills/skills/* .windsurf/skills/ 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 Windsurf e risoluzione dei problemi
Gli strumenti non compaiono
Fai clic su Aggiorna nel pannello MCP dopo aver modificato la configurazione e controlla che il JSON sia valido: una virgola finale di troppo rompe l’intero file.
Troppi strumenti attivi
Cascade limita quanti strumenti MCP possono essere attivi insieme, su tutti i server. Se arrivi al tetto, disattiva gli strumenti Onlypult che non usi, per esempio analisi o hashtag.
Server ospitato e file
Il server ospitato non può leggere il disco. Usa il pacchetto locale per caricare file dal progetto, oppure passa URL pubblici.
Approvazioni
Lascia l’esecuzione automatica disattivata per pubblicazione ed eliminazione, così Cascade chiede prima che un post vada online.
«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.
Windsurf e Onlypult: FAQ
Windsurf supporta MCP?
Sì. Cascade supporta server MCP locali (stdio) e remoti, configurati in ~/.codeium/windsurf/mcp_config.json.
Windsurf può pubblicare sui social media?
Sì, tramite Onlypult. Cascade può creare bozze, programmare e pubblicare su oltre 15 social network e allegare file dal progetto con il pacchetto locale.
È incluso nel mio piano?
Sì. MCP è 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 configurazioneUn comando nel terminale. Trasforma un registro delle modifiche, un rilascio o un repository in post senza uscire dalla CLI.
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 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
Rilascia, poi pubblica
Aggiungi Onlypult a Windsurf e lascia che Cascade prepari l’annuncio mentre la compilazione è ancora in corso.
7 giorni gratis · Nessuna carta · MCP e API in tutti i piani
