---
title: Integração
description: "Navegue, instale e gerencie extensões do Verdent para conectar ferramentas e serviços de terceiros"
---

Tool Integration é o sistema do Verdent para navegar, instalar e gerenciar extensões. Em vez de configurar manualmente scripts complexos de API, você pode instalar um plugin com apenas alguns cliques.

Quando você adiciona um plugin, o Verdent baixa um pacote seguro do marketplace oficial, verifica sua integridade e registra automaticamente todos os componentes—sejam novos comandos de implantação, habilidades de gerenciamento de banco de dados ou ferramentas de automação de fluxo de trabalho.

## Integrações suportadas

Plugins populares atualmente disponíveis no marketplace:

| Ferramenta | Caso de uso típico                                                            |
| ---------- | ----------------------------------------------------------------------------- |
| GitHub   | Visualizar PRs, gerenciar issues, acionar Actions                             |
| Stripe   | Consultar pagamentos, gerenciar assinaturas, analisar receita                 |
| Supabase | Ler/gravar bancos de dados, gerenciar usuários, consultar tabelas             |
| Notion   | Consultar documentos e bancos de dados, criar páginas, gerenciar bases de conhecimento, sincronizar informações do projeto |
| Linear   | Gerenciar issues e projetos, acompanhar o progresso do desenvolvimento, sincronizar o status das tarefas |

## Instalando um plugin

<Steps>
  <Step title="Abra as configurações">
    Inicie o Verdent e vá para **Settings**.
  </Step>
  <Step title="Abra a aba Integrations">
    Você verá os plugins divididos em duas seções:
    - **Installed** — plugins que você já possui
    - **Recommended** — plugins disponíveis no marketplace
  </Step>
  <Step title="Escolha um plugin">
    Clique em qualquer card de plugin na seção **Recommended** para abrir seus detalhes.
  </Step>
  <Step title="Adicione ao Verdent">
    Revise seus recursos e componentes e clique em **Add to Verdent**. O plugin é baixado, verificado e instalado automaticamente.
  </Step>
  <Step title="Conecte o MCP">
    Siga a instrução para conectar o MCP correspondente, para que o plugin possa acessar serviços externos.
  </Step>
</Steps>

## Autenticação

Diferentes plugins usam diferentes métodos de autenticação segura:

- **OAuth** — Plugins como GitHub, Notion e Linear suportam fluxos OAuth contínuos. O Verdent gerencia as credenciais do cliente automaticamente—basta fazer login e autorizar no seu navegador, sem necessidade de copiar e colar.

<Note>
  Quaisquer chaves de API ou tokens de acesso que você fornecer são armazenados localmente na sua máquina. O Verdent nunca envia suas credenciais para nossos servidores.
</Note>

## Usando plugins

Após a instalação, há duas maneiras principais de começar a usar um plugin:

### Fale diretamente com o Manager

Peça ao Manager para usar a integração de forma natural:

- "Use a integração GitHub para resumir meus PRs mais recentes"
- "Verifique os usuários registrados mais recentes na minha tabela de usuários do Supabase"

### Experimente no Chat

Se você não tiver certeza por onde começar, vá para **Settings → Integrations**, clique em um plugin instalado e depois em **Try in Chat**. As configurações serão fechadas e o prompt padrão do plugin será inserido na caixa de entrada do chat.

## Gerenciando plugins instalados

Você sempre tem controle total sobre quais ferramentas o Verdent pode acessar:

- **Ver detalhes** — Clique em qualquer card de plugin instalado para ver seus componentes exatos (MCPs, Skills, Rules, etc.).
- **Desinstalar** — Abra os detalhes do plugin e clique em **Uninstall**. Após a confirmação, o Verdent remove completamente o registro em tempo de execução, exclui os arquivos em cache e limpa o estado.
- **Reinstalar** — Encontre o plugin novamente na seção **Recommended** e reinstale-o a qualquer momento.

<Note>
  A desinstalação remove todos os arquivos e funcionalidades locais. Você ainda pode precisar revogar o acesso OAuth ou excluir chaves de API no painel do serviço de terceiros para uma desconexão completa.
</Note>

## O que há dentro de um plugin

Uma integração pode incluir vários componentes:

- **Servidores MCP** — Ferramentas padronizadas que permitem ao Verdent ler e gravar dados de serviços externos
- **Skills** — Capacidades ou fluxos de trabalho de IA específicos para tarefas (por exemplo, uma habilidade de "code review" do GitHub)
- **Subagentes** — Agentes focados e independentes aos quais o Manager pode delegar tarefas complexas
- **Rules** — Instruções de comportamento personalizadas que definem como o Verdent deve agir ao usar determinadas ferramentas
- **Commands** — Comandos de barra convenientes (por exemplo, `/deploy`) que você pode executar diretamente no chat

## Casos de uso

### Code review e merge (GitHub)

Depois de concluir um recurso, peça:

> Crie um PR para meu commit mais recente e resuma as alterações.

O Verdent usa o plugin GitHub para redigir o PR, adicionar um resumo e verificar o status do CI/CD.

### Gerenciamento de assinaturas (Stripe)

Um cliente envia um e-mail sobre problemas de faturamento:

> Encontre a assinatura Stripe de user@example.com e verifique se o último pagamento foi bem-sucedido.

O Verdent recupera os dados com segurança—sem necessidade de abrir o painel da Stripe.

### Monitoramento (Supabase)

Após conectar o Supabase:

> Busque os registros de clientes de usuários do tipo financeiro na tabela de usuários.

O Verdent recupera e exibe os dados diretamente.

### Acompanhamento de projetos (Linear)

Antes de uma reunião:

> Mostre-me todas as issues não finalizadas neste sprint no Linear, ordenadas por prioridade.

O Verdent agrega o progresso, e você pode marcar bugs corrigidos como Done diretamente.

### Conhecimento e documentos (Notion)

> Encontre a versão mais recente do documento de requisitos do produto no Notion e transforme os principais requisitos em uma lista de tarefas.

O Verdent extrai o conteúdo e gera automaticamente uma lista de tarefas estruturada.

<Note>
  Sempre instale plugins pelo marketplace oficial do Verdent para garantir pacotes seguros e verificados por SHA256.
</Note>