> ## Documentation Index
> Fetch the complete documentation index at: https://help.wizebot.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Como conectar um servidor MCP aos agentes de IA

> Cadastre um servidor MCP em Configurações > MCP, aprove as ferramentas dele e ligue o conector nos agentes de IA que vão usá-lo

![Tela MCP com o conector Catálogo da Loja Exemplo ativo e 3 ferramentas](https://mintcdn.com/wizebot-d8529edc/avKgCLahmW1whcNE/images/conectores-mcp/capa.png?fit=max\&auto=format\&n=avKgCLahmW1whcNE\&q=85\&s=3fd28f31eff109cbe08714d1f75cb2bb)

MCP (Model Context Protocol) é um padrão aberto para um sistema oferecer "ferramentas" a assistentes de IA, como consultar um catálogo ou o estoque. Na WizeBot, a tela **Configurações** > **MCP** conecta servidores MCP de fora aos seus [agentes de IA](https://help.wizebot.com.br/tutoriais/ia/agentes.md): você cadastra o servidor, escolhe quais ferramentas dele estão liberadas e liga o conector nos agentes que devem usá-las. Por exemplo, com o servidor do catálogo da loja, o agente consegue dizer ao cliente se um tamanho está em estoque.

Antes de começar:

* tenha o endereço do servidor MCP e, se ele pedir, a chave de acesso. Quem fornece os dois é o responsável pelo servidor;
* o servidor precisa estar na internet, com endereço `https://`;
* só o dono da empresa cadastra e altera conectores. Os outros usuários veem a tela em **Somente leitura**;
* o recurso precisa estar habilitado na sua empresa. Se a tela mostrar **Conectores MCP não estão habilitados**, fale com o suporte.

**1. Abra a tela MCP**

Acesse **Configurações** e, na seção **Automação** do menu, clique em **MCP**. Clique em **Novo conector**.

![Tela MCP sem conectores, com o botão Novo conector destacado](https://mintcdn.com/wizebot-d8529edc/avKgCLahmW1whcNE/images/conectores-mcp/01-novo-conector.png?fit=max\&auto=format\&n=avKgCLahmW1whcNE\&q=85\&s=736a438723df170f2a5f4f4e523324ba)

**2. Preencha os dados do servidor**

Na janela **Novo conector**:

1. **Nome**: um nome que você reconheça, como "Catálogo da Loja Exemplo". Não pode repetir o nome de outro conector. A **Descrição** é opcional.
2. **URL do servidor MCP**: o endereço que o responsável pelo servidor passou, por exemplo `https://mcp.lojaexemplo.com.br/mcp`.
3. **Autenticação**: escolha **Nenhuma** se o servidor é aberto, **Bearer** se ele pede um token, ou **Cabeçalho personalizado** se ele pede a chave num cabeçalho com nome próprio. Nesse último caso, preencha também **Nome do cabeçalho**, como `X-Api-Key`.
4. **Chave de acesso**: cole a chave do servidor. Ela aparece escondida com pontos.

**Tempo limite (segundos)** é quanto o agente espera a resposta do servidor. O padrão é 15 e o máximo é 45.

![Janela Novo conector com Nome, URL do servidor MCP, Autenticação Bearer e Chave de acesso numerados](https://mintcdn.com/wizebot-d8529edc/avKgCLahmW1whcNE/images/conectores-mcp/02-dados.png?fit=max\&auto=format\&n=avKgCLahmW1whcNE\&q=85\&s=075e52399e74482629ed9aa82368ac4c)

**3. Teste a conexão e salve**

Clique em **Testar conexão** (1). Quando dá certo, aparece **Teste realizado com sucesso** (2) com a quantidade de ferramentas que o servidor oferece. Se aparecer **Erro no teste**, confira a URL e a chave. Depois clique em **Salvar** (3).

![Janela Novo conector com o resultado Teste realizado com sucesso e os botões Testar conexão e Salvar numerados](https://mintcdn.com/wizebot-d8529edc/avKgCLahmW1whcNE/images/conectores-mcp/03-testar.png?fit=max\&auto=format\&n=avKgCLahmW1whcNE\&q=85\&s=299979ebba566b566133a04e651cf0a7)

**4. Abra o conector salvo**

O conector entra na lista com o **Servidor**, o número de **Ferramentas** aprovadas e o **Estado**. Recém-criado, ele ainda tem 0 ferramentas: nenhuma fica liberada sozinha. Clique no nome do conector para abri-lo.

![Lista da tela MCP com o conector Catálogo da Loja Exemplo destacado](https://mintcdn.com/wizebot-d8529edc/avKgCLahmW1whcNE/images/conectores-mcp/04-abrir-conector.png?fit=max\&auto=format\&n=avKgCLahmW1whcNE\&q=85\&s=83b676a7e51c03b5112f9a4f939f7ada)

**5. Aprove as ferramentas**

Na janela **Editar conector**, a seção **Ferramentas** fica no fim:

1. Clique em **Descobrir ferramentas** para buscar a lista atual do servidor.
2. Marque as ferramentas que os agentes podem usar, ou clique em **Selecionar todos**. A contagem embaixo mostra quantas estão aprovadas.
3. Clique em **Salvar**.

Só as ferramentas marcadas chegam aos agentes. Para tirar uma ferramenta, desmarque e salve.

![Janela Editar conector com o botão Descobrir ferramentas, três ferramentas marcadas, a contagem 3 de 3 aprovadas e o botão Salvar numerados](https://mintcdn.com/wizebot-d8529edc/avKgCLahmW1whcNE/images/conectores-mcp/05-ferramentas.png?fit=max\&auto=format\&n=avKgCLahmW1whcNE\&q=85\&s=0cfedf25430643ac3d4015397a1e1184)

> [!NOTE]
>
> Depois de salvos, a URL e a chave não aparecem mais por inteiro: a tela mostra só o endereço principal com **URL definida** e **Chave definida**. Para trocar um deles, clique em **Substituir**.

**6. Ligue o conector no agente**

Vá em **Agents**, abra o agente e clique na etapa **Conectores** (1). Ligue a chave ao lado do conector (2). A mudança vale na hora, sem precisar clicar em salvar. Abaixo do nome aparecem as ferramentas aprovadas que o agente passa a usar.

![Etapa Conectores do agente com o conector Catálogo da Loja Exemplo, suas três ferramentas e a chave de ativação numerada](https://mintcdn.com/wizebot-d8529edc/avKgCLahmW1whcNE/images/conectores-mcp/06-agente.png?fit=max\&auto=format\&n=avKgCLahmW1whcNE\&q=85\&s=2cc99d4bec1f1bb2824f394c95d25c5d)

Cada agente tem a própria escolha: ligar o conector num agente não liga nos outros.

## Estados do conector

| Estado | O que significa |
| - | - |
| **Ativo** | O conector está funcionando. |
| **Ferramentas alteradas** | O servidor mudou alguma ferramenta aprovada. O agente segue usando a versão aprovada. Abra o conector, confira as ferramentas com o selo **Alterada, reaprovar** e salve de novo. |
| **Pausado** | O conector teve muitas falhas seguidas ou a autenticação foi recusada, e os agentes deixam de usá-lo. Resolva a causa (servidor fora do ar, chave vencida) e clique em **Reativar conector** dentro dele. |

Para apagar um conector, clique no ícone de lixeira na coluna **Ações**. A confirmação mostra quantos agentes usam o conector, e eles perdem as ferramentas dele.

## Precisa de ajuda?

Fale com o suporte da WizeBot pelo WhatsApp ou por e-mail.

> [card] [WhatsApp](https://wa.me/559192226534)
>
> Falar com o suporte

> [card] [E-mail](mailto:suporte@wizebot.com.br)
>
> Enviar um e-mail


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.