> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gennia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Tools

> Conecte seu agente a apps externos e APIs para executar ações

Tools dão ao agente a capacidade de ir além de conversar — ele pode executar ações em serviços externos, consultar APIs e interagir com seus sistemas.

## Tipos de tools

### Integrações

Conexões prontas com mais de **150 apps** de negócio. O agente pode descobrir e usar tools automaticamente com base nas conexões ativas.

Exemplos de apps disponíveis:

* **Comunicação** — Slack, Gmail, Google Calendar
* **Produtividade** — Google Sheets, Google Docs, Notion
* **CRM** — Salesforce, HubSpot
* **Redes sociais** — LinkedIn, Instagram, Twitter
* E muitos outros

Para conectar um app:

1. Vá em **Tools** no agente
2. Busque o app desejado
3. Autorize a conexão (geralmente via OAuth)
4. O agente passa a ter acesso às ações daquele app

### APIs customizadas (HTTP)

Defina integrações com qualquer API REST:

* Configure **URL**, **método** (GET, POST, PUT, DELETE) e **headers**
* Defina a estrutura da resposta esperada
* Ideal para sistemas internos ou APIs proprietárias

### MCPs Externos

Qualquer servidor **MCP (Model Context Protocol)** disponível no mercado pode ser conectado ao Gennia através de uma URL remota. Isso permite integrar ferramentas de terceiros, marketplaces e serviços especializados diretamente nos seus agentes.

#### Como conectar um MCP externo

<Steps>
  <Step title="Crie uma nova tool">
    Em **Tools** no agente, clique em **Criar Tool** e selecione a opção **MCP**.
  </Step>

  <Step title="Insira a URL do MCP">
    Cole a URL remota do servidor MCP que deseja conectar. Essa URL é fornecida pelo provedor do MCP.
  </Step>

  <Step title="Escolha o tipo de autenticação">
    Selecione como o Gennia deve se autenticar com o servidor:

    * **API Key** — Chave de acesso simples
    * **Bearer Token** — Token de autenticação
    * **Headers customizados** — Headers HTTP personalizados
    * **OAuth** — Fluxo de autorização OAuth
    * **Sem autenticação** — Para MCPs públicos
  </Step>

  <Step title="Salve e teste">
    Após salvar, as tools disponíveis no MCP ficam automaticamente acessíveis para o agente.
  </Step>
</Steps>

<Tip>
  Existem milhares de MCPs disponíveis no mercado para os mais diversos serviços. Procure por "MCP server" do serviço que deseja integrar — se existe um MCP para ele, você pode conectá-lo ao Gennia.
</Tip>

## Aprovação humana (HITL)

Qualquer tool pode ser marcada como **requer aprovação**. Quando o agente tenta usar essa tool:

1. A execução **pausa**
2. Um humano recebe a solicitação com detalhes da ação
3. O humano **aprova** ou **rejeita**
4. O agente continua com base na decisão

Ideal para ações sensíveis como transferências, exclusões ou envio de mensagens em nome da empresa.