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
Liste as ferramentas
Informe o endereço e, se houver, o token, e clique em Listar ferramentas. Nada é gravado nesse passo.
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.
Escolha: não liberar, leitura ou escrita
Toda ferramenta começa em "Não liberar". Escolha pelo menos uma e no máximo 30.
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 é
409e é 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 ferramenta | Aceito |
|---|---|
type do esquema | object |
type de cada parâmetro | string, number ou boolean |
| Outras chaves de cada parâmetro | description, 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 como | Ferramenta do agente | Aprovação | Chamadas por execução |
|---|---|---|---|
| Leitura | mcp_read | Não: roda direto | Até 10 |
| Escrita | mcp_write | Sempre: uma pessoa aprova o texto exato | Até 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 servidor | 30 segundos |
| A chamada inteira | 60 segundos |
| Tamanho da resposta | 2 MB |
| Texto devolvido ao agente | 20.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 workspace | 10 |
| Ferramentas liberadas por servidor | 30 |
| Listagens para revisão | 10 por minuto, por pessoa |
| Alterações de cadastro | 20 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.