Server MCP per Claude Code

DeviL dentro il tuo Claude Code: un server MCP per trovare clienti.

DeviL espone un server MCP (Model Context Protocol) che il tuo Claude Code collega con un solo comando. Da quel momento puoi cercare aziende, leggere dossier completi, analizzare con ricerca in rete e fonti citate, scrivere bozze e gestire i Cantieri di sviluppo senza uscire dal terminale. È il modo consigliato di usare DeviL: sfrutta il tuo abbonamento Claude senza costi aggiuntivi.

Richiedi un invito Come funziona

Cos’è il server MCP di DeviL e a cosa serve

MCP (Model Context Protocol) è lo standard di Anthropic con cui Claude Code usa strumenti esterni. DeviL espone un server MCP all’indirizzo /api/mcp: collegarlo significa che Claude Code può leggere i tuoi lead, i dossier, i tuoi progetti e scriverci analisi, bozze e schede.

Il vantaggio rispetto alla sola chiave API è che Claude Code cerca ogni azienda in rete (LinkedIn aziendale, notizie, offerte di lavoro) e cita le fonti. Nessuna chiave da consegnare a DeviL: usi il tuo abbonamento Claude esistente.

Come collegare DeviL a Claude Code in tre passi

Primo: in DeviL vai su Impostazioni → Claude Code e API, 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, poi puoi revocarlo in qualsiasi momento.

Secondo: incolla il comando nel terminale (macOS, Linux o Windows PowerShell). Il flag --scope user lo rende disponibile in tutti i tuoi progetti, da qualsiasi cartella. Terzo: verifica con claude mcp list (deve dire «Connected») o con /mcp dentro Claude Code.

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

Gli strumenti MCP disponibili: tutto quello che Claude Code può fare su DeviL

DeviL espone fino a 17 strumenti, secondo il livello: 8 con Base, 10 con Search, 14 con Dev, tutti con Build. Non devi chiamarli per nome: descrivi in italiano quello che vuoi e Claude Code sceglie gli strumenti giusti.

panoramica — Situazione dell’organizzazione: piano, zona, numeri e le 10 mosse consigliate. Usalo per primo. Esempio: «Fammi il punto della situazione su DeviL»
cerca_aziende — Cerca fra le aziende per testo, provincia, settore, priorità minima, distanza, bozze pronte, analizzate o no. Esempio: «Trovami officine meccaniche in provincia di Bergamo con priorità sopra 60»
scheda_azienda — Dossier completo in Markdown: persone e canali ammessi, segnali, dati pubblici (ANAC, archive.org) e testo del sito. Da leggere prima di analizzare. Esempio: «Dammi il dossier dell’azienda con id [uuid]»
dossier_da_lavorare — Scarica le aziende in coda (e le migliori non analizzate) con il README: regole di scrittura, verifica delle date, ricerca in rete e formato dei risultati. Esempio: «Lavora la coda DeviL»
invia_risultati — Invia analisi e bozze. Le bozze in canali non consentiti vengono scartate e segnalate. Esempio: «Invia i risultati che ho preparato per le tre aziende»
cantieri_da_lavorare — (Build) Cantieri messi in coda dall’utente: brief per quelli nuovi, istruzioni per proseguire quelli in corso. Esempio: «Ci sono cantieri da lavorare?»
aggiorna_cantiere — (Build) Aggiorna avanzamento, stato (in_corso, tappa_finita, completato), prossima tappa, domanda per l’utente. Usalo alla fine di ogni tappa. Esempio: «Ho finito la prima tappa, aggiorna il cantiere [id]»
pubblica_demo — (Build) Pubblica la build statica sullo spazio demo di DeviL (solo se l’utente ha premuto «Pubblica la demo» nel portale). Esempio: «Pubblica la demo del cantiere [id]»
azienda_crea — Aggiunge un’azienda a mano con gli stessi controlli del portale; se esiste già restituisce quella. Esempio: «Aggiungi la Rossi Impianti di Lecco, me l’ha segnalata un cliente»
offerte_elenco — (Search) Le tue offerte con quante aziende sono adatte a ciascuna. Esempio: «Quali offerte ho su DeviL e a chi propongo la prima?»
offerte_salva — (Search) Crea o aggiorna un’offerta: settori, parole chiave, province. Esempio: «Crea un’offerta per i siti con prenotazione online per i ristoranti di Como»
metti_in_coda — Mette un’azienda in coda con canale e indicazioni specifiche. Esempio: «Metti in coda questa azienda e proponile l’app rapportini»
abbinamenti — (Dev) Aziende abbinate a un tuo progetto per aderenza e livello, oppure i 5 colpi più facili e la classifica dei progetti per domanda. Esempio: «Chi è più adatto al mio gestionale-cantieri?»
formato_schede — (Dev) Formato e valori ammessi delle schede progetto con un esempio. Da leggere prima di portfolio_salva. Esempio: «Mostrami il formato per le schede progetto»
portfolio_elenco — (Dev) Le schede già caricate (anche le bozze): leggile prima di inviarne di nuove per non duplicare. Esempio: «Quali progetti ho già su DeviL?»
portfolio_salva — (Dev) Inserisce o aggiorna fino a 50 schede progetto lette dai repo locali. Esempio: «Leggi i repo in questa cartella e crea le schede su DeviL»
avvia_ricerca — Avvia la ricerca di nuove aziende in max 8 province (sigle). Esempio: «Avvia una ricerca in provincia di Milano e Monza»

La modalità /loop: la coda si lavora da sola

MCP va in una sola direzione: è Claude Code che chiama DeviL, non il contrario. Per farlo lavorare in autonomia, incolla una volta questo comando in Claude Code e lascia la finestra aperta.

Ogni 10 minuti controlla la coda delle analisi e dei Cantieri. Se trova aziende le analizza e manda le bozze; se è vuota non fa niente. In Oggi → riquadro Claude vedi se è «in ascolto» e quando è passato l’ultima volta.

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

I Cantieri: costruire software a tappe con Claude Code

In «Da costruire» avvii un Cantiere: Claude Code riceve il brief via cantieri_da_lavorare, crea la cartella, salva il CLAUDE.md, esegue la prima tappa e chiama aggiorna_cantiere. Poi si ferma e aspetta che tu prema «Prosegui» nel portale.

Per ogni tappa Claude Code può aggiornare avanzamento, fare domande, riportare commit e — quando l’utente lo chiede — pubblicare la demo. Tre destinazioni: solo sul tuo PC (nessuna pubblicazione), sul tuo server (solo dopo il tuo sì esplicito) o sullo spazio DeviL (demo.vibecanyon.com, build statiche, 90 giorni, massimo 5 demo online).

pubblica_demo carica la build solo dopo che l’utente preme «Pubblica la demo» nel portale: mai in automatico.
aggiorna_cantiere accetta demo_url (per demo con server sul tuo VPS) e demo_accesso (credenziali e istruzioni di prova).
Lo standard grafico è incluso nel brief: Tailwind CSS 4, menu laterale su desktop, barra in basso su telefono, screenshot Playwright a 390 e 1440 px prima di chiudere ogni tappa.

Sicurezza del token: scoped e revocabile

Il token dà accesso ai dati della tua organizzazione. Creane uno per dispositivo, dagli un nome riconoscibile (es. «portatile», «fisso»), trattalo come una password e non metterlo in repository condivisi.

Se cambi computer o perdi il token, revocalo da Impostazioni → Claude Code e API e creane un altro. Ogni token dà accesso a tutti gli strumenti compresi nel livello dell’organizzazione. Il rate limit è di 120 richieste al minuto per token.

Problemi comuni con il server MCP

«Failed to connect» o errore 401: il token è sbagliato, scaduto o revocato. Rimuovi il server (claude mcp remove devil --scope user) e ripeti il collegamento. Errore 403 «Account sospeso»: vai in Impostazioni → Piano. Errore 429: aspetta un minuto (limite 120 richieste/minuto).

Claude Code non vede DeviL in un’altra cartella: il collegamento è stato fatto senza --scope user. Rimuovi e ricollega. La guida passo passo con screenshot è su devil.vibecanyon.com/guida/claude-code.

Domande frequenti

Posso limitare cosa può fare un token?

No: ogni token dà accesso a tutti gli strumenti compresi nel livello dell’organizzazione. Gestisci i rischi creando un token separato per dispositivo e revocandolo se smetti di usarlo o perdi l’accesso a quel computer.

Posso usare il server MCP senza un abbonamento Claude Code?

No: il server MCP di DeviL è progettato per Claude Code. Se non hai Claude Code, puoi usare la chiave Anthropic (Impostazioni → Integrazioni) per le bozze, a consumo (circa 0,25 € ad azienda analizzata).

Il server MCP funziona per un team?

Sì. Solo gli amministratori possono creare token (uno per persona o dispositivo, nei limiti del piano). I limiti su aziende e analisi sono condivisi dall’organizzazione intera.

Posso connettermi con altri client MCP oltre a Claude Code?

Il server segue lo standard MCP HTTP di Anthropic: qualsiasi client compatibile può connettersi con il comando HTTP e il token Bearer. DeviL è ottimizzato per Claude Code, che è il client per cui le descrizioni degli strumenti sono scritte.

Collega il tuo Claude Code a DeviL

La beta è su invito e gratuita per 30 giorni. Richiedi il codice: il collegamento richiede un solo comando nel terminale.

Richiedi un invito

Beta su invito

Raccontami cosa vendi. Ti mando il codice.

I posti della beta sono pochi, per seguire bene ognuno. Rispondo personalmente entro 48 ore, con il codice di accesso e due righe su come partire da quello che vendi.

✓ 30 giorni gratuiti, rinnovabili durante la beta
✓ Configurazione guidata in 3 passi
✓ Da fondatore: −30% per sempre su qualsiasi livello