Ir para conteúdo
be-human.ai
← Voltar ao blog

Ferramentas e integrações

Model Context Protocol para empresas: o que expor primeiro

Model Context Protocol para empresas: entenda o que é expor uma ferramenta e quais escolher primeiro, com acesso somente leitura.

Capa tipográfica do Be Human com o título: Model Context Protocol para empresas: o que expor primeiro
Ilustração conceitual criada com IA · Be Human

O Model Context Protocol (MCP) é um padrão aberto que permite a um agente de IA descobrir e usar ferramentas oferecidas por um servidor em um formato comum, em vez de criar um conector específico para cada combinação de modelo e sistema. Para uma empresa, expor uma ferramenta significa publicar uma ação estreita e bem descrita, como consultar o status de um pedido ou rascunhar uma resposta, sob regras que você define. As primeiras ferramentas a expor devem ser somente leitura, com escopo restrito e fáceis de conferir, porque um erro ali é barato de identificar e barato de desfazer.

Principais pontos

  • Expor uma ferramenta pelo MCP significa descrever uma ação, suas entradas, suas saídas e suas permissões, para que o agente a chame sem acesso direto ao sistema por trás.
  • Comece com ferramentas de leitura que respondam a partir de um registro oficial, porque uma resposta errada custa muito menos do que uma escrita errada.
  • Mantenha a camada do protocolo separada das regras de aprovação, para que uma mudança de permissão não exija reconstruir o agente.
  • Escolha cada ferramenta verificando a reversibilidade, a sensibilidade dos dados e a rapidez com que uma pessoa perceberia um erro.
  • Defina um critério de sucesso observável para cada ferramenta antes de conectá-la e revise a lista de ferramentas em uma agenda fixa.

O que significa expor uma ferramenta da empresa pelo MCP

Uma configuração MCP tem três papéis: um host (a aplicação onde o agente roda), um cliente que o host usa para conversar com um servidor, e o servidor, que oferece capacidades. O servidor lista suas ferramentas. Cada ferramenta tem um nome, uma descrição simples e um esquema de entrada que define o que o agente pode enviar. Quando o agente entende que uma ferramenta é relevante, ele a chama, e o servidor devolve um resultado.

Portanto, expor uma ferramenta é escrever um contrato, não abrir uma porta. Em vez de dar ao agente um login no seu software contábil, você oferece uma função, como listar as faturas em aberto de um cliente, devolvendo o número da fatura, a data de vencimento e o valor total, com o resultado limitado a um número fixo de linhas. O servidor valida a entrada e devolve apenas os campos que a tarefa precisa. Tudo o que estiver fora desse contrato fica fora de alcance por projeto.

Há um ponto fácil de perder. O protocolo transporta a requisição, mas não decide quem pode fazer o quê. A autorização pertence ao servidor e aos sistemas por trás dele. As orientações da OWASP sobre autorização são claras: o acesso deve ser verificado em cada requisição, e não presumido porque a requisição veio de um cliente conhecido. Uma conexão padronizada facilita a integração, mas não torna segura uma permissão ampla.

Por que um protocolo padrão muda o trabalho, e o que ele não muda

Antes de um padrão compartilhado, cada agente precisava de um conector próprio para cada sistema, e cada conector tinha seu formato, seu fluxo de login e seus modos de falha. Um padrão permite que um mesmo servidor de ferramentas atenda mais de um cliente e que uma equipe troque o modelo ou o host sem reescrever todas as integrações. Esse é o ganho real: menos ligações sob medida para manter.

O que ele não muda é o risco. Cada ferramenta exposta cria um caminho entre linguagem e ação, e cada campo devolvido acrescenta algo que o modelo pode repetir ou usar para agir. O protocolo torna mais fácil criar caminhos, então a disciplina precisa vir de como você escolhe e limita esses caminhos. Equipes que planejam conectar tudo e restringir o acesso depois costumam descobrir que a restrição nunca chega de forma limpa.

Quais ferramentas expor primeiro?

Faça quatro perguntas sobre cada sistema ou ação candidata:

  • Ela apenas lê, ou também escreve, envia, apaga ou altera acessos?
  • Se o agente errar, uma pessoa perceberia antes que um cliente, um fornecedor ou o livro-caixa fosse afetado?
  • O resultado pode ser revertido com rapidez, por meio de um procedimento que a equipe já conhece?
  • Os dados incluem informações pessoais, financeiras ou contratuais que exigem tratamento separado?

Depois, organize os candidatos em quatro grupos. O primeiro grupo são consultas somente leitura a um único registro oficial, como status de pedido, histórico de chamados ou um índice de documentos. O segundo são rascunhos que uma pessoa revisa e envia, como uma resposta a um fornecedor ou um rascunho de pedido de compra. O terceiro são escritas limitadas, estreitas, reversíveis e seguras para repetir, como criar uma tarefa em um projeto específico. O quarto reúne tudo o que movimenta dinheiro, assina documentos, apaga registros, exporta dados em massa ou altera permissões. Deixe esse quarto grupo de fora do primeiro projeto.

Para um tratamento mais completo da diferença entre esses níveis de permissão, veja Ler, preparar e enviar: três permissões diferentes de IA.

Um primeiro conjunto de três ferramentas, passo a passo (cenário ilustrativo)

Cenário ilustrativo: um distribuidor regional de equipamentos, usado aqui apenas como exemplo genérico, quer que seus coordenadores comerciais perguntem a um agente sobre o status dos pedidos e as datas de entrega, sem abrir o sistema de pedidos. A equipe quer que as respostas venham do registro oficial, e não da memória do agente nem de threads antigas de e-mail.

Uma sequência viável fica assim:

  • Escreva a tarefa em uma frase, por exemplo: responder perguntas sobre o status de pedidos de um cliente nomeado, usando somente o sistema de pedidos.
  • Defina um critério de sucesso observável, como acertar um conjunto fixo de perguntas de teste que a equipe escreveu antes de qualquer conexão.
  • Liste os campos exatos que a resposta precisa. Se o agente não precisa da forma de pagamento, a ferramenta não a devolve.
  • Escreva o contrato da ferramenta: um nome claro, uma descrição de quando usá-la, entradas tipadas, um tamanho máximo de resultado e uma mensagem de erro que diga ao agente o que fazer em seguida, como pedir o número do pedido.
  • Crie uma identidade de serviço dedicada, com leitura apenas para aquele tipo de objeto, separada de qualquer conta de funcionário.
  • Teste com perguntas de respostas conhecidas e também com pedidos que o agente deve recusar, como uma troca de endereço de entrega.
  • Conecte a ferramenta em um canal de teste e registre cada chamada, incluindo entradas, saídas e erros.
  • Revise o registro ao fim de um período de avaliação definido antes, corrija qualquer contrato que devolvesse conteúdo demais ou falhasse em silêncio, e só então decida se adiciona a segunda ferramenta.

As permissões por trás dessa sequência podem ser registradas em uma grade simples, como descrito em Matriz de permissões de ferramentas para agentes de IA: modelo prático.

O que deixar fora do primeiro conjunto, e por que o texto não confiável importa

Deixe de fora qualquer ferramenta que possa movimentar dinheiro, assinar documentos, apagar registros, enviar mensagens a clientes sem revisão, exportar grandes volumes de dados ou alterar o acesso de usuários. Esses itens pertencem a etapas posteriores, atrás de passos de aprovação explícitos que nomeiem uma pessoa.

Há um segundo motivo para cautela. O agente lê textos de e-mails, documentos, chamados e páginas da web, e parte desse texto pode conter instruções destinadas a desviá-lo. As orientações da OWASP sobre injeção de prompt tratam isso como um risco central para qualquer sistema que permita a um modelo agir sobre conteúdo externo. Um desenho sólido mantém os privilégios pequenos, trata o conteúdo recuperado como dado e não como comando, e exige confirmação antes de qualquer ação difícil de reverter. Uma ferramenta somente leitura, com um formato de retorno estreito, limita o dano mesmo quando uma instrução manipulada passa.

Como escrever contratos de ferramentas que um agente usa corretamente

Um contrato de ferramenta também é, em parte, documentação para o modelo. O nome e a descrição determinam quando o agente escolhe a ferramenta, então nomes vagos, como buscar dados, levam a chamadas erradas. Use nomes específicos, diga o que a ferramenta não faz e dê a cada parâmetro um formato explícito. Devolva campos compactos e rotulados, em vez de registros brutos, já que cada campo extra é mais texto que o modelo precisa ponderar e pode repetir. As recomendações de engenharia da Anthropic sobre como escrever ferramentas para agentes apontam na mesma direção, com ênfase em descrições e saídas claras.

Os erros importam tanto quanto os resultados. Uma mensagem como não encontrado deixa o agente no escuro, enquanto uma mensagem que diz que o identificador do cliente deve ser o número da conta, e não o nome da empresa, permite que ele se recupere. Para qualquer ferramenta de escrita, exija uma chave de idempotência, para que uma requisição repetida não crie a mesma tarefa ou o mesmo lançamento duas vezes. Para um aprofundamento nesse problema, leia Idempotência em agentes de IA: evite ações duplicadas.

Como a Be Human trabalha isso na operação gerenciada

O primeiro projeto da Be Human define um papel útil, a memória e as ferramentas de que ele precisa, os limites de aprovação e um critério de sucesso observável, para que o primeiro conjunto de ferramentas siga a tarefa, e não o catálogo de integrações disponíveis. A operação gerenciada mantém esse conjunto confiável depois. Ela inclui o monitoramento das chamadas de ferramentas, avaliações recorrentes com as perguntas de teste, revisão de permissões, manutenção quando um sistema de origem muda sua interface e resposta a incidentes quando uma ferramenta devolve algo que não deveria. O objetivo é que cada ferramenta continue estreita, observável e fácil de revogar, com uma pessoa responsável por cada decisão que toque em dinheiro, clientes ou acessos.

Manter a lista de ferramentas segura ao longo do tempo

Uma lista de ferramentas tende a sair do controle. Alguém pede mais um campo, um fornecedor muda um endpoint e uma ferramenta somente leitura ganha, sem alarde, um caminho de escrita. Uma rotina curta previne a maior parte desses problemas.

  • Mantenha um registro escrito de cada ferramenta exposta, com dono, permissões, campos devolvidos e critério de sucesso.
  • Revise as permissões em uma agenda fixa e depois de qualquer mudança no sistema de origem.
  • Leia os registros de chamadas em busca de recusas e erros, e não apenas de sucessos.
  • Rode novamente as perguntas de teste fixas sempre que um contrato, um modelo ou um prompt mudar.
  • Pause ou remova qualquer ferramenta cujo dono não consiga dizer com clareza para que ela serve.

Se você não tem certeza de qual dos seus sistemas guarda a primeira tarefa que vale entregar a um agente, o diagnóstico gratuito de IA da Be Human é um bom ponto de partida.

Perguntas frequentes

O que é o Model Context Protocol em termos simples de negócio? É uma forma padrão de uma aplicação de IA encontrar e usar ferramentas que outro sistema oferece, com um formato compartilhado para nomes, descrições e entradas. Para uma empresa, isso significa que um mesmo servidor de ferramentas pode atender vários agentes sem um conector sob medida a cada vez. O protocolo não decide permissões, então as regras de acesso continuam pertencendo ao servidor e aos sistemas por trás dele.

Qual ferramenta uma empresa deve expor primeiro? Escolha uma consulta somente leitura a um único registro oficial que as pessoas já conferem manualmente, como o status de um pedido ou um índice de documentos. Um erro ali é visível e fácil de corrigir, e o resultado mostra se seus contratos, permissões e registros se comportam como esperado. Os rascunhos vêm depois, e as escritas só depois disso.

É seguro conectar o MCP a e-mail, pagamentos ou registros de clientes? Só é seguro quando cada ferramenta exposta é estreita, usa uma identidade própria e limitada e devolve o mínimo de campos que a tarefa exige. Pagamentos, assinaturas, exclusões e exportações em massa devem ficar fora do primeiro conjunto e, quando chegarem, ficar atrás de aprovação humana explícita. Parta do princípio de que textos em e-mails e documentos podem tentar influenciar o agente, e desenhe o sistema para que uma única chamada manipulada não cause dano sério.

Quanto tempo leva para definir um primeiro conjunto de ferramentas? Não há uma duração fixa, porque isso depende de quantos sistemas estão envolvidos, de quão limpos são os dados e de quão rápido a equipe concorda com o critério de sucesso. O trabalho avança mais depressa quando a tarefa é escrita em uma frase, os campos necessários são listados e existe um conjunto de testes com respostas conhecidas antes de qualquer conexão. A Be Human define esses elementos no primeiro projeto para que as ferramentas sigam o papel do agente.

Seu próximo passo

Descubra primeiro onde um agente de IA cabe na sua empresa.

Faça o diagnóstico gratuito de IA da Be Human. Algumas perguntas sobre o seu trabalho mostram qual tarefa entregar primeiro a um agente, o que ele precisa saber e onde uma pessoa aprova.

Orientação editorial Be Human. Exemplos são ilustrativos, salvo atribuição explícita. Fontes oferecem contexto; a implementação depende do seu processo.

Menos tarefas. Mais espaço para você.

Traga o trabalho para o qual falta tempo.

Agende uma conversa e teste 7 dias grátis um agente de IA personalizado ↗Ou faça o diagnóstico gratuito de IA →