Integrazione MCP

Cosa imparerai

Panoramica dell'integrazione Model Context Protocol (MCP) in Verdent for VS Code, inclusi configurazione, impostazioni e opzioni di estensibilità.

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

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à

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

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

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.

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 disponibili

I plugin MCP forniscono integrazioni predefinite per strumenti e servizi comuni.

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

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

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

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

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

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

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

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

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

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

Canali di supporto:

• Supporto Verdent: support@verdent.ai
• Documentazione del protocollo MCP
• Community Discord di Verdent 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

Documentazione ufficiale

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

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 indicando il tuo caso d'uso specifico e i requisiti di integrazione.

Vedi anche