Pular para o conteúdo principal

Clientes MCP

O Model Context Protocol (MCP) é um padrão aberto para expor ferramentas a modelos de IA. Muitos serviços oferecem um servidor MCP, e você pode criar o seu. Um cliente MCP de IA conecta o MonoChat a um servidor MCP, para que as ferramentas oferecidas por esse servidor possam ser dadas aos seus nós de IA e agentes de IA, junto com as funções de Ferramenta de IA que você escreve no MonoChat.

Você os gerencia em Configurações › Automação › Clientes MCP de IA.

Como funciona​

  1. Você adiciona o endereço do servidor MCP e se conecta. O MonoChat lê o que o servidor oferece: suas Ferramentas, Recursos, Modelos de recurso e Prompts.
  2. Ao salvar, o MonoChat guarda essa lista como o conteúdo do cliente.
  3. Em um nó Criar conclusão de chat com IA ou em um nó Agente de IA, você escolhe as ferramentas que quer para esse nó e pode reescrever a descrição de cada ferramenta para o modelo.
  4. Durante a conversa, o modelo decide quando chamar uma ferramenta; o MonoChat chama o servidor MCP e devolve o resultado ao modelo.

Somente as ferramentas que você adiciona a um nó ficam disponíveis para ele, de modo que cada nó vê apenas o de que precisa.

Adicionar um cliente MCP​

  1. Acesse Configurações › Automação › Clientes MCP de IA e clique em + (Criar).

  2. Preencha os campos:

    CampoDescrição
    NomeUm nome para o servidor, exibido ao lado de cada uma de suas ferramentas nos painéis dos nós.
    DescriçãoObservações opcionais.
    VersãoA versão do cliente que o MonoChat informa ao servidor ao se conectar, por exemplo 1.0.0.
    EndpointA URL base do servidor MCP. O MonoChat se conecta com o transporte SSE em <Endpoint>/sse, portanto informe o endereço sem /sse.
    Tipo de autenticaçãoNenhum, Basic (com Nome de usuário e Senha) ou Bearer (com Token). As credenciais são salvas com o cliente.

  3. Clique em Conectar. O MonoChat se conecta ao servidor e mostra o que encontrou em abas:

    • Informações do servidor: o Nome, a Versão, a Versão do protocolo e as Instruções do servidor.
    • Ferramentas: o nome e a descrição de cada ferramenta.
    • Recursos, Modelos de recurso e Prompts, se o servidor oferecer algum.

  4. Se a lista estiver correta, clique em Salvar. Para mudar o endereço e tentar de novo, clique no botão Desconectar ao lado dele.

dica

Se Conectar falhar, verifique se o endpoint está acessível pela internet, se o servidor oferece suporte ao transporte SSE e se a URL ainda não termina em /sse.

Atualizar a lista de ferramentas​

Quando o servidor MCP adiciona ou altera ferramentas, abra o cliente com Atualizar. O MonoChat se conecta novamente e mostra o conteúdo atual; clique em Atualizar para salvar a nova lista.

Excluir um cliente também remove o conteúdo dele, e os nós perdem as ferramentas que vieram dele.

Dar ferramentas a um nó​

Nó Criar conclusão de chat com IA​

  1. Abra o nó e role até Configurações das ferramentas de conteúdo do cliente MCP de IA.
  2. Clique em Definir ferramentas de conteúdo do cliente MCP de IA. O painel Ferramentas de conteúdo do cliente MCP de IA lista as ferramentas já adicionadas a este nó.
  3. Clique em + (Criar) e escolha uma ferramenta em Ferramentas de conteúdo do cliente MCP de IA. As ferramentas são listadas como <nome do cliente> - <nome da ferramenta>.
  4. A Descrição é preenchida com a descrição da própria ferramenta. Edite-a se quiser dizer ao modelo com mais precisão quando usar a ferramenta, por exemplo "Use isto para consultar um pedido pelo número". A descrição é obrigatória.
  5. Repita para cada ferramenta e depois salve o nó.

Você pode atualizar a descrição de uma ferramenta ou removê-la do nó no mesmo painel.

Nó Agente de IA​

O nó Agente de IA tem o mesmo botão Definir ferramentas de conteúdo do cliente MCP de IA na seção Configurações das ferramentas. As ferramentas MCP selecionadas são oferecidas ao agente junto com os escopos de IA e as ferramentas de IA do nó, em todos os harnesses. Veja Agentes de IA.

informação

Uma execução de agente verifica se todas as ferramentas MCP do nó ainda existem no seu workspace. Se você excluir um cliente MCP usado por um nó, as execuções desse nó falham com "Um escopo de IA ou ferramenta MCP não foi encontrado neste workspace." até que você remova a ferramenta do nó.

Permissões​

O acesso é controlado pelas permissões de perfil Ler / Criar / Atualizar / Excluir clientes MCP de IA na automação e Ler conteúdos de clientes MCP de IA na automação. Veja Perfis de acesso.