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

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

URL del server MCP https://mcp.onlypult.com/mcp

Gira sulla tua macchina, così Cascade può caricare file dal progetto. 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

    Aggiungi il blocco qui sotto a mcp_config.json e sostituisci la chiave.

  3. 3

    Fai clic su Aggiorna nel pannello MCP di Cascade e controlla che onlypult elenchi i suoi strumenti.

Pacchetto locale ~/.codeium/windsurf/mcp_config.json
{
  "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. 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

    Aggiungi il blocco qui sotto a mcp_config.json e sostituisci la chiave.

  3. 3

    Aggiorna il pannello MCP.

Server ospitato ~/.codeium/windsurf/mcp_config.json
{
  "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.

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

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

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

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

Prova gratis