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?

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:

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

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

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:

Campo	Como preencher
Nome da Conexão	Dê um nome para identificar a credencial.
Token / API Key	Cole a chave ou token exigido pelo servidor MCP.

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.

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.