> For the complete documentation index, see [llms.txt](https://docs.poweromni.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.poweromni.ai/administracao-e-configuracao/artefatos/conectores/mcp.md).

# MCP

O conector MCP permite conectar um agente do Power Omni a um servidor compatível com Model Context Protocol.

Na prática, ele funciona como uma ponte entre o agente e ferramentas externas. Essas ferramentas podem estar em um servidor próprio, em uma API preparada para MCP ou em um serviço mantido por outro fornecedor.

### Quando usar o conector MCP?

<figure><img src="/files/Bifsmfv06EHygkDFfvo8" alt=""><figcaption></figcaption></figure>

Use o conector MCP quando você já possui um servidor MCP disponível e quer permitir que o agente execute as ferramentas publicadas por esse servidor.

Alguns exemplos de uso:

* consultar dados em um sistema externo;
* executar ações em uma API própria;
* integrar o agente a ferramentas internas da empresa;

Esse conector é indicado para cenários mais técnicos, onde existe um servidor MCP pronto de algum sistema ou ferramenta que a empresa usa ou uma equipe responsável por criar e manter esse servidor.

### Como funciona no Power Omni

Ao criar o conector, você informa a URL do servidor MCP, define um nome para o servidor, escolhe o tipo de autenticação e, se necessário, limita quais ferramentas o agente poderá usar.

No momento, o Power Omni permite conectar servidores MCP de duas formas:

<figure><img src="/files/QNWuL2aFiVttDuY6YwQW" alt=""><figcaption></figcaption></figure>

1. Sem autenticação, para servidores públicos.
2. Com API Key, para servidores que exigem uma chave de acesso.

A Microsoft também recomenda armazenar credenciais em conexões do projeto, em vez de deixar chaves fixas diretamente no código da aplicação.

### Criando um conector MCP

Para criar um conector MCP, acesse:

Configurações → Artefatos → Conectores → Criar Conector

Depois, selecione o tipo Servidor MCP.

Preencha os campos conforme o servidor que deseja conectar.

### Campos do conector

<table><thead><tr><th width="216">Campo</th><th>Como preencher</th></tr></thead><tbody><tr><td>Tipo de Conector</td><td>Selecione Servidor MCP.</td></tr><tr><td>Projeto</td><td>Escolha o projeto onde o conector será criado.</td></tr><tr><td>Nome</td><td>Dê um nome simples para identificar o conector no Power Omni.</td></tr><tr><td>Descrição</td><td>Explique quando e como o agente deve usar esse conector.</td></tr><tr><td>Label do Servidor</td><td>Informe um identificador único para esse servidor MCP. Exemplo: meu_servidor_mcp.</td></tr><tr><td>URL do Servidor</td><td>Informe a URL do endpoint MCP. Exemplo: https://exemplo.com/api/mcp.</td></tr><tr><td>Autenticação</td><td>Escolha Nenhuma ou API Key, conforme o servidor.</td></tr><tr><td>Tools Permitidas</td><td>Informe quais ferramentas desse servidor o agente poderá usar. Deixe vazio para permitir todas.</td></tr><tr><td>Política de Aprovação</td><td>Defina se as chamadas serão automáticas ou se exigirão aprovação.</td></tr></tbody></table>

### Label do Servidor

O Label do Servidor é o identificador usado para reconhecer aquele servidor MCP.

Use um nome curto, sem espaços e fácil de entender.

Exemplos:

```
github_mcp financeiro_mcp crm_mcp meu_servidor_mcp
```

O ideal é que o nome indique qual sistema ou finalidade aquele MCP representa.

### URL do Servidor

A URL do Servidor deve apontar para o endpoint MCP remoto.

Exemplo:

```
https://exemplo.com/api/mcp
```

O servidor precisa estar acessível. Se a URL estiver protegida por rede privada, firewall, bloqueio de IP ou autenticação não suportada, o conector pode não funcionar corretamente.

### Autenticação

O Power Omni suporta, no momento, dois tipos de autenticação para o conector MCP.

#### Nenhuma

Use essa opção quando o servidor MCP for público e não exigir chave, token ou credencial.

Esse modo é útil para testes, servidores internos sem autenticação ou serviços que já possuem outra camada de proteção antes do endpoint.

#### API Key

Use essa opção quando o servidor MCP exigir uma chave de acesso.

Ao selecionar API Key, o Power Omni exibirá a área de Configuração de Conexão.

Você pode importar uma conexão existente ou criar uma nova conexão.

Para criar uma nova conexão, preencha:

<table><thead><tr><th width="225">Campo</th><th>Como preencher</th></tr></thead><tbody><tr><td>Nome da Conexão</td><td>Dê um nome para identificar a credencial.</td></tr><tr><td>Token / API Key</td><td>Cole a chave ou token exigido pelo servidor MCP.</td></tr></tbody></table>

### Tools Permitidas

O campo Tools Permitidas permite limitar quais ferramentas do servidor MCP o agente poderá usar.

Se o servidor MCP expõe várias ferramentas, você pode liberar apenas as necessárias para aquele agente.

Exemplo:

```
consultar_cliente listar_pedidos abrir_chamado
```

Essa configuração ajuda a reduzir riscos e evita que o agente use ferramentas que não fazem parte do objetivo dele.

### Política de Aprovação

A Política de Aprovação define se o agente poderá executar as ferramentas automaticamente ou se será necessário algum tipo de aprovação antes da chamada.

No Power Omni, a opção Nunca (execução automática) permite que o agente execute a ferramenta sem pedir aprovação manual a cada uso.

Use execução automática apenas quando a ferramenta for segura para o fluxo do agente.

Recomendamos exigir aprovação em operações de maior risco, principalmente quando a ferramenta escreve dados ou altera recursos.&#x20;

### Testando o conector

Depois de salvar o conector, associe ele a um agente e faça testes simples.

Você pode perguntar ao agente:

```
Quais ferramentas estão disponíveis?
```

Depois, teste uma ferramenta específica do servidor MCP.

Exemplo:

```
Consulte os dados do cliente João usando a ferramenta disponível.
```

Se o agente não conseguir usar a ferramenta, revise:

* se a URL do servidor está correta;
* se o servidor está online;
* se a API Key está correta;
* se a ferramenta está na lista de Tools Permitidas;
* se o agente está vinculado ao conector;
* se a descrição do conector deixa claro quando ele deve ser usado.

### Preciso de ajuda?

Se tiver qualquer dúvida para configurar um servidor MCP, validar autenticação, preencher os campos ou entender quais ferramentas liberar para o agente, procure o suporte do Power Omni.