--- title: Integração com MCP description: "Estenda o Verdent com servidores e plugins do Model Context Protocol" --- ## O que é MCP (Model Context Protocol)? O Model Context Protocol (MCP) é um sistema de integração que amplia 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 contínua 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 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 às 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 de Configurações. --- ## 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 adaptados aos requisitos exclusivos do seu projeto. Construa integrações especializadas para ferramentas internas, APIs proprietárias ou sistemas específicos do domínio. ### Interoperabilidade **Aproveitamento do ecossistema:** Aproveite o crescente ecossistema MCP. Servidores MCP desenvolvidos pela comunidade oferecem integrações prontas para ferramentas e serviços populares. **Protocolo padronizado:** O MCP oferece 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 fluxo de trabalho **Integração contínua:** Os servidores MCP tornam-se 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 MCP entendem o contexto da sua base de código, permitindo interações inteligentes com sistemas externos com base no estado atual de desenvolvimento. --- ## Configurando servidores MCP ### Processo de configuração **Acessar configurações de MCP:** 1. Abra o menu de Configurações no Verdent 2. Navegue até a seção **Servidores MCP** 3. Visualize ou modifique a configuração `~/.verdent/mcp.json` **Arquivo de configuração:** Os servidores MCP são configurados através do arquivo `~/.verdent/mcp.json`, que define conexões de servidor, autenticação e parâmetros de integração. Consulte a seção **Configuração MCP** abaixo para o esquema completo. ### Gerenciamento de configuração **Adicionando 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 suporta múltiplos servidores MCP simultâneos, permitindo integração com vários sistemas externos ao mesmo tempo. **Testando 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. ### Status do servidor Monitore o status da conexão no painel de configurações MCP: | Status | Descrição | |--------|-------------| | **Success** | Servidor conectado e ferramentas disponíveis | | **Failed** | Erro de conexão (clique para ver detalhes) | | **Loading** | Servidor inicializando | **Atualizando ferramentas:** Clique no botão de atualização para redescobrir as ferramentas disponíveis de um servidor após alterações de configuração ou problemas de conexão. --- ## Configuração MCP ### Configuração básica **Localização:** `.mcp.json` na raiz do projeto ou `~/.verdent/mcp.json` (global) ```json PostgreSQL Server { "mcpServers": { "postgres": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost:5432/myapp_dev" ] } } } ``` ```json GitHub Server { "mcpServers": { "github": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-github" ], "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}" } } } } ``` ```json Multiple Servers { "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}" } } } } ``` **Chaves de configuração:** - `mcpServers` - Chave de nível superior obrigatória para configuração MCP - `command` - Executável a ser executado (normalmente `npx` para pacotes Node.js) - `args` - Argumentos passados ao comando (nome do pacote, strings de conexão, etc.) - `env` - Variáveis de ambiente para autenticação/configuração **Saiba mais sobre MCP:** - [Especificação do Model Context Protocol](https://modelcontextprotocol.io/specification) - [Registro de servidores MCP](https://mcp.so/servers) - Explore os servidores MCP disponíveis - [Servidores MCP oficiais](https://github.com/modelcontextprotocol) - PostgreSQL, GitHub, Filesystem e mais --- ## Plugins e extensões MCP ### Plugins disponíveis Os plugins MCP oferecem integrações prontas para ferramentas e serviços comuns. Explore o registro da comunidade em [mcp.so/servers](https://mcp.so/servers) ou o [repositório oficial de servidores MCP](https://github.com/modelcontextprotocol) para ver a disponibilidade atual. **Categorias comuns de plugins:** - **Integrações de banco de dados:** ferramentas de consulta 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 do 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 MCP podem depender de serviços ou bibliotecas externas. Os processos de instalação tratam da 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 do domínio. **Abordagem de desenvolvimento:** Servidores MCP personalizados implementam a especificação do protocolo MCP, expondo capacidades de ferramentas que o Verdent pode invocar. Consulte a [especificação do Model Context Protocol](https://modelcontextprotocol.io/specification) para detalhes de implementação e SDKs. **Casos de uso para servidores personalizados:** - **Integração de API interna:** 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 fluxo de trabalho:** acione pipelines personalizados de build, implantação ou testes ### Padrões de integração **Configuração em nível de espaço de trabalho:** Os servidores MCP podem ser configurados em nível de espaço de trabalho para integrações específicas de projeto, permitindo que as equipes compartilhem configurações MCP por meio de 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. --- ## Recursos MCP específicos do Desktop ### Configuração por projeto | Nível de configuração | Localização | Escopo | |---------------------|----------|-------| | **Global** | `~/.verdent/mcp.json` | Todos os projetos | | **Projeto** | `.mcp.json` na raiz do projeto | Projeto único | | **Worktree** | Herda do projeto | Herda a configuração do projeto | ### MCP multi-worktree Os servidores MCP funcionam em vários worktrees: - **Servidores compartilhados:** configuração base MCP do espaço de trabalho compartilhada por todos os worktrees - **Operações isoladas:** cada worktree mantém um estado de sessão MCP separado - **Acesso paralelo:** vários worktrees podem usar os mesmos servidores MCP simultaneamente ### Troca de projetos Ao trocar de projetos: - Os servidores MCP do projeto atual são carregados - Os servidores MCP globais permanecem disponíveis - As conexões MCP do projeto anterior são mantidas em segundo plano --- ## Exemplos de fluxo de trabalho 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 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 MCP trata da autenticação, validação de consultas e formatação de resultados. ### Interação com serviço de nuvem **Cenário:** verificar logs de função AWS Lambda em busca de erros. **Abordagem 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 MCP gerencia a autenticação, chamadas de API e análise de logs. ### Monitoramento de pipeline de CI/CD **Cenário:** verificar o status do build antes de implantar alterações. **Abordagem 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 ``` O servidor de CI/CD 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 tratam da autenticação com serviços externos. As credenciais são armazenadas com segurança na configuração MCP e nunca 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 MCP aparecem no histórico da conversa, 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 está 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 - Verifique se as regras de firewall permitem o tráfego MCP **Problemas de invocação de ferramentas:** - Certifique-se de que o servidor MCP expõe as ferramentas esperadas corretamente - 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 Verdent no Discord](https://discord.com/invite/NGjXEZcbJq) **Informações de diagnóstico:** Ao relatar problemas de MCP, forneça: - Tipo e versão do servidor MCP - Detalhes de configuração (sem credenciais) - Mensagens de erro do histórico de chat - Logs do servidor MCP (se acessíveis) --- ## Perguntas frequentes As operações dos servidores MCP consomem créditos com base no modelo que processa os resultados. O próprio servidor MCP não usa créditos diretamente. Não. Os servidores MCP são configurados em nível de usuário, não por projeto. Todos os servidores configurados ficam disponíveis em todos os seus projetos. As credenciais no mcp.json são armazenadas localmente na sua máquina e nunca enviadas aos servidores Verdent. Use variáveis de ambiente (`${VAR_NAME}`) para valores sensíveis. Os servidores MCP iniciam quando necessário e executam durante a sua sessão. Eles não consomem recursos quando o Verdent está fechado. Os servidores MCP têm as permissões que você configurar. Use acesso somente leitura sempre que possível e restrinja operações destrutivas. Peça ao Verdent para usar uma ferramenta do servidor MCP. Respostas bem-sucedidas indicam que a conexão está funcionando. Consulte a seção de Solução de problemas se ocorrerem problemas.