Adicionar um servidor MCP próprio
Com um servidor MCP próprio, você conecta o AI-Public a um sistema de casos, arquivo, fonte de dados ou outro serviço especializado. Primeiro, escolha o transporte adequado ao local de uso.
Escolha o transporte correto
| Transporte | Web | Mobile | Desktop | Uso |
|---|---|---|---|---|
| Streamable HTTP | Sim | Sim | Sim | Recomendado para servidores hospedados |
| stdio | Não | Não | Sim | Processos locais e integrações desktop |
| SSE | Apenas configurações existentes | Apenas configurações existentes | Sim | Transporte obsoleto; para servidores novos escolha Streamable HTTP |
Requisitos para Streamable HTTP
Use o endpoint público completo, incluindo o caminho MCP, por exemplo:
https://mcp.organisatie.nl/mcp
O endpoint deve usar HTTPS, ser acessível via DNS público sem redirecionamento e responder a um handshake MCP initialize válido. Nomes de usuário e senhas não devem estar na URL. Endereços locais, endereços de rede privada e endpoints de metadados de nuvem são bloqueados.
Adicionar um servidor
- Abra Preferências → Ferramentas.
- Escolha Adicionar ferramentas ou Adicionar servidor MCP.
- Veja os presets disponíveis.
- Escolha Adicionar um servidor MCP próprio.
- Preencha nome, endpoint completo e 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 via Administração → Ferramentas → MCP.
Autenticação e segredos
O AI-Public suporta OAuth de conector e segredos estáticos. Tokens OAuth, tokens de atualização, chaves API e senhas são armazenados apenas no servidor. Um chat recebe apenas o connectorId registrado, nunca a configuração secreta.
Se a URL ou autenticação mudar, a nova configuração é verificada novamente. Se a verificação falhar, uma configuração aprovada anteriormente pode permanecer ativa até que o problema seja resolvido.
Permissões de ferramentas e segurança da informação
Liberte apenas as ferramentas que os usuários realmente precisam. Um servidor MCP pode oferecer ações de leitura e escrita. O AI-Public filtra as ferramentas descobertas contra uma lista de permissões no servidor e verifica ambiente, proprietário e função a cada uso. A organização continua responsável por escopos adequados, registro, prazos de retenção e autorização no sistema de origem.
Servidores desktop locais
Um servidor stdio local é instalado no aplicativo desktop. Comando, argumentos, chaves de ambiente e acessos solicitados são limitados e exibidos antes da aprovação. Segredos são criptografados localmente.
Solução de problemas
- Endpoint inacessível: verifique HTTPS, DNS, firewall e o caminho completo
/mcp. - Reconexão necessária: renove a permissão OAuth ou o segredo armazenado.
- Pertence a outro ambiente: registre o conector novamente no ambiente atual.
- Nenhuma ferramenta visível: verifique a lista de permissões, acesso por função e status ativo.
- Funciona apenas no desktop: provavelmente o servidor usa stdio ou um endereço local.
