Adicionar um servidor MCP próprio
Com um servidor MCP próprio, você conecta o AI-Corporate a uma aplicação interna, fonte de dados ou 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 novos servidores escolha Streamable HTTP |
Requisitos para Streamable HTTP
Use o endpoint público completo, incluindo o caminho MCP, por exemplo:
https://mcp.example.com/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, redes privadas 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 adequados para a organização.
- Selecione Adicionar um servidor MCP próprio.
- Preencha o 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-Corporate 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 previamente aprovada pode permanecer ativa até que o problema seja resolvido.
Permissões de ferramentas e governança
Liberte apenas as ferramentas que os colaboradores realmente precisam. Um servidor MCP pode oferecer ações de leitura e escrita. O AI-Corporate filtra as ferramentas descobertas contra uma allowlist no servidor e verifica tenant, proprietário e função a cada uso. A organização continua responsável por escopos adequados, logging, períodos de retenção e autorização no sistema de origem.
Servidores desktop locais
Um servidor stdio local é instalado no aplicativo desktop. O renderer não pode iniciar comandos shell arbitrários: comando, argumentos, variáveis 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 allowlist, acesso por função e status ativo.
- Funciona apenas no desktop: provavelmente o servidor usa stdio ou um endereço local.
