--- title: Integração com MCP description: Estenda o Verdent com servidores e plugins do Model Context Protocol --- ### 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. A documentação completa do MCP está em desenvolvimento. Esta página oferece uma visão geral dos recursos do MCP, com guias detalhados em breve. Entre em contato com support@verdent.ai para dúvidas específicas sobre integração. --- ## 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. O esquema detalhado de configuração e as instruções de setup do MCP estão sendo finalizados. Para assistência imediata com a configuração de servidores MCP, consulte a especificação do protocolo MCP ou entre em contato com o suporte do Verdent. ### 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. Uma lista selecionada de plugins disponíveis do MCP está sendo compilada. Consulte a documentação oficial do Verdent ou os recursos do ecossistema do MCP para a disponibilidade atual de plugins. **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 Guias completos de desenvolvimento de servidores MCP personalizados, incluindo requisitos de implementação do protocolo, documentação do SDK e ferramentas de teste, estão em desenvolvimento. Para necessidades imediatas de integração personalizada, consulte a especificação do protocolo MCP. ### 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](https://modelcontextprotocol.io) - [Comunidade do Verdent no Discord](https://discord.com/invite/NGjXEZcbJq) 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 Guias completos de integração com o MCP estão em desenvolvimento, incluindo: - Especificação completa do protocolo MCP - Documentação do SDK de desenvolvimento de servidores - Marketplace e registro de plugins - Exemplos de integração e tutoriais - Referência de API para desenvolvimento de servidores personalizados **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 Capacidades das ferramentas integradas Outros métodos de extensão Configurações e preferências do Verdent Técnicas eficazes de prompt