Integração com MCP

O que você vai aprender

Visão geral da integração com o Model Context Protocol (MCP) no Verdent for VS Code, incluindo configuração, ajustes e opções de extensibilidade.

O que é o MCP (Model Context Protocol)?

O Model Context Protocol (MCP) é um sistema de integração que estende as capacidades do Verdent conectando-o a ferramentas, fontes de dados e serviços externos.

Conceito central: O MCP permite que o Verdent interaja com sistemas além do seu conjunto de ferramentas integrado, possibilitando integração fluida com:

• APIs e serviços web externos
• Sistemas de banco de dados
• Plataformas de nuvem (AWS, Azure, GCP)
• Ferramentas de gerenciamento de projetos
• Pipelines de CI/CD
• Ferramentas internas personalizadas

Arquitetura: Os servidores MCP atuam como pontes entre o Verdent e os sistemas externos. Cada servidor MCP expõe capacidades específicas que o Verdent pode invocar durante as sessões de codificação, de forma semelhante a ferramentas integradas como file_read ou bash.

Armazenamento de configuração: As configurações dos servidores MCP são armazenadas em ~/.verdent/mcp.json e gerenciadas pelo menu Settings.

Benefícios da integração com MCP

Capacidades estendidas

Acesso a sistemas externos: Conecte o Verdent a ferramentas e serviços não disponíveis na funcionalidade integrada. Consulte bancos de dados, interaja com serviços de nuvem ou integre APIs específicas de projeto sem sair do seu fluxo de trabalho de codificação.

Desenvolvimento de ferramentas personalizadas: Crie servidores MCP sob medida para os requisitos exclusivos do seu projeto. Construa integrações especializadas para ferramentas internas, APIs proprietárias ou sistemas específicos de domínio.

Interoperabilidade

Aproveitamento do ecossistema: Aproveite o crescente ecossistema do MCP. Servidores MCP desenvolvidos pela comunidade oferecem integrações prontas para ferramentas e serviços populares.

Protocolo padronizado: O MCP fornece uma interface consistente para integração de ferramentas, garantindo que novas capacidades se integrem perfeitamente ao sistema de ferramentas existente do Verdent.

Automação de fluxos de trabalho

Integração fluida: Os servidores MCP passam a fazer parte do conjunto de ferramentas do Verdent. O agente usa automaticamente as ferramentas do MCP quando apropriado, ou você pode invocá-las explicitamente para tarefas específicas.

Operações cientes do contexto: As integrações do MCP entendem o contexto da sua base de código, possibilitando interações inteligentes com sistemas externos com base no estado atual do desenvolvimento.

Configurando servidores MCP

Processo de configuração

Acessar as configurações do MCP:

1. Abra o menu Settings no Verdent
2. Navegue até a seção Servidores MCP
3. Visualize ou modifique a configuração de ~/.verdent/mcp.json

Arquivo de configuração: Os servidores MCP são configurados pelo arquivo ~/.verdent/mcp.json, que define conexões de servidor, autenticação e parâmetros de integração.

Gerenciamento de configuração

Adicionar servidores: Configure novos servidores MCP adicionando entradas em mcp.json com detalhes de conexão e credenciais de autenticação.

Múltiplos servidores: O Verdent oferece suporte a múltiplos servidores MCP simultâneos, permitindo a integração com vários sistemas externos ao mesmo tempo.

Testar conexões: Valide as configurações dos servidores MCP para garantir conexões bem-sucedidas antes de usá-los nos fluxos de trabalho de desenvolvimento.

Plugins e extensões do MCP

Plugins disponíveis

Os plugins do MCP oferecem integrações prontas para ferramentas e serviços comuns.

Categorias de plugins esperadas:

• Integrações de banco de dados: ferramentas de consulta para PostgreSQL, MySQL, MongoDB
• Serviços de nuvem: interações com APIs da AWS, Azure, GCP
• Ferramentas de desenvolvimento: integrações com GitHub, GitLab, Jira, Linear
• Plataformas de CI/CD: Jenkins, GitHub Actions, CircleCI
• Serviços de monitoramento: Datadog, New Relic, Sentry
• Comunicação: notificações no Slack, Discord, Microsoft Teams

Instalação de plugins

Métodos de instalação: Os plugins são instalados e configurados pela interface de configurações do MCP, normalmente exigindo:

• Identificador ou origem do plugin
• Parâmetros de configuração
• Credenciais de autenticação (se aplicável)

Gerenciamento de dependências: Os plugins do MCP podem ter dependências de serviços ou bibliotecas externas. Os processos de instalação lidam com a resolução de dependências automaticamente quando possível.

Desenvolvimento de servidores MCP personalizados

Criando servidores personalizados

Usuários avançados podem criar servidores MCP personalizados para integrar ferramentas proprietárias ou sistemas específicos de domínio.

Abordagem de desenvolvimento: Servidores MCP personalizados implementam a especificação do protocolo MCP, expondo capacidades de ferramentas que o Verdent pode invocar.

Casos de uso para servidores personalizados:

• Integração de API internas: conecte-se a APIs e serviços específicos da empresa
• Pontes para sistemas legados: permita que o Verdent interaja com infraestrutura legada
• Fontes de dados especializadas: acesse bancos de dados ou data warehouses proprietários
• Automação de fluxos de trabalho: acione pipelines personalizados de build, deploy ou testes

Padrões de integração

Configuração no nível do espaço de trabalho: Servidores MCP podem ser configurados no nível do espaço de trabalho para integrações específicas de projeto, permitindo que as equipes compartilhem configurações do MCP por meio do controle de versão.

Interoperabilidade de ferramentas: As ferramentas fornecidas pelo MCP se integram perfeitamente às ferramentas integradas do Verdent (file_read, bash, spawn_subagent), possibilitando fluxos de trabalho complexos que combinam vários tipos de ferramentas.

Exemplos de fluxos de trabalho do MCP

Integração de consulta a banco de dados

Cenário: Consultar o banco de dados de produção para depurar problemas de dados.

Abordagem do 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]

O servidor de banco de dados do MCP cuida da autenticação, validação de consulta e formatação dos resultados.

Interação com serviços de nuvem

Cenário: Verificar os logs de uma função AWS Lambda em busca de erros.

Abordagem do 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]

O servidor AWS do MCP gerencia a autenticação, as chamadas de API e a análise de logs.

Monitoramento de pipeline de CI/CD

Cenário: Verificar o status do build antes de implantar mudanças.

Abordagem do 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

O servidor de CI/CD do MCP acompanha o status do pipeline e fornece feedback em tempo real.

Considerações de segurança

Autenticação e autorização

Gerenciamento de credenciais: Os servidores MCP cuidam da autenticação com serviços externos. As credenciais são armazenadas com segurança na configuração do MCP e nunca são expostas no histórico de chat ou no código.

Escopo de permissões: Configure os servidores MCP com as permissões mínimas necessárias. Use acesso somente leitura sempre que possível e restrinja operações destrutivas.

Operações seguras

Revisão de comandos: Operações que envolvem ferramentas do MCP podem ser revisadas no Manual Accept Mode antes da execução, oferecendo visibilidade e controle.

Registro de auditoria: As operações dos servidores MCP aparecem no histórico de chat do Verdent, criando uma trilha de auditoria das interações com sistemas externos.

Solução de problemas da integração com MCP

Problemas comuns

Falhas de conexão:

• Verifique a conectividade de rede com o servidor MCP
• Confira as credenciais de autenticação em mcp.json
• Certifique-se de que o servidor MCP esteja em execução e acessível
• Valide a sintaxe do arquivo de configuração

Erros de permissão:

• Confirme se as chaves de API ou credenciais têm as permissões necessárias
• Verifique cotas de serviço ou limites de taxa
• Confirme se as regras de firewall permitem o tráfego do MCP

Problemas de invocação de ferramentas:

• Certifique-se de que o servidor MCP exponha corretamente as ferramentas esperadas
• Verifique se os formatos dos parâmetros das ferramentas correspondem às expectativas do servidor
• Revise os logs do servidor MCP para detalhes do erro

Obtendo ajuda

Canais de suporte:

• Suporte do Verdent: support@verdent.ai
• Documentação do protocolo MCP
• Comunidade do Verdent no Discord para suporte em tempo real

Informações de diagnóstico: Ao reportar problemas do MCP, forneça:

• Tipo e versão do servidor MCP
• Detalhes da configuração (sem credenciais)
• Mensagens de erro do histórico de chat
• Logs do servidor MCP (se acessíveis)

Recursos de documentação do MCP

Documentação oficial

Em breve:

• Guias passo a passo de configuração de servidores MCP
• Tutoriais de instalação e configuração de plugins
• Tutoriais de desenvolvimento de servidores personalizados
• Práticas recomendadas para integração com o MCP
• Otimização de desempenho para fluxos de trabalho do MCP

Recursos provisórios

Informações atuais do MCP:

• Especificação do protocolo MCP (externa)
• Servidores e exemplos do MCP desenvolvidos pela comunidade
• Repositórios do GitHub do ecossistema do MCP

Contato para detalhes: Para assistência imediata com a integração do MCP, entre em contato com support@verdent.ai informando seu caso de uso específico e os requisitos de integração.

Veja também