DeviL dentro il tuo Claude Code

1. Cos’è e cosa ci fai

Claude Code è l’assistente di Anthropic che lavora nel tuo terminale. Con un comando colleghi DeviL come server MCP (il modo standard con cui Claude Code usa strumenti esterni): da quel momento Claude Code può leggere i tuoi lead, i dossier e i tuoi progetti su DeviL, e scriverci analisi, bozze e schede.

• Carica i tuoi progetti: legge i repo sul tuo computer e crea le schede (il codice non esce dal tuo computer, a DeviL arriva solo la scheda).
• Analizza le aziende: legge il dossier, cerca in rete (LinkedIn aziendale, notizie, offerte di lavoro), verifica le date e cita le fonti.
• Scrive le lettere con il tuo nome, i tuoi recapiti e i tuoi casi reali, solo nei canali consentiti.
• Non serve una chiave AI: usi il tuo abbonamento Claude.

2. Collegalo in 3 passi

1. 1

   Installa Claude Code (se non l’hai già)

   Serve un account Claude con Claude Code. Le istruzioni ufficiali sono su code.claude.com/docs. Verifica nel terminale con claude --version.

2. 2

   Crea un token su DeviL

   In DeviL vai su Impostazioni → Claude Code e API (o nel passo 3 del benvenuto), dai un nome al token (es. “portatile”) e premi Crea token. Compare il comando già compilato con il tuo token: copialo. Il token si vede una volta sola.

3. 3

   Incolla il comando nel terminale

   Vale uguale in macOS, Linux e Windows (PowerShell). Il comando ha questa forma:

   claude mcp add --transport http --scope user devil https://devil.vibecanyon.com/api/mcp --header "Authorization: Bearer cbs_IL_TUO_TOKEN"

   Copia

   --scope user rende DeviL disponibile in tutti i tuoi progetti, da qualsiasi cartella. Controlla che sia collegato con claude mcp list (deve dire “Connected”) oppure, dentro Claude Code, con il comando /mcp.

3. Le prime richieste

Apri Claude Code (nella cartella dei tuoi progetti, se vuoi caricarli) e scrivi in italiano. Qualche esempio da copiare:

Leggi i progetti in questa cartella (README, package.json, rotte, schema) e caricali su DeviL come schede. Prima guarda il formato e quelle già presenti.

Cosa c’è da fare oggi su DeviL? Fammi un riepilogo delle mosse.

Lavora la coda DeviL: per ogni azienda leggi il dossier, cerca in rete con le fonti, verifica le date, scrivi analisi e una lettera, poi invia i risultati.

Chi sono le aziende più adatte al mio progetto gestionale-cantieri? Mostrami le prime 10 con l’aderenza.

Avvia una ricerca di aziende in provincia di Bergamo e Brescia.

Claude Code ti chiederà il permesso la prima volta che usa uno strumento di DeviL: puoi approvarlo una volta o sempre. Tutto quello che invia lo ritrovi nella scheda dell’azienda (analisi, fonti, bozze) e in I miei progetti (schede).

4. Lascialo in ascolto: la coda si lavora da sola

DeviL non può aprire Claude Code sul tuo computer (è sempre Claude Code a chiamare DeviL, mai il contrario). Però puoi lasciarlo in ascolto: apri Claude Code e incolla una volta questo comando.

/loop 10m lavora la coda DeviL: analisi in coda (dossier_da_lavorare con top 0), poi cantieri (cantieri_da_lavorare)

• Ogni 10 minuti controlla la coda: se trova aziende le analizza e manda le bozze, se è vuota non fa niente.
• Da DeviL metti in coda quello che vuoi (scheda azienda, “Prepara con Claude”, “Metti in coda le 5 migliori”): arriva da solo entro 10 minuti.
• Nel riquadro Claude di Oggi vedi se è “in ascolto” e quando è passato l’ultima volta.
• Funziona finché il computer è acceso e la finestra di Claude Code resta aperta; per fermarlo chiudila. Per lavorare anche a computer spento c’è la chiave API (Impostazioni → Integrazioni), a consumo.

5. Gli strumenti che Claude Code vede

panoramica

Situazione: piano, zona, numeri e le prossime 10 mosse consigliate. Il punto di partenza.

cerca_aziende

Cerca fra le tue aziende per testo, provincia, settore, priorità, distanza, bozze pronte.

scheda_azienda

Il dossier completo: persone e canali ammessi, segnali, dati pubblici, date, testo del sito.

dossier_da_lavorare

Le aziende messe in coda (più le migliori non analizzate) con le regole di scrittura.

invia_risultati

Manda analisi e bozze: quelle in canali non consentiti vengono scartate e segnalate.

metti_in_coda

Mette un’azienda in coda, con canale e indicazioni (es. “proponi l’app rapportini”).

abbinamenti

Aziende abbinate a un tuo progetto, oppure i 5 colpi più facili e i progetti più richiesti.

formato_schede

Formato e valori ammessi delle schede progetto, con un esempio.

portfolio_elenco

Le schede già caricate, per non duplicarle.

portfolio_salva

Inserisce o aggiorna fino a 50 schede progetto lette dai tuoi repo.

avvia_ricerca

Avvia la ricerca di nuove aziende in una o più province.

Non devi chiamarli per nome: descrivi cosa vuoi e Claude Code sceglie gli strumenti giusti.

6. Sicurezza e privacy

• Il token dà accesso ai dati della tua organizzazione: trattalo come una password, non metterlo in repo condivisi.
• Se lo perdi o cambi computer, revocalo da Impostazioni → Claude Code e API e creane un altro.
• Le regole privacy valgono anche qui: email e WhatsApp solo con consenso o rapporto in essere; le bozze fuori regola vengono scartate.
• I limiti del tuo piano (aziende, analisi al mese) valgono come nell’app.

7. Se qualcosa non va

“Failed to connect” o 401

Il token è sbagliato, scaduto o revocato. Creane uno nuovo e ricollega: claude mcp remove devil --scope user, poi di nuovo il comando del passo 3.

403 “Account sospeso”

La prova o l’abbonamento sono scaduti: lo vedi in Impostazioni → Piano.

429 “Troppe richieste”

Il limite è di 120 richieste al minuto per token: aspetta un minuto e riprova.

Claude Code non vede DeviL in un’altra cartella

Il collegamento è stato fatto senza --scope user: rimuovilo e rifai il comando del passo 3.

Preferisci non usare MCP?

In Impostazioni → Claude Code e API trovi le istruzioni da incollare in Claude Code, che lavorano con le API e il token in una variabile d’ambiente.

Serve aiuto? Scrivi a devil@vibecanyon.com. Torna a DeviL