Integração com MCP

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:

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)

{
  "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}"
      }
    }
  }
}

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

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 ou o repositório oficial de servidores MCP 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 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

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
• Comunidade Verdent no Discord

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