Documentazione: collegare DeployIt al vostro Claude

Tutto DeployIt sta in una pagina: collegarsi, cinque strumenti e come leggere una risposta.

Collegarsi

Il vostro amministratore vi ha dato il link della vostra azienda. Somiglia a questo:

https://mcp.deployit.ai/acme/k7mq-x2pf-9tdr

In Claude

  1. Aprite Personalizza, poi Connettori, e aggiungete un connettore personalizzato. Su un account Team o Enterprise, lo aggiunge una volta un proprietario per tutta l'organizzazione, da Impostazioni organizzazione, poi Connettori; poi ognuno clicca «Connetti».
  2. Incollate il link. Claude apre una pagina di DeployIt (in inglese, francese o spagnolo): indicate il vostro nome e la vostra e-mail (l'indirizzo non viene verificato).
  3. Fatto. Ponete una domanda: «Cosa sai di questo prodotto?»

In Claude Code

claude mcp add --transport http deployit https://mcp.deployit.ai/acme/k7mq-x2pf-9tdr

Alla prima domanda, Claude Code apre la stessa pagina di registrazione.

Accesso automatico (beta, su richiesta)

Se la vostra organizzazione Claude gestisce gli accessi tramite il suo provider di identità, l'accesso automatico può registrarvi senza digitare nulla. È in beta, su richiesta: il vostro amministratore DeployIt ci scrive per aprirlo. Il vostro indirizzo è allora attestato quando l'emittente è Claude o quando il vostro provider di identità lo contrassegna come verificato; altrimenti resta dichiarato.

Per l'amministratore

  • Nella configurazione dell'accesso automatico della vostra organizzazione Claude, compilate sempre «Tenant ID» con l'identificativo della vostra azienda in DeployIt (la parte del vostro link che segue mcp.deployit.ai/): solo la vostra azienda riceve allora le vostre asserzioni.
  • Una volta attivato l'accesso automatico, l'identificativo della vostra azienda non cambia più.
  • Un profilo che avete assegnato in anticipo a un indirizzo viene dato solo a un indirizzo attestato: l'emittente è Claude, oppure il vostro provider di identità contrassegna l'indirizzo come verificato. Altrimenti, la persona entra con «Tutti».
  • Una persona che avete rimosso non rientra tramite l'accesso automatico.

DeployIt è un server MCP in HTTP, con un'autorizzazione OAuth aperta a Claude (web e desktop) e ai client locali come Claude Code. Gli altri client web non possono iscriversi, e Cursor o Windsurf non possono ancora.

Un vecchio indirizzo con chiave risponde «questo link è cambiato»: chiedete il link della vostra azienda al vostro amministratore.

I cinque strumenti

Non dovete chiamarli: è l'assistente a scegliere. Nessuno modifica i vostri repository né le vostre impostazioni; ogni chiamata è registrata nel registro della vostra azienda; uno strumento della vostra azienda che aprite all'agente agisce con i propri diritti.

StrumentoProfiliRiceveRestituisce
server_infoTuttinienteIl prodotto, i suoi repository, la freschezza della lettura e ciò che il vostro profilo apre.
ask_codeTutti, Sviluppatori, Direzioneuna domanda e, se serve, «approfondisci», se il vostro profilo lo consenteUna risposta, il suo stato e ciò che è stato consultato. Da 20 a 60 secondi la prima volta; immediato dopo per la stessa domanda negli stessi termini e senza contesto, finché il codice non è cambiato.
recent_changesTutti, Sviluppatori, Direzioneun numero di giorni, da 1 a 90, 14 per impostazione predefinita; se serve, un repositoryCiò che è arrivato sul branch seguito, raggruppato in consegne (per PR, o per giorno, modulo e tipo): data, tipo, titolo, moduli, numero di commit; senza nomi di persone. Immediato.
stats_schemaDirezione, Strumento datinienteI set di statistiche, la definizione di ogni misura e l'ora dell'ultimo calcolo.
stats_queryDirezione, Strumento datiuna query strutturata: set di dati, periodo, filtri, raggruppamenti, misure, limiteRighe: per team o per sviluppatore, per mese, trimestre, semestre o anno.

Il server propone anche tre richieste pronte all'uso, perché la stessa tabella torni identica da un mese all'altro:

RichiestaProfiliRestituisce
team_reportperiod_unit, period (facoltativi)DirezioneIl monitoraggio del team su un periodo.
developer_profiledeveloper · period_unit, period (facoltativi)DirezioneLa scheda di uno sviluppatore su un periodo.
what_changeddays (facoltativo, 7 per impostazione predefinita)Tutti, Sviluppatori, DirezioneCosa è cambiato nel prodotto.

Leggere una risposta

Ogni risposta sul codice porta uno stato. È lui che dice se potete ripeterla.

Verificatoverified
Confermato nel codice. Potete ripeterlo.
Solo lato serverbackend_only
Il prodotto sa farlo, ma nessuna schermata vi conduce.
Non trovatonot_found
Cercato senza essere trovato: molto probabilmente assente dal prodotto. Non è una prova.
Senza conclusioneunknown
L'indagine non è andata a buon fine. Non ripetetela come un fatto; ponete di nuovo la domanda con «approfondisci», se il vostro profilo lo consente.

Quando DeployIt non risponde

  • Il vostro accesso è stato rimosso da un amministratore.
  • L'argomento è tra quelli che la vostra azienda ha rifiutato.
  • Il vostro tetto mensile di domande è raggiunto (il profilo «Tutti» ne ha uno per impostazione predefinita).
  • La vostra azienda ha raggiunto il volume mensile di domande previsto dal suo piano: il contatore riparte il mese successivo.
  • Il piano gratuito ha usato le sue 15 domande della settimana: tornano lunedì.
  • Senza piano né prova, il profilo «Direzione» non vede gli strumenti di statistiche, e una chiave di strumento dati riceve un rifiuto.

Ogni rifiuto viene detto chiaramente al vostro assistente, che ve lo ripete.

Le statistiche

Fatti scritti una volta per commit integrato, aggiornati ogni notte. Ogni riga rimanda ai suoi commit.

I set di dati

commits
Un commit integrato: il suo autore, la sua data di arrivo, la sua PR, i suoi test, il suo ticket, il suo modulo, il suo voto e i suoi cinque criteri.
pull_requests
Una PR: chi l'ha aperta, chi l'ha rivista (un collega, non il suo autore né un bot), in quanto tempo.
reviews
Una revisione: chi ha rivisto quale PR, se è un collega dell'autore, e il suo verdetto (approvata, modifiche richieste; su GitLab, solo le approvazioni).
defects
Un difetto: il commit d'origine, la sua correzione, chi ha corretto, e se è «confermato» o «da confermare».
people
Una persona seguita, o un agente di codice: le sue identità, il suo ruolo, il suo tempo di lavoro, se è un fornitore esterno.
absences
Gli intervalli di assenza dichiarati per una persona, per leggere la sua attività senza false flessioni.
repositories
I repository coperti, il loro branch di arrivo, da quando è letta la loro cronologia e l'ora dell'ultimo calcolo.
module_ownership
Chi ha scritto ogni modulo negli ultimi 12 mesi, per vedere quelli che dipendono da una sola persona.
person_period, team_period
Le sintesi per sviluppatore e per team, per mese, trimestre, semestre o anno.

Le colonne di ogni set, la definizione di ogni misura e i limiti si leggono con lo strumento stats_schema: fa fede.

Le regole di lettura

  • Il voto del codice è una media: si restituisce sempre con il numero di commit che riassume.
  • Un difetto si rivela a posteriori: gli ultimi 60 giorni non sono ancora maturi, e lo strumento stats_schema lo dice.
  • Un periodo chiuso può ancora cambiare (un commit arrivato in ritardo, due identità unite, un difetto scartato): ogni sintesi porta l'ora del suo ultimo calcolo.
  • Conta solo il lavoro arrivato sul branch di arrivo di ogni repository, e conta al suo arrivo: un commit datato prima ma integrato questo mese conta per questo mese. I bot sono esclusi; gli agenti di codice rilevati sono contati a parte; un agente non dichiarato conta come lavoro umano.

Collegare uno strumento dati

Un data warehouse o uno strumento di BI non si registra: presenta una chiave «Strumento dati», creata da un amministratore e mostrata una sola volta, in un'intestazione.

POST https://mcp.deployit.ai/acme
Authorization: Bearer dpk_…

Chiama stats_query e segue il cursore per leggere tutte le righe. Un commit può cambiare dopo (un difetto si rivela entro 60 giorni): rileggete almeno gli ultimi 60 giorni a ogni passaggio. La chiave non apre alcuna domanda sul codice.

Limiti

  • 120 chiamate al minuto e per persona; 600 al minuto per una chiave di strumento dati.
  • L'attesa è limitata a un minuto; poi l'indagine prosegue in background: ponete di nuovo la stessa domanda un po' più tardi, con le stesse parole e senza contesto.
  • Piano gratuito: 15 domande sul codice a settimana per tutta l'azienda, da lunedì a domenica. Una risposta già nota non conta.
  • Con un piano, le domande sono incluse nel limite di un uso normale, visibile nel vostro spazio. Il profilo «Tutti» ha un tetto predefinito di 40 domande al mese per persona; l'amministratore regola questo tetto, profilo per profilo. Raggiunto il tetto, le risposte già note continuano a essere servite.
  • Una query di statistiche restituisce al massimo 5.000 righe (500 per il profilo Direzione) e risponde in al massimo 10 secondi; oltre, seguite il cursore o suddividete per periodo.
  • La demo risponde con il profilo «Tutti», senza statistiche, e limita il numero di domande per indirizzo.

Indirizzo della demo:

https://mcp.deployit.ai/demo

Collegate il vostro codice e fate la prima domanda

30 giorni di prova, senza carta di credito. DeployIt legge i vostri repository: nessun commit, nessun branch, nessuna PR.