Adicionar um servidor MCP próprio
Com um servidor MCP próprio, você conecta o AI-School a uma aplicação própria, fonte de dados ou serviço especializado. Primeiro, escolha o transporte que se adequa 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 novos servidores escolha Streamable HTTP |
Requisitos para Streamable HTTP
Use o endpoint público completo, incluindo o caminho MCP, por exemplo:
https://mcp.example.nl/mcp
O endpoint deve:
- Usar HTTPS;
- funcionar sem nome de usuário ou senha na URL;
- não exigir redirecionamento;
- ser acessível via DNS público;
- responder a um handshake MCP
initializeválido; - ter um conjunto explícito de ferramentas permitidas.
Endereços locais, endereços de rede privada e endpoints de metadados de nuvem são bloqueados. Portanto, não é possível registrar um servidor em localhost a partir do aplicativo web.
Adicionar um servidor
- Abra Preferências → Ferramentas.
- Escolha Adicionar ferramentas ou Adicionar servidor MCP.
- Veja primeiro 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 → Configurações de IA → Ferramentas → MCP.
Autenticação e segredos
O AI-School suporta OAuth de conector e segredos estáticos. Tokens OAuth, tokens de atualização, chaves de API e senhas ficam 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é o problema ser resolvido.
Permissões das ferramentas
Liberte apenas as ferramentas que os usuários realmente precisam. Um servidor MCP pode oferecer ações de leitura e escrita, como excluir arquivos, enviar e-mails ou modificar registros. O AI-School filtra as ferramentas descobertas contra a allowlist do lado servidor, mas o administrador do servidor continua responsável por escopos e autorizações adequadas.
Teste local
Um servidor stdio local você testa no app desktop. O renderer não pode iniciar comandos shell arbitrários: a instalação ocorre via preset aprovado ou fluxo desktop seguro. Comando, argumentos, variáveis de ambiente e acessos solicitados são mostrados antes da instalação.
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 salvo.
- Pertence a outro ambiente: registre o conector novamente no ambiente atual.
- Nenhuma ferramenta visível: verifique a allowlist de ferramentas, seu acesso MCP e se o servidor está ativo.
- Funciona apenas no desktop: provavelmente o servidor usa stdio ou um endereço local.
