Eu conectei o servidor MCP gerenciado da Oracle a clientes de chat de IA
Assistentes de IA agora fazem mais do que apenas conversar. Eles usam o Model Context Protocol (MCP) para chamar ferramentas externas.
Testei o servidor MCP gerenciado da Oracle no OCI. Meu objetivo era criar uma verificação de integridade (health check) de apenas leitura para um banco de dados Oracle E-Business Suite. Eu queria perguntar a uma IA: "O banco de dados está online?" ou "Quais gerentes estão fora do ar?".
Funcionou. Tenho um assistente de IA extraindo dados de integridade do banco de dados em tempo real. Aqui está o que aprendi durante o processo.
O Setup
- Use um servidor MCP gerenciado no OCI.
- Aponte-o para o banco de dados usando um usuário de apenas leitura.
- Construa ferramentas SQL personalizadas para visões gerais de instâncias e sessões ativas.
- Conecte um cliente de chat de IA via MCP e OAuth.
Lições Principais
1. Rede e Segurança
O serviço MCP é executado na tenancy da Oracle. Ele não consegue alcançar seu banco de dados privado sozinho. Você deve anexar um Private Endpoint à sua VCN. Para manter a segurança, conecte-se a um usuário de banco de dados de apenas leitura. Isso evita qualquer gravação acidental.
2. Atenção à URL
Cada URL de servidor MCP do OCI inclui um segmento de data como /20250830/. Se você usar uma data antiga, receberá um erro HTTP 404. Esse erro parece um problema de autenticação, mas é apenas um caminho incorreto. Copie a URL exata do seu console.
3. O Problema do OAuth
Muitas interfaces de chat baseadas na web falham com este servidor. Elas tentam descobrir as configurações de OAuth por meio do servidor. A Oracle retorna um 404 para solicitações não autenticadas. Isso interrompe o fluxo de login. Além disso, interfaces web headless carecem de um navegador para login interativo.
4. Use Tokens de Usuário, não Tokens de Aplicativo
Tentei usar um token de client-credentials para pular o navegador. Ele autenticou, mas eu não tinha permissões. As funções (roles) da Oracle são atribuídas a usuários, não a aplicativos. Você deve usar um token de authorization_code (usuário). O usuário detém a função, portanto o token funciona.
5. Use Clientes de Desktop
Clientes de desktop como Claude Desktop ou VS Code funcionam bem porque possuem navegadores integrados para login. Use o mcp-remote com metadados OAuth estáticos para contornar o problema de descoberta do 404.
Dicas Rápidas
- No Windows, use
npx.cmdem vez denpx. - Não execute dois clientes na mesma porta de callback do OAuth.
- Evite o uso de dois-pontos na formatação de datas SQL, como no
TO_CHAR. O sistema pode confundi-los com variáveis de ligação (bind variables). Use datas brutas em vez disso. - Use as views
gv$em vez dev$para ver todas as instâncias RAC.
O MCP gerenciado com agentes de IA é útil para tarefas de banco de dados governadas. Ajuste seu cliente à sua implantação e sempre use usuários de apenas leitura.
Comunidade de aprendizado opcional: https://t.me/GyaanSetuAi