This page is not yet available in English. Read it in Portuguese

Skip to content
Menu da documentação

Autoatendimento

Ferramentas MCP da sua empresa

Ligue um servidor MCP da sua empresa a um workspace e libere as ferramentas uma a uma, como leitura ou como escrita com aprovação.

#Como funciona

Você informa o endereço de um servidor MCP da sua empresa, a plataforma lista as ferramentas dele e você escolhe, uma a uma, quais os agentes do workspace podem usar. O agente só enxerga o que foi revisado: nada vem direto do servidor para o modelo.

A tela fica em Integrações → Ferramentas externas (MCP) e exige o produto Agents. Quem cadastra é quem administra o workspace: dono ou administrador. Para o agente usar, libere mcp_list, mcp_read e mcp_write na versão dele.

#O servidor

  • Só HTTPS, em endereço público, com até 500 caracteres e sem usuário e senha na URL.
  • O transporte é o HTTP do MCP (Streamable HTTP). Não há conexão com servidor local por stdio.
  • Endereço de rede interna é recusado: faixas privadas, loopback, link-local e metadados de nuvem. A checagem é refeita em cada conexão.
  • Toda requisição vai só para a origem cadastrada, e redirecionamento é tratado como erro.
  • O endereço não muda depois do cadastro: outro endereço é outro servidor.

Token

O token é opcional, com até 4.000 caracteres. Ele é enviado como Authorization: Bearer, fica cifrado na plataforma e é preso ao host do cadastro: só vai para aquele host. Depois de salvo, não aparece de novo; dá para trocar ou remover.

#Revisar e liberar ferramentas

  1. Liste as ferramentas

    Informe o endereço e, se houver, o token, e clique em Listar ferramentas. Nada é gravado nesse passo.

  2. Leia a descrição e os parâmetros de cada uma

    O agente vai ver exatamente essa descrição. A tela mostra até 100 ferramentas por servidor.

  3. Escolha: não liberar, leitura ou escrita

    Toda ferramenta começa em "Não liberar". Escolha pelo menos uma e no máximo 30.

  4. Dê uma chave e um nome ao servidor e salve

    A chave usa letras minúsculas, números e hífen, com até 63 caracteres, e é única no workspace. Ao salvar, a plataforma consulta o servidor de novo e confere que cada ferramenta é a mesma que você viu; se alguma mudou, a resposta é 409 e é preciso listar de novo.

Parâmetros aceitos

Só pode ser liberada a ferramenta cujos parâmetros a plataforma consegue validar antes de chamar: um objeto simples, em que cada parâmetro é texto, número ou sim/não.

No esquema da ferramentaAceito
type do esquemaobject
type de cada parâmetrostring, number ou boolean
Outras chaves de cada parâmetrodescription, title, default, enum, maxLength, minimum, maximum

Objeto dentro de objeto, lista, integer ou qualquer outra chave: a ferramenta aparece na revisão, mas não pode ser liberada. Na chamada, argumento fora do esquema é recusado, e um texto sem tamanho declarado aceita até 2.000 caracteres.

Leitura e escrita

Marcada comoFerramenta do agenteAprovaçãoChamadas por execução
Leituramcp_readNão: roda diretoAté 10
Escritamcp_writeSempre: uma pessoa aprova o texto exatoAté 3

Uma ferramenta marcada como leitura não é chamada como escrita, nem o contrário. Quem decide a marca é você, na revisão: marque como escrita tudo o que altera algo no sistema de destino.

#A definição fica fixada

Ao salvar, a plataforma guarda um hash SHA-256 da descrição e do esquema de parâmetros de cada ferramenta. Antes de cada chamada, ela lista as ferramentas do servidor e compara:

  • Se a descrição ou o esquema mudaram, a chamada não é feita (schema_changed) e a ferramenta fica parada.
  • Se a ferramenta sumiu do servidor, a chamada falha (tool_missing).

Para voltar a usar, remova o servidor e cadastre de novo, revisando a nova definição. Não há edição das ferramentas de um servidor já salvo: o que foi revisado não muda por baixo.

#Na hora da chamada

O quêLimite
Cada requisição ao servidor30 segundos
A chamada inteira60 segundos
Tamanho da resposta2 MB
Texto devolvido ao agente20.000 caracteres
  • Cada chamada abre uma conexão nova e fecha no fim: não há estado entre execuções.
  • Só o conteúdo de texto da resposta volta. Imagem e recurso ficam de fora.
  • O que volta é tratado como dado não confiável, nunca como instrução para o agente.
  • Numa escrita sem confirmação do resultado, o agente não repete a chamada: avisa a pessoa para conferir no sistema de destino.

#O que fica registrado

  • Cadastro do servidor: chave, host, se tem token e as ferramentas liberadas com a marca de cada uma.
  • Ligar, desligar, trocar ou remover o token, e remover o servidor.
  • O token nunca vai para a auditoria nem para o agente; a URL também não chega ao modelo.

#Limites e o que não existe

O quêLimite
Servidores por workspace10
Ferramentas liberadas por servidor30
Listagens para revisão10 por minuto, por pessoa
Alterações de cadastro20 por minuto, por pessoa
  • Não há servidor MCP público da AIUBY: a plataforma é cliente do seu servidor, não o contrário.
  • Não há autenticação por OAuth: só token fixo, ou nenhum.
  • Não há suporte a recursos, prompts nem amostragem do MCP: só ferramentas.
  • Não há escrita sem aprovação, nem aprovação por chave de API.
  • Não há ferramenta com parâmetro aninhado ou em lista.
  • O cadastro é feito pela tela; não há rota por chave de API.