# Getting Started — NetStrategy AI Plugin Marketplace Guida onboarding per i colleghi NetStrategy che vogliono iniziare a usare il marketplace AI privato di NetStrategy. Pensata per chi non l'ha mai aperto prima. **Tempo stimato per completare il setup:** 30-45 minuti. --- ## Cos'è il marketplace Il **NetStrategy AI Plugin Marketplace** è una raccolta di "plugin" — pacchetti di automazioni che girano in [Claude Code](https://claude.ai/code) — pensati per i task ricorrenti dei vari reparti NetStrategy: monitoring contatti, estrazione ordini, invio fatture, polling task, aggiornamento KPI, e altro. Ogni plugin è **configurabile per cliente**: tu lo installi una volta, poi attraverso un wizard interattivo (`/-setup`) gli dici "questi sono i miei clienti" e lui da quel momento lavora per te. **Reparti coperti:** ADV (in arrivo), SEO, IT, Amministrazione, PM, Grafica (in arrivo), Copy (in arrivo). --- ## Prerequisiti Prima di iniziare assicurati di avere: 1. **Claude Code** installato sul tuo PC ([scarica](https://claude.ai/code)) 2. Un **account Claude attivo** (Pro o Team) 3. **Accesso al repository GitHub** `netstrategy-ns/claude-marketplace` (privato — chiedi a lorenzo.t@netstrategy.it di aggiungerti) 4. **Sessione browser attiva** sui servizi che userai (HubSpot, Google Sheets, Atomiko, ecc.) — i plugin usano la tua sessione Chrome esistente, non si loggano per te 5. **RoboForm o equivalente** configurato con le credenziali dei backend cliente (per i plugin che lo richiedono) --- ## Step 1 — Aggiungi il marketplace a Claude Code Apri Claude Code e digita: ``` /plugin marketplace add netstrategy-ns/claude-marketplace ``` Conferma quando ti chiede l'autenticazione GitHub. Verifica che funzioni: ``` /plugin marketplace list ``` Dovresti vedere `netstrategy-marketplace` con il numero corretto di plugin disponibili (oggi 15). --- ## Step 2 — Scegli il tuo reparto Apri la [landing del marketplace](./index.html) e identifica i plugin del tuo reparto. Filtra con la pillola corrispondente in cima al catalogo. | Reparto | Plugin disponibili | |---|---| | **PM** | `pm-hubspot-monitoring`, `pm-flamingo-monitoring`, `pm-prestashop-monitoring`, `pm-task-polling`, `pm-kpi-rollup` | | **Amministrazione** | `amministrazione-ads-invoice` | | **IT** | `zucchetti-it-tickets` | | SEO / ADV / Grafica / Copy | (in arrivo) | Tutti i plugin pubblicati sono **configurabili multi-cliente**: dopo l'install configuri i tuoi clienti via wizard senza dover toccare il codice. --- ## Step 3 — Installa il primo plugin Esempio: sei un PM e vuoi monitorare i contatti HubSpot dei tuoi clienti. ``` /plugin install netstrategy-pm-hubspot-monitoring@netstrategy-marketplace /reload-plugins ``` Dopo il reload, i comandi del plugin sono accessibili con il namespace `/netstrategy-pm-hubspot-monitoring:`: ``` /netstrategy-pm-hubspot-monitoring:hubspot-setup ``` > **Nota sul namespace:** Claude Code prefissa i comandi con il nome del plugin per evitare collisioni. Le prime volte usa l'auto-completion (TAB) per trovare i comandi. --- ## Step 4 — Configura i tuoi clienti via wizard Ogni plugin ha un wizard interattivo che ti guida passo passo. Il pattern è sempre lo stesso: 1. **Domande base** sul cliente: nome, URL del servizio, foglio di destinazione 2. **Mappatura colonne**: per ogni colonna del tuo foglio Google scegli se scrivere un valore fisso, un campo della sorgente (es. HubSpot email), o saltarla (la compili tu manualmente) 3. **Configurazioni specifiche** del plugin (sorgenti da escludere, range date, mapping pagamenti, ecc.) 4. **Schedule** (orario di esecuzione automatico) 5. **Stima costi** mostrata PRIMA della conferma 6. **Salvataggio config** in `~/.claude/netstrategy/-clients.json` (sul tuo PC, privato) Per aggiungere clienti successivi, usa `/.../-add-client` (mostra anche il nuovo totale costi aggregato). Per vedere tutti i clienti configurati: `/.../-list-clients`. Per modificare: `/.../-edit-client`. Per rimuovere: `/.../-remove-client`. --- ## Step 5 — Esegui o pianifica Dopo la configurazione, hai 2 opzioni: ### A. Esecuzione manuale (on-demand) Dal chat di Claude Code chiedi: > "Esegui la skill `-monitoring` per il cliente " Oppure, in Cowork: > "Lancia il monitoring per " ### B. Esecuzione automatica (scheduled task) Il wizard ti chiede in fondo se creare una scheduled task. Se rispondi "sì", crea il file `~/Documents/Claude/Scheduled/-/SKILL.md`. Quel task viene poi registrato nel sistema scheduled tasks di Cowork e parte automaticamente all'orario impostato. > **Importante per il primo run automatico:** Cowork deve essere aperto all'orario schedulato. Se è chiuso, la task parte al successivo avvio dell'app. --- ## Glossario | Termine | Cosa significa | |---|---| | **Plugin** | Pacchetto installabile in Claude Code che contiene una skill + comandi | | **Skill** | Il "cervello" del plugin — un file Markdown con istruzioni passo passo che Claude segue | | **Comando slash** | `/` che invoca un wizard del plugin (es. `/hubspot-setup`) | | **Scheduled task** | File in `~/Documents/Claude/Scheduled/` che fa partire automaticamente una skill a un orario | | **Wizard** | Sessione interattiva che ti chiede dati e crea la config del plugin | | **Column mapping** | La regola che dice a un plugin "questa colonna del foglio scrivila così" | | **Dedup column** | La colonna usata per evitare di scrivere duplicati (di solito email) | | **RoboForm** | Password manager usato dai plugin per fare login automatico | --- ## Costi — trasparenza Ogni plugin mostra la stima costi PRIMA di confermare la configurazione. Le stime sono basate su ~€0,08/run per i monitoring giornalieri e ~€0,15/run per workflow più complessi (invoice, KPI multi-source). Esempi indicativi: | Scenario | Costo mensile | |---|---| | 1 cliente HubSpot, lun-ven | ~€1,76 | | 5 clienti HubSpot + 3 Flamingo, lun-ven | ~€14 | | Task polling 7x/giorno per 1 utente | ~€18 | | KPI rollup mensile per 11 clienti | ~€1,20 | Per vedere il totale aggregato: `/-list-clients` (lo riporta in fondo alla tabella). --- ## Troubleshooting **"competenza sconosciuta" quando lancio un comando** → Hai dimenticato di fare `/reload-plugins` dopo l'install. Esegui ora. **"Sessione HubSpot/Gmail/Atomiko scaduta"** → Apri il servizio nel browser, fai login manualmente, poi rilancia il plugin. Il plugin **non** ti loggherà automaticamente per sicurezza. **"RoboForm non ha completato il login automatico"** → Verifica che RoboForm sia sbloccato (master password inserita) e che abbia le credenziali del servizio. Riprova. **"Il marketplace dice X plugin available ma non vedo il nuovo plugin"** → Refresh del marketplace: `/plugin marketplace update`, poi nel pannello premi `u` su `netstrategy-marketplace` e Enter. **"I dati immessi violano le regole di convalida" su Google Sheets** → Il valore non corrisponde a un'opzione del dropdown. Usa `/-edit-client` per correggere il mapping della colonna problematica. **"Tool requires user interaction" o "unsupervised mode"** → Stai usando il tool degli scheduled task da una modalità che non supporta gli approval. Apri una nuova chat Cowork interattiva o segnala a `lorenzo.t@netstrategy.it`. --- ## Domande frequenti **Posso usare un plugin senza schedulare niente?** Sì. Salta lo step "vuoi creare la scheduled task" alla fine del wizard. Lancierai il plugin manualmente quando ti serve. **I miei dati cliente sono al sicuro?** Sì. La config sta su `~/.claude/netstrategy/` del **tuo** PC, non viene mai inviata fuori. Le credenziali non vengono mai inserite manualmente dai plugin (solo RoboForm). **Cosa succede se Cowork è chiuso quando una scheduled task deve partire?** La task parte al successivo avvio di Cowork. Quindi se vuoi affidabilità garantita su task mattutine, tieni Cowork aperto in tray. **Posso modificare un mapping colonne dopo averlo salvato?** Sì, `/-edit-client` permette di modificare singole colonne. **Posso usare gli stessi plugin per più clienti?** Sì — è esattamente il punto dei plugin generalizzati. Configurali col tuo primo cliente, poi `/-add-client` per aggiungerne altri. --- ## Supporto Per problemi o richieste: - **Email:** lorenzo.t@netstrategy.it - **Issue su GitHub:** [netstrategy-ns/claude-marketplace/issues](https://github.com/netstrategy-ns/claude-marketplace) - **Slack/Chat interno:** scrivi a Lorenzo Quando segnali un problema, includi: 1. Nome del plugin 2. Comando che hai eseguito 3. Output ricevuto (screenshot va benissimo) 4. Cosa ti aspettavi --- ## E adesso? - Installa il primo plugin del tuo reparto - Configura il primo cliente col wizard - Lancia un run manuale per verificare che tutto funzioni - Solo dopo, attiva la scheduled task Buon lavoro 🚀