Adicionar um servidor MCP próprio
Com um servidor MCP próprio, você conecta o AI-Public a um sistema de processos, arquivo, fonte de dados ou outro serviço especializado. Primeiro, escolha qual transporte se adapta ao local de uso.
Escolha o transporte correto
| Transporte | Web | Móvel | Desktop | Uso |
|---|---|---|---|---|
| Streamable HTTP | Sim | Sim | Sim | Recomendado para servidores hospedados |
| stdio | Não | Não | Sim | Processos locais e integrações de desktop |
| SSE | Apenas configurações existentes | Apenas configurações existentes | Sim | Transporte legado; para novos servidores, escolha Streamable HTTP |
Requisitos para Streamable HTTP
Use o endpoint público completo, incluindo o caminho MCP, por exemplo:
https://mcp.organizacao.nl/mcp
O endpoint deve usar HTTPS, estar acessível via DNS público sem redirecionamento e responder a um handshake válido de initialize do MCP. Nomes de usuário e senhas não devem estar na URL. Endereços locais, endereços de rede privada e endpoints de metadados da nuvem são bloqueados.
Adicionar um servidor
- Abra Preferências → Ferramentas.
- Escolha Adicionar ferramentas ou Adicionar servidor MCP. Este botão só aparece se você tiver acesso ao MCP.
- Veja os presets disponíveis.
- Escolha Adicionar um servidor MCP você mesmo.
- Preencha o nome, o endpoint completo e o método de autenticação.
- Salve a configuração e aguarde a verificação da conexão.
- Ative o servidor para seu conjunto padrão de ferramentas.
Um administrador pode registrar um servidor para todo o ambiente em Administração → Ferramentas → MCP.
Autenticação e secrets
O AI-Public suporta OAuth de connector e secrets estáticos. Tokens OAuth, refresh tokens, chaves de API e senhas ficam em armazenamento apenas do servidor. Um chat recebe apenas o connectorId registrado, nunca a configuração secreta.
Quando a URL ou a autenticação mudam, a nova configuração é verificada novamente primeiro. Se essa verificação falhar, uma configuração anteriormente aprovada pode permanecer ativa até que o problema seja resolvido.
Permissões de ferramentas e segurança da informação
Libere apenas as ferramentas de que os usuários realmente precisam. Um servidor MCP pode oferecer ações de leitura e gravação. O AI-Public filtra as ferramentas descobertas por meio de uma allowlist do lado do servidor e verifica ambiente, proprietário e função a cada uso. A organização continua responsável por escopos, logging, períodos de retenção e autorização adequados no sistema de origem.
Servidores locais de desktop
Você instala um servidor stdio local no app desktop. Command, argumentos, chaves de ambiente e acesso solicitado são limitados e exibidos antes da aprovação. Secrets são criptografados localmente.
Solução de problemas
- Endpoint inacessível: verifique HTTPS, DNS, firewall e o caminho completo
/mcp. - Reconexão necessária: atualize a permissão OAuth ou o secret armazenado.
- Pertence a outro ambiente: registre novamente o connector no ambiente atual.
- Nenhuma ferramenta visível: verifique a allowlist, o acesso por função e o status ativo.
- Funciona apenas no desktop: provavelmente o servidor usa stdio ou um endereço local.
Recursos de desenvolvimento
Veja também
Ao editar, a configuração registrada do servidor é recuperada. A chave armazenada permanece oculta: deixe o campo da chave em branco para mantê-la. Em caso de URL ou método de autenticação diferente, é necessário reconectar. Um erro em uma ferramenta MCP não significa que todas as ferramentas desse servidor estejam indisponíveis.