ਮੈਂ Oracle ਦੇ Managed MCP Server ਨੂੰ AI Chat Clients ਨਾਲ ਜੋੜਿਆ
AI assistants ਹੁਣ ਸਿਰਫ਼ ਗੱਲਾਂ ਕਰਨ ਤੋਂ ਕਿਤੇ ਵੱਧ ਕਰ ਸਕਦੇ ਹਨ। ਉਹ ਬਾਹਰੀ ਟੂਲਸ (external tools) ਨੂੰ ਕਾਲ ਕਰਨ ਲਈ Model Context Protocol (MCP) ਦੀ ਵਰਤੋਂ ਕਰਦੇ ਹਨ।
ਮੈਂ OCI ਵਿੱਚ Oracle ਦੇ managed MCP server ਦਾ ਟੈਸਟ ਕੀਤਾ। ਮੇਰਾ ਉਦੇਸ਼ Oracle E-Business Suite database ਲਈ ਇੱਕ read-only health check ਬਣਾਉਣਾ ਸੀ। ਮੈਂ AI ਨੂੰ ਪੁੱਛਣਾ ਚਾਹੁੰਦਾ ਸੀ: "ਕੀ database ਚਾਲੂ ਹੈ?" ਜਾਂ "ਕਿਹੜੇ managers ਬੰਦ ਹਨ?"
ਇਹ ਕੰਮ ਕਰ ਗਿਆ। ਮੇਰੇ ਕੋਲ ਇੱਕ AI assistant ਹੈ ਜੋ live database health data ਕੱਢ ਰਿਹਾ ਹੈ। ਇਸ ਪ੍ਰਕਿਰਿਆ ਦੌਰਾਨ ਮੈਂ ਜੋ ਸਿੱਖਿਆ, ਉਹ ਇੱਥੇ ਹੈ।
The Setup
- OCI ਵਿੱਚ managed MCP server ਦੀ ਵਰਤੋਂ ਕਰੋ।
- ਇੱਕ read-only user ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਇਸਨੂੰ database ਨਾਲ ਜੋੜੋ।
- instance overviews ਅਤੇ active sessions ਲਈ custom SQL tools ਬਣਾਓ।
- MCP ਅਤੇ OAuth ਰਾਹੀਂ ਇੱਕ AI chat client ਨੂੰ ਕਨੈਕਟ ਕਰੋ।
Key Lessons
Networking ਅਤੇ Security MCP service Oracle ਦੀ tenancy ਵਿੱਚ ਚੱਲਦੀ ਹੈ। ਇਹ ਇਕੱਲੀ ਤੁਹਾਡੇ private database ਤੱਕ ਨਹੀਂ ਪਹੁੰਚ ਸਕਦੀ। ਤੁਹਾਨੂੰ ਆਪਣੇ VCN ਨਾਲ ਇੱਕ Private Endpoint ਜੋੜਨਾ ਪਵੇਗਾ। ਸੁਰੱਖਿਅਤ ਰਹਿਣ ਲਈ, ਇੱਕ read-only database user ਨਾਲ ਕਨੈਕਟ ਕਰੋ। ਇਹ ਕਿਸੇ ਵੀ ਗਲਤੀ ਨਾਲ ਹੋਣ ਵਾਲੇ write ਨੂੰ ਰੋਕਦਾ ਹੈ।
URL 'ਤੇ ਨਜ਼ਰ ਰੱਖੋ ਹਰ OCI MCP server URL ਵਿੱਚ /20250830/ ਵਰਗਾ ਇੱਕ date segment ਸ਼ਾਮਲ ਹੁੰਦਾ ਹੈ। ਜੇਕਰ ਤੁਸੀਂ ਪੁਰਾਣੀ ਤਾਰੀਖ ਦੀ ਵਰਤੋਂ ਕਰਦੇ ਹੋ, ਤਾਂ ਤੁਹਾਨੂੰ HTTP 404 error ਮਿਲੇਗਾ। ਇਹ error ਇੱਕ auth ਸਮੱਸਿਆ ਵਾਂਗ ਲੱਗਦਾ ਹੈ, ਪਰ ਇਹ ਸਿਰਫ਼ ਇੱਕ ਗਲਤ path ਹੈ। ਆਪਣੇ console ਤੋਂ ਸਹੀ URL ਕਾਪੀ ਕਰੋ।
OAuth ਦੀ ਸਮੱਸਿਆ ਬਹੁਤ ਸਾਰੇ web-based chat UIs ਇਸ server ਨਾਲ ਫੇਲ ਹੋ ਜਾਂਦੇ ਹਨ। ਉਹ server ਰਾਹੀਂ OAuth settings ਲੱਭਣ ਦੀ ਕੋਸ਼ਿਸ਼ ਕਰਦੇ ਹਨ। Oracle unauthenticated requests ਲਈ 404 ਰਿਟਰਨ ਕਰਦਾ ਹੈ। ਇਹ login flow ਨੂੰ ਰੋਕ ਦਿੰਦਾ ਹੈ। ਇਸ ਤੋਂ ਇਲਾਵਾ, headless web UIs ਵਿੱਚ interactive login ਲਈ browser ਨਹੀਂ ਹੁੰਦਾ।
User Tokens ਦੀ ਵਰਤੋਂ ਕਰੋ, App Tokens ਦੀ ਨਹੀਂ ਮੈਂ browser ਨੂੰ ਛੱਡਣ ਲਈ client-credentials token ਦੀ ਵਰਤੋਂ ਕਰਨ ਦੀ ਕੋਸ਼ਿਸ਼ ਕੀਤੀ। ਇਸ ਨੇ authentication ਤਾਂ ਕਰ ਦਿੱਤਾ, ਪਰ ਮੇਰੇ ਕੋਲ permissions ਨਹੀਂ ਸਨ। Oracle roles users ਨਾਲ ਜੁੜੇ ਹੁੰਦੇ ਹਨ, apps ਨਾਲ ਨਹੀਂ। ਤੁਹਾਨੂੰ authorization_code (user) token ਦੀ ਵਰਤੋਂ ਕਰਨੀ ਚਾਹੀਦੀ ਹੈ। User ਕੋਲ role ਹੁੰਦਾ ਹੈ, ਇਸ ਲਈ token ਕੰਮ ਕਰਦਾ ਹੈ।
Desktop Clients ਦੀ ਵਰਤੋਂ ਕਰੋ Claude Desktop ਜਾਂ VS Code ਵਰਗੇ desktop clients ਵਧੀਆ ਕੰਮ ਕਰਦੇ ਹਨ ਕਿਉਂਕਿ ਉਹਨਾਂ ਵਿੱਚ login ਲਈ built-in browsers ਹੁੰਦੇ ਹਨ। 404 discovery ਸਮੱਸਿਆ ਤੋਂ ਬਚਣ ਲਈ static OAuth metadata ਦੇ ਨਾਲ mcp-remote ਦੀ ਵਰਤੋਂ ਕਰੋ।
Quick Tips
- Windows 'ਤੇ, npx ਦੀ ਬਜਾਏ npx.cmd ਦੀ ਵਰਤੋਂ ਕਰੋ।
- ਇੱਕੋ OAuth callback port 'ਤੇ ਦੋ clients ਨਾ ਚਲਾਓ।
- SQL date formatting ਜਿਵੇਂ ਕਿ TO_CHAR ਵਿੱਚ colons ਦੀ ਵਰਤੋਂ ਕਰਨ ਤੋਂ ਬਚੋ। ਸਿਸਟਮ ਉਹਨਾਂ ਨੂੰ bind variables ਸਮਝ ਸਕਦਾ ਹੈ। ਇਸ ਦੀ ਬਜਾਏ raw dates ਦੀ ਵਰਤੋਂ ਕਰੋ।
- ਸਾਰੇ RAC instances ਦੇਖਣ ਲਈ v$ ਦੀ ਬਜਾਏ gv$ views ਦੀ ਵਰਤੋਂ ਕਰੋ।
AI agents ਦੇ ਨਾਲ Managed MCP ਨਿਯੰਤਰਿਤ ਡਾਟਾਬੇਸ ਕੰਮਾਂ ਲਈ ਉਪਯੋਗੀ ਹੈ। ਆਪਣੇ ਕਲਾਇੰਟ ਨੂੰ ਆਪਣੇ ਡਿਪਲਾਈਮੈਂਟ ਦੇ ਅਨੁਸਾਰ ਮਿਲਾਓ ਅਤੇ ਹਮੇਸ਼ਾ read-only ਯੂਜ਼ਰਸ ਦੀ ਵਰਤੋਂ ਕਰੋ।
ਵਿਕਲਪਿਕ ਲਰਨਿੰਗ ਕਮਿਊਨਿਟੀ: https://t.me/GyaanSetuAi