Adicionar um servidor MCP próprio
Com um servidor MCP próprio, você conecta o AI-Corporate a um aplicativo interno, fonte de dados ou serviço especializado. Primeiro, escolha qual transporte se adequa ao local de uso.
Escolha o transporte certo
| 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.example.com/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 fazer parte da 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 ferramenta ou Adicionar servidor MCP. Este botão só aparece se você tiver acesso ao MCP.
- Veja os presets disponíveis adequados à organização.
- Escolha Adicionar você mesmo um servidor MCP.
- 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 de ferramentas padrão.
Um administrador pode registrar um servidor para todo o ambiente em Administração → Ferramentas → MCP.
Autenticação e secrets
O AI-Corporate suporta OAuth do conector 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 uma URL ou autenticação é alterada, a nova configuração é verificada novamente primeiro. Se essa verificação falhar, uma configuração previamente aprovada pode permanecer ativa até que o problema seja resolvido.
Permissões de ferramentas e governança
Disponibilize apenas as ferramentas que os colaboradores realmente precisam. Um servidor MCP pode oferecer ações de leitura e de escrita. O AI-Corporate filtra as ferramentas descobertas por uma allowlist no servidor e verifica tenant, proprietário e função em 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 locais de desktop
Você instala um servidor local stdio no aplicativo desktop. O renderer não pode iniciar comandos de shell arbitrários: command, argumentos, environmentkeys e acesso solicitado são limitados e mostrados 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: renove a permissão OAuth ou o secret salvo.
- Pertence a outro ambiente: registre o conector novamente dentro do 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 vazio para mantê-la. Com uma 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 inacessíveis.