# Integração com MCP (/pt/docs/verdent-for-vscode/advanced-features/mcp)
> Estenda o Verdent com servidores e plugins do Model Context Protocol
### O que você vai aprender [#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](mailto:support@verdent.ai) para dúvidas específicas sobre integração.
***
## O que é o MCP (Model Context Protocol)? [#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 [#benefícios-da-integração-com-mcp]
### Capacidades estendidas [#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 [#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 [#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 [#configurando-servidores-mcp]
### Processo de configuração [#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 [#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-e-extensões-do-mcp]
### Plugins disponíveis [#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 [#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 [#desenvolvimento-de-servidores-mcp-personalizados]
### Criando servidores 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 [#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 [#exemplos-de-fluxos-de-trabalho-do-mcp]
### Integração de consulta a banco de dados [#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 [#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 [#monitoramento-de-pipeline-de-cicd]
**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 [#considerações-de-segurança]
### Autenticação e autorização [#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 [#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 [#solução-de-problemas-da-integração-com-mcp]
### Problemas comuns [#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 [#obtendo-ajuda]
**Canais de suporte:**
* Suporte do Verdent: [support@verdent.ai](mailto: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 [#recursos-de-documentação-do-mcp]
### Documentação oficial [#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 [#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](mailto:support@verdent.ai) informando seu caso de uso específico e os requisitos de integração.
***
## Veja também [#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