# Integrazione MCP (/it/docs/verdent-for-vscode/advanced-features/mcp)
> Estendi Verdent con server e plugin del Model Context Protocol
### Cosa imparerai [#cosa-imparerai]
Panoramica dell'integrazione Model Context Protocol (MCP) in Verdent for VS Code, inclusi configurazione, impostazioni e opzioni di estensibilità.
La documentazione completa di MCP è attualmente in fase di sviluppo. Questa pagina offre una panoramica delle funzionalità di MCP, con guide dettagliate in arrivo. Contatta [support@verdent.ai](mailto:support@verdent.ai) per domande specifiche sull'integrazione.
***
## Cos'è MCP (Model Context Protocol)? [#cosè-mcp-model-context-protocol]
Il Model Context Protocol (MCP) è un sistema di integrazione che estende le capacità di Verdent collegandolo a strumenti, fonti di dati e servizi esterni.
**Concetto chiave:**
MCP consente a Verdent di interagire con sistemi che vanno oltre il suo set di strumenti integrato, permettendo un'integrazione fluida con:
* API e servizi web esterni
* Sistemi di database
* Piattaforme cloud (AWS, Azure, GCP)
* Strumenti di gestione dei progetti
* Pipeline CI/CD
* Strumenti interni personalizzati
**Architettura:**
I server MCP fungono da ponti tra Verdent e i sistemi esterni. Ogni server MCP espone capacità specifiche che Verdent può invocare durante le sessioni di programmazione, in modo simile agli strumenti integrati come `file_read` o `bash`.
**Archiviazione della configurazione:**
Le configurazioni dei server MCP sono memorizzate in `~/.verdent/mcp.json` e gestite tramite il menu Impostazioni.
***
## Vantaggi dell'integrazione MCP [#vantaggi-dellintegrazione-mcp]
### Capacità estese [#capacità-estese]
**Accesso a sistemi esterni:**
Collega Verdent a strumenti e servizi non disponibili tramite le funzionalità integrate. Interroga database, interagisci con servizi cloud o integra API specifici del progetto senza uscire dal tuo flusso di lavoro di programmazione.
**Sviluppo di strumenti personalizzati:**
Crea server MCP su misura per i requisiti unici del tuo progetto. Costruisci integrazioni specializzate per strumenti interni, API proprietari o sistemi specifici di dominio.
### Interoperabilità [#interoperabilità]
**Sfrutta l'ecosistema:**
Attingi al crescente ecosistema MCP. I server MCP sviluppati dalla community forniscono integrazioni predefinite per strumenti e servizi popolari.
**Protocollo standardizzato:**
MCP offre un'interfaccia coerente per l'integrazione degli strumenti, garantendo che le nuove capacità si integrino senza problemi con il sistema di strumenti esistente di Verdent.
### Automazione del flusso di lavoro [#automazione-del-flusso-di-lavoro]
**Integrazione fluida:**
I server MCP diventano parte del set di strumenti di Verdent. L'agente usa automaticamente gli strumenti MCP quando è opportuno, oppure puoi invocarli esplicitamente per attività specifiche.
**Operazioni consapevoli del contesto:**
Le integrazioni MCP comprendono il contesto della tua codebase, permettendo interazioni intelligenti con i sistemi esterni in base allo stato attuale dello sviluppo.
***
## Configurare i server MCP [#configurare-i-server-mcp]
### Processo di configurazione [#processo-di-configurazione]
**Accedere alle impostazioni MCP:**
1. Apri il menu Impostazioni in Verdent
2. Vai alla sezione **Server MCP**
3. Visualizza o modifica la configurazione `~/.verdent/mcp.json`
**File di configurazione:**
I server MCP vengono configurati tramite il file `~/.verdent/mcp.json`, che definisce le connessioni ai server, l'autenticazione e i parametri di integrazione.
Lo schema di configurazione dettagliato di MCP e le istruzioni di setup sono in fase di finalizzazione. Per assistenza immediata sulla configurazione dei server MCP, consulta la specifica del protocollo MCP o contatta il supporto Verdent.
### Gestione della configurazione [#gestione-della-configurazione]
**Aggiungere server:**
Configura nuovi server MCP aggiungendo voci a `mcp.json` con i dettagli di connessione e le credenziali di autenticazione.
**Server multipli:**
Verdent supporta più server MCP simultanei, permettendo l'integrazione con diversi sistemi esterni allo stesso tempo.
**Testare le connessioni:**
Convalida le configurazioni dei server MCP per assicurarti che le connessioni abbiano successo prima di usarle nei flussi di lavoro di sviluppo.
***
## Plugin ed estensioni MCP [#plugin-ed-estensioni-mcp]
### Plugin disponibili [#plugin-disponibili]
I plugin MCP forniscono integrazioni predefinite per strumenti e servizi comuni.
È in fase di compilazione un elenco curato dei plugin MCP disponibili. Consulta la documentazione ufficiale di Verdent o le risorse dell'ecosistema MCP per la disponibilità attuale dei plugin.
**Categorie di plugin previste:**
* **Integrazioni di database:** strumenti di query per PostgreSQL, MySQL, MongoDB
* **Servizi cloud:** interazioni con API di AWS, Azure, GCP
* **Strumenti per sviluppatori:** integrazioni con GitHub, GitLab, Jira, Linear
* **Piattaforme CI/CD:** Jenkins, GitHub Actions, CircleCI
* **Servizi di monitoraggio:** Datadog, New Relic, Sentry
* **Comunicazione:** notifiche Slack, Discord, Microsoft Teams
### Installazione dei plugin [#installazione-dei-plugin]
**Metodi di installazione:**
I plugin vengono installati e configurati tramite l'interfaccia delle impostazioni MCP e in genere richiedono:
* Identificatore o sorgente del plugin
* Parametri di configurazione
* Credenziali di autenticazione (se applicabili)
**Gestione delle dipendenze:**
I plugin MCP possono avere dipendenze da servizi o librerie esterne. I processi di installazione gestiscono la risoluzione delle dipendenze automaticamente quando possibile.
***
## Sviluppo di server MCP personalizzati [#sviluppo-di-server-mcp-personalizzati]
### Creare server personalizzati [#creare-server-personalizzati]
Gli utenti avanzati possono creare server MCP personalizzati per integrare strumenti proprietari o sistemi specifici di dominio.
**Approccio allo sviluppo:**
I server MCP personalizzati implementano la specifica del protocollo MCP, esponendo capacità degli strumenti che Verdent può invocare.
**Casi d'uso per server personalizzati:**
* **Integrazione di API interne:** collegamento a API e servizi specifici dell'azienda
* **Ponti verso sistemi legacy:** consentire a Verdent di interagire con infrastrutture legacy
* **Fonti di dati specializzate:** accesso a database o data warehouse proprietari
* **Automazione dei flussi di lavoro:** attivazione di pipeline personalizzate di build, deployment o test
Sono in fase di sviluppo guide complete per lo sviluppo di server MCP personalizzati, inclusi i requisiti di implementazione del protocollo, la documentazione dell'SDK e gli strumenti di test. Per esigenze immediate di integrazione personalizzata, consulta la specifica del protocollo MCP.
### Pattern di integrazione [#pattern-di-integrazione]
**Configurazione a livello di workspace:**
I server MCP possono essere configurati a livello di workspace per integrazioni specifiche del progetto, permettendo ai team di condividere le configurazioni MCP tramite il controllo di versione.
**Interoperabilità degli strumenti:**
Gli strumenti forniti da MCP si integrano senza problemi con gli strumenti integrati di Verdent (`file_read`, `bash`, `spawn_subagent`), permettendo flussi di lavoro complessi che combinano più tipi di strumenti.
***
## Esempi di flusso di lavoro MCP [#esempi-di-flusso-di-lavoro-mcp]
### Integrazione di query su database [#integrazione-di-query-su-database]
**Scenario:** interrogare un database di produzione per eseguire il debug di problemi con i dati.
**Approccio MCP:**
```
User: "Check the orders table for customer ID 12345"
Verdent: [Uses MCP database server to execute safe read-only query]
Results: 3 orders found for customer 12345
[Displays formatted results]
```
Il server di database MCP gestisce l'autenticazione, la validazione delle query e la formattazione dei risultati.
### Interazione con servizi cloud [#interazione-con-servizi-cloud]
**Scenario:** controllare i log di una funzione AWS Lambda per individuare errori.
**Approccio MCP:**
```
User: "Show me recent errors from the payment-processor Lambda function"
Verdent: [Invokes MCP AWS integration]
[Retrieves CloudWatch logs for specified function]
[Filters for ERROR level entries]
[Presents formatted error summaries]
```
Il server AWS MCP gestisce l'autenticazione, le chiamate API e il parsing dei log.
### Monitoraggio delle pipeline CI/CD [#monitoraggio-delle-pipeline-cicd]
**Scenario:** controllare lo stato della build prima di distribuire le modifiche.
**Approccio MCP:**
```
User: "Is the main branch build passing?"
Verdent: [Queries MCP CI/CD integration]
Build #245: ✓ Passed (2 minutes ago)
All tests passed, ready for deployment
```
Il server CI/CD MCP traccia lo stato della pipeline e fornisce feedback in tempo reale.
***
## Considerazioni sulla sicurezza [#considerazioni-sulla-sicurezza]
### Autenticazione e autorizzazione [#autenticazione-e-autorizzazione]
**Gestione delle credenziali:**
I server MCP gestiscono l'autenticazione verso i servizi esterni. Le credenziali sono memorizzate in modo sicuro nella configurazione MCP e non vengono mai esposte nella cronologia della chat o nel codice.
**Limitazione dei permessi:**
Configura i server MCP con i permessi minimi necessari. Usa l'accesso in sola lettura ove possibile e limita le operazioni distruttive.
### Operazioni sicure [#operazioni-sicure]
**Revisione dei comandi:**
Le operazioni che coinvolgono gli strumenti MCP possono essere revisionate in Manual Accept Mode prima dell'esecuzione, fornendo visibilità e controllo.
**Registrazione degli audit:**
Le operazioni dei server MCP appaiono nella cronologia della chat di Verdent, creando una traccia di audit delle interazioni con i sistemi esterni.
***
## Risoluzione dei problemi di integrazione MCP [#risoluzione-dei-problemi-di-integrazione-mcp]
### Problemi comuni [#problemi-comuni]
**Errori di connessione:**
* Verifica la connettività di rete verso il server MCP
* Controlla le credenziali di autenticazione in `mcp.json`
* Assicurati che il server MCP sia in esecuzione e accessibile
* Convalida la sintassi del file di configurazione
**Errori di permessi:**
* Conferma che le chiavi API o le credenziali abbiano i permessi richiesti
* Controlla le quote del servizio o i limiti di frequenza
* Verifica che le regole del firewall consentano il traffico MCP
**Problemi di invocazione degli strumenti:**
* Assicurati che il server MCP esponga correttamente gli strumenti attesi
* Controlla che i formati dei parametri degli strumenti corrispondano alle aspettative del server
* Esamina i log del server MCP per i dettagli sugli errori
### Ottenere aiuto [#ottenere-aiuto]
**Canali di supporto:**
* Supporto Verdent: [support@verdent.ai](mailto:support@verdent.ai)
* [Documentazione del protocollo MCP](https://modelcontextprotocol.io)
* [Community Discord di Verdent](https://discord.com/invite/NGjXEZcbJq) per supporto in tempo reale
**Informazioni diagnostiche:**
Quando segnali problemi di MCP, fornisci:
* Tipo e versione del server MCP
* Dettagli di configurazione (con le credenziali rimosse)
* Messaggi di errore dalla cronologia della chat
* Log del server MCP (se accessibili)
***
## Risorse di documentazione MCP [#risorse-di-documentazione-mcp]
### Documentazione ufficiale [#documentazione-ufficiale]
Sono in fase di sviluppo guide complete all'integrazione MCP, tra cui:
* Specifica completa del protocollo MCP
* Documentazione dell'SDK per lo sviluppo di server
* Marketplace e registro dei plugin
* Esempi e tutorial di integrazione
* Riferimento API per lo sviluppo di server personalizzati
**In arrivo:**
* Guide passo passo alla configurazione dei server MCP
* Procedure guidate per l'installazione e la configurazione dei plugin
* Tutorial per lo sviluppo di server personalizzati
* Best practice per l'integrazione MCP
* Ottimizzazione delle prestazioni per i flussi di lavoro MCP
### Risorse provvisorie [#risorse-provvisorie]
**Informazioni attuali su MCP:**
* Specifica del protocollo MCP (esterna)
* Server ed esempi MCP sviluppati dalla community
* Repository GitHub dell'ecosistema MCP
**Contatti per i dettagli:**
Per assistenza immediata all'integrazione MCP, contatta [support@verdent.ai](mailto:support@verdent.ai) indicando il tuo caso d'uso specifico e i requisiti di integrazione.
***
## Vedi anche [#vedi-anche]
Capacità degli strumenti integrati
Altri metodi di estensione
Impostazioni e preferenze di Verdent
Tecniche di prompting efficaci