Ferramentas e MCP

Ferramentas permitem que um agente leia informações ou realize ações. MCP (Model Context Protocol) permite ao Maestrly conectar servidores de ferramentas e recursos executados local ou remotamente.

Adicionar um servidor MCP

Abra as configurações de ferramentas ou MCP e adicione o tipo de conexão informado pelo servidor:

para um servidor local, configure executável, argumentos e valores de ambiente necessários;
para um servidor remoto, configure a URL e conclua o fluxo de autenticação compatível.

Inicie a conexão e inspecione as ferramentas e recursos expostos. Se a inicialização falhar, rode a verificação de saúde documentada pelo servidor e confira comando, URL, credenciais e acesso à rede.

Revisar o acesso antes de habilitar

Para cada ferramenta, pergunte:

Quais dados ela pode ler?
O que ela pode criar, alterar, enviar ou excluir?
Ela chama um serviço remoto?
Qual conta e quais permissões ela usa?
Ações importantes podem exigir sua aprovação?

Habilite o menor conjunto necessário. Uma tarefa somente de leitura raramente precisa de acesso de escrita ou administração.

Usar ferramentas num chat

Associe o servidor ou as ferramentas permitidas ao agente ou chat. Declare na solicitação qualquer limite importante — por exemplo, repositório, banco de dados, workspace ou intervalo de datas. Acompanhe as primeiras chamadas e confirme argumentos e destinos antes de permitir uma execução mais ampla.

O modelo de IA selecionado precisa aceitar o comportamento de chamada de ferramentas. O servidor também pode estar indisponível, limitado por taxa ou restrito pelo plano da conta própria.

Entender o caminho dos dados

Servidores locais rodam na sua máquina, mas ainda podem contatar serviços externos.
Servidores remotos recebem os dados necessários para executar suas ferramentas.
O provedor de IA escolhido recebe prompt, descrições das ferramentas, contexto relevante e resultados necessários para a inferência.
O Maestrly não tem backend hospedado nem proxy de inferência/MCP. Integrações habilitadas conectam-se aos destinos selecionados.

Revise os termos de privacidade de cada provedor e servidor antes de enviar dados sensíveis.

Resolver falhas com segurança

Servidor não inicia: confirme que o executável existe, os argumentos são válidos e os valores de ambiente necessários estão presentes.
Falha de autenticação: reconecte usando a conta do próprio servidor e reduza permissões quando possível.
Ferramenta ausente: atualize a conexão e confira a versão do servidor e o suporte do modelo.
Chamada expira: confira rede, saúde do servidor e limites do provedor antes de tentar novamente.
Ação inesperada: pare a execução, revogue ou desabilite a ferramenta, inspecione os logs e troque credenciais expostas se necessário.

A seguir: Agentes e skills ou Projetos e Git.