Integrazione MCP

Cos'è MCP (Model Context Protocol)?

Model Context Protocol (MCP) è un sistema di integrazione che amplia le capacità di Verdent collegandolo a strumenti, sorgenti 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 ponte tra Verdent e i sistemi esterni. Ogni server MCP espone capacità specifiche che Verdent può invocare durante le sessioni di coding, in modo simile agli strumenti integrati come file_read o bash.

Archiviazione della configurazione: Le configurazioni dei server MCP sono salvate in ~/.verdent/mcp.json e gestite tramite il menu Settings.

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 specifiche del progetto senza abbandonare il tuo flusso di lavoro di coding.

Sviluppo di strumenti personalizzati: Crea server MCP su misura per i requisiti unici del tuo progetto. Costruisci integrazioni specializzate per strumenti interni, API proprietarie o sistemi specifici del dominio.

Interoperabilità

Sfruttare l'ecosistema: Attingi al crescente ecosistema MCP. I server MCP sviluppati dalla community offrono integrazioni predefinite per strumenti e servizi popolari.

Protocollo standardizzato: MCP fornisce 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 utilizza automaticamente gli strumenti MCP quando appropriato, oppure puoi invocarli esplicitamente per attività specifiche.

Operazioni consapevoli del contesto: Le integrazioni MCP comprendono il contesto del tuo codebase, permettendo interazioni intelligenti con i sistemi esterni in base allo stato di sviluppo corrente.

Configurare i server MCP

Processo di configurazione

Accedere alle impostazioni MCP:

1. Apri il menu Settings in Verdent
2. Vai alla sezione MCP Servers
3. Visualizza o modifica la configurazione ~/.verdent/mcp.json

File di configurazione: I server MCP si configurano tramite il file ~/.verdent/mcp.json, che definisce le connessioni ai server, l'autenticazione e i parametri di integrazione. Consulta la sezione Configurazione MCP più sotto per lo schema completo.

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 concorrenti, consentendo l'integrazione con diversi sistemi esterni contemporaneamente.

Testare le connessioni: Convalida le configurazioni dei server MCP per assicurarti che le connessioni funzionino prima di usarle nei flussi di lavoro di sviluppo.

Stato del server

Monitora lo stato della connessione nel pannello delle impostazioni MCP:

Aggiornare gli strumenti: Seleziona il pulsante di aggiornamento per riscoprire gli strumenti disponibili di un server dopo modifiche alla configurazione o problemi di connessione.

Configurazione MCP

Configurazione di base

Posizione: .mcp.json nella radice del progetto oppure ~/.verdent/mcp.json (globale)

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "postgresql://localhost:5432/myapp_dev"
      ]
    }
  }
}

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  }
}

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "postgresql://localhost:5432/myapp_dev"
      ]
    },
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  }
}

Chiavi di configurazione:

• mcpServers - Chiave di primo livello obbligatoria per la configurazione MCP
• command - Eseguibile da avviare (in genere npx per i pacchetti Node.js)
• args - Argomenti passati al comando (nome del pacchetto, stringhe di connessione, ecc.)
• env - Variabili d'ambiente per autenticazione/configurazione

Plugin ed estensioni MCP

Plugin disponibili

I plugin MCP forniscono integrazioni predefinite per strumenti e servizi comuni. Sfoglia il registro della community su mcp.so/servers oppure il repository ufficiale dei server MCP per la disponibilità attuale.

Categorie di plugin comuni:

• Integrazioni con 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 su Slack, Discord, Microsoft Teams

Installazione dei plugin

Metodi di installazione: I plugin si installano e configurano tramite l'interfaccia delle impostazioni MCP e in genere richiedono:

• Identificatore o sorgente del plugin
• Parametri di configurazione
• Credenziali di autenticazione (se necessarie)

Gestione delle dipendenze: I plugin MCP possono avere dipendenze da servizi o librerie esterni. I processi di installazione gestiscono automaticamente la risoluzione delle dipendenze 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 del dominio.

Approccio allo sviluppo: I server MCP personalizzati implementano la specifica del protocollo MCP, esponendo capacità di strumenti che Verdent può invocare. Consulta la specifica di Model Context Protocol per i dettagli di implementazione e gli SDK.

Casi d'uso per i server personalizzati:

• Integrazione con API interne: collegamento a API e servizi specifici dell'azienda
• Ponti verso sistemi legacy: consentono a Verdent di interagire con infrastrutture legacy
• Sorgenti dati specializzate: accesso a database o data warehouse proprietari
• Automazione dei flussi di lavoro: avvio di pipeline personalizzate di build, deployment o testing

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 version control.

Interoperabilità degli strumenti: Gli strumenti forniti da MCP si integrano senza problemi con gli strumenti integrati di Verdent (file_read, bash, spawn_subagent), consentendo flussi di lavoro complessi che combinano più tipi di strumenti.

Funzionalità MCP specifiche del desktop

Configurazione per progetto

MCP multi-worktree

I server MCP funzionano tra i vari worktree:

• Server condivisi: la configurazione MCP del workspace di base è condivisa da tutti i worktree
• Operazioni isolate: ogni worktree mantiene uno stato di sessione MCP separato
• Accesso parallelo: più worktree possono usare gli stessi server MCP contemporaneamente

Cambio di progetto

Quando cambi progetto:

• Vengono caricati i server MCP del progetto corrente
• I server MCP globali restano disponibili
• Le connessioni MCP del progetto precedente vengono mantenute in background

Esempi di flussi di lavoro MCP

Integrazione di query su database

Scenario: interrogare il database di produzione per il debug di problemi sui 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 a API e il parsing dei log.

Monitoraggio della pipeline CI/CD

Scenario: controllare lo stato della build prima di distribuire le modifiche.

Approccio MCP:

User: "Is the master 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 un riscontro 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 salvate 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 il minimo di permessi necessari. Usa l'accesso in sola lettura quando possibile e limita le operazioni distruttive.

Operazioni sicure

Revisione dei comandi: Le operazioni che coinvolgono gli strumenti MCP compaiono nella cronologia della conversazione, offrendo visibilità e controllo.

Registro di audit: Le operazioni dei server MCP compaiono nella cronologia della chat di Verdent, creando una traccia di audit delle interazioni con i sistemi esterni.

Risoluzione dei problemi dell'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 di servizio o i limiti di frequenza
• Verifica che le regole del firewall consentano il traffico MCP

Problemi nell'invocazione degli strumenti:

• Assicurati che il server MCP esponga correttamente gli strumenti previsti
• Controlla che i formati dei parametri degli strumenti corrispondano alle aspettative del server
• Esamina i log del server MCP per i dettagli dell'errore

Ottenere aiuto

Canali di supporto:

• Supporto Verdent: support@verdent.ai
• Documentazione del protocollo MCP
• Community Discord di Verdent

Informazioni diagnostiche: Quando segnali problemi con 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)

Domande frequenti