IBM Instana MCP Server

आधिकारिक

IBM Instana MCP सर्वर IBM Instana ऑब्ज़र्वेबिलिटी प्लेटफ़ॉर्म के साथ सहज इंटरैक्शन सक्षम करता है, जिससे आप अपने डेवलपमेंट वर्कफ़्लो में सीधे रीयल-टाइम ऑब्ज़र्वेबिलिटी डेटा तक पहुँच सकते हैं।

GitHub
25
इस MCP को आज़माएँप्रायोजित

IBM Instana MCP के साथ आप क्या कर सकते हैं?

  • एप्लिकेशन प्रदर्शन क्वेरी करें — app श्रेणी के टूल जैसे get_app_metrics या get_app_alerts का उपयोग करके एप्लिकेशन मेट्रिक्स, अलर्ट या कैटलॉग विवरण पूछें।
  • इंफ्रास्ट्रक्चर स्वास्थ्य की निगरानी करें — infra टूल जैसे get_infra_metrics या get_infra_topology के माध्यम से इंफ्रास्ट्रक्चर संसाधन, टोपोलॉजी और मेट्रिक्स प्राप्त करें।
  • इवेंट और घटनाओं को ट्रैक करें — events टूल जैसे get_k8s_events या get_agent_status के साथ Kubernetes इवेंट या एजेंट मॉनिटरिंग डेटा एक्सेस करें।
  • वेबसाइट मॉनिटरिंग का विश्लेषण करें — website टूल जैसे get_website_metrics या get_website_config का उपयोग करके वेबसाइट मेट्रिक्स, कैटलॉग जानकारी या कॉन्फ़िगरेशन प्राप्त करें।
  • श्रेणी के अनुसार टूल फ़िल्टर करें — प्रदर्शन अनुकूलित करने के लिए स्टार्टअप पर --tools फ्लैग के साथ केवल आवश्यक टूल श्रेणियाँ सक्षम करें (जैसे, --tools infra,events)।

दस्तावेज़

विषय-सूची

IBM Instana के लिए MCP सर्वर

📚 त्वरित लिंक

Instana MCP सर्वर Instana ऑब्ज़र्वेबिलिटी प्लेटफ़ॉर्म के साथ सहज इंटरैक्शन सक्षम करता है, जिससे आप अपने डेवलपमेंट कार्यप्रवाह के भीतर सीधे रीयल-टाइम ऑब्ज़र्वेबिलिटी डेटा तक पहुँच सकते हैं।

यह क्लाइंट (जैसे AI एजेंट या कस्टम टूल) और Instana REST APIs के बीच एक पुल के रूप में कार्य करता है, उपयोगकर्ता क्वेरी को Instana API अनुरोधों में परिवर्तित करता है और प्रतिक्रियाओं को संरचित, आसानी से उपभोग योग्य प्रारूपों में स्वरूपित करता है।

सर्वर विभिन्न MCP क्लाइंट के साथ अधिकतम संगतता के लिए स्ट्रीमेबल HTTP और Stdio दोनों ट्रांसपोर्ट मोड का समर्थन करता है। अधिक विवरण के लिए, MCP ट्रांसपोर्ट मोड विनिर्देश देखें।

आर्किटेक्चर अवलोकन

graph LR
    subgraph "Application Host Process"
        MH[MCP Host]
        MSI[Instana MCP Server]
        MST[ProductA MCP Server]
        MSC[ProductB MCP Server]

        MH <--> MSI
        MH <--> MSC
        MH <--> MST
    end

    subgraph "Remote Service"
        II[Instana Instance]
        TI[ProductA Instance]
        CI[ProductB Instance]

        MSI <--> II
        MST <--> TI
        MSC <--> CI
    end

    subgraph "LLM"
        L[LLM]
        MH <--> L
    end

कार्यप्रवाह

एक सरल उदाहरण पर विचार करें: आप एक MCP होस्ट (जैसे Claude Desktop, VS Code, या कोई अन्य क्लाइंट) का उपयोग कर रहे हैं जो Instana MCP सर्वर से जुड़ा है। जब आप Instana अलर्ट के बारे में जानकारी का अनुरोध करते हैं, तो निम्नलिखित प्रक्रिया होती है:

  1. MCP क्लाइंट Instana MCP सर्वर से उपलब्ध टूल की सूची प्राप्त करता है
  2. आपकी क्वेरी टूल विवरण के साथ LLM को भेजी जाती है
  3. LLM उपलब्ध टूल का विश्लेषण करता है और Instana अलर्ट प्राप्त करने के लिए उपयुक्त टूल का चयन करता है
  4. क्लाइंट Instana MCP सर्वर के माध्यम से चयनित टूल निष्पादित करता है
  5. परिणाम (नवीनतम अलर्ट) LLM को लौटाए जाते हैं
  6. LLM एक प्राकृतिक भाषा प्रतिक्रिया तैयार करता है
  7. प्रतिक्रिया आपको प्रदर्शित की जाती है
sequenceDiagram
    participant User
    participant ChatBot as MCP Host
    participant MCPClient as MCP Client
    participant MCPServer as Instana MCP Server
    participant LLM
    participant Instana as Instana Instance

    ChatBot->>MCPClient: Load available tools from MCP Server
    MCPClient->>MCPServer: Request available tool list
    MCPServer->>MCPClient: Return list of available tools
    User->>ChatBot: Ask "Show me the latest alerts from Instana for application robot-shop"
    ChatBot->>MCPClient: Forward query
    MCPClient->>LLM: Send query and tool description
    LLM->>MCPClient: Select appropriate tool(s) for Instana alert query
    MCPClient->>MCPServer: Execute selected tool(s)
    MCPServer->>Instana: Retrieve alerts for application robot-shop
    MCPServer->>MCPClient: Send alerts of Instana result
    MCPClient->>LLM: Forward alerts of Instana
    LLM->>ChatBot: Generate natural language response for Instana alerts
    ChatBot->>User: Show Instana alert response

पूर्वापेक्षाएँ

विकल्प 1: PyPI से इंस्टॉल करें (अनुशंसित)

mcp-instana का उपयोग करने का सबसे आसान तरीका इसे सीधे PyPI से इंस्टॉल करना है:

pip install mcp-instana

इंस्टॉलेशन के बाद, आप mcp-instana कमांड का उपयोग करके सीधे सर्वर चला सकते हैं।

विकल्प 2: डेवलपमेंट इंस्टॉलेशन

डेवलपमेंट या स्थानीय अनुकूलन के लिए, आप प्रोजेक्ट को क्लोन करके स्थानीय रूप से सेट कर सकते हैं।

uv इंस्टॉल करना

यह प्रोजेक्ट uv का उपयोग करता है, जो एक तेज़ Python पैकेज इंस्टॉलर और रिज़ॉल्वर है। uv इंस्टॉल करने के लिए, आपके पास कई विकल्प हैं:

pip का उपयोग करके:

pip install uv

Homebrew का उपयोग करके (macOS):

brew install uv

अधिक इंस्टॉलेशन विकल्पों और विस्तृत निर्देशों के लिए, uv दस्तावेज़ीकरण देखें।

पर्यावरण सेट करना

uv इंस्टॉल करने के बाद, निम्न चलाकर प्रोजेक्ट पर्यावरण सेट करें:

uv sync

स्ट्रीमेबल HTTP मोड के लिए हेडर-आधारित प्रमाणीकरण

स्ट्रीमेबल HTTP मोड का उपयोग करते समय, आपको HTTP हेडर के माध्यम से Instana क्रेडेंशियल पास करने होंगे। यह दृष्टिकोण सुरक्षा और लचीलापन बढ़ाता है:

  • पर्यावरण चर में क्रेडेंशियल संग्रहीत करने से बचना
  • विभिन्न अनुरोधों के लिए विभिन्न क्रेडेंशियल का उपयोग सक्षम करना
  • साझा पर्यावरणों का समर्थन करना जहाँ पर्यावरण चर संशोधन प्रतिबंधित है
  • API टोकन और सत्र-आधारित प्रमाणीकरण दोनों का समर्थन करना

समर्थित प्रमाणीकरण मोड:

1. API टोकन प्रमाणीकरण (प्रत्यक्ष API कॉल)

आवश्यक हेडर:

  • instana-base-url: आपका Instana इंस्टेंस URL
  • instana-api-token: आपका Instana API टोकन

उदाहरण:

--header "instana-base-url: https://your-instance.instana.io"
--header "instana-api-token: your-api-token"

2. सत्र टोकन प्रमाणीकरण (UI-आरंभित कॉल)

आवश्यक हेडर:

  • instana-base-url: आपका Instana इंस्टेंस URL
  • instana-auth-token: UI बैकएंड से सत्र प्रमाणीकरण टोकन
  • instana-csrf-token: UI बैकएंड से CSRF टोकन
  • instana-cookie-name: (वैकल्पिक) सत्र प्रमाणीकरण के लिए कुकी नाम (डिफ़ॉल्ट: instanaAuthToken)

उदाहरण:

--header "instana-base-url: https://your-instance.instana.io"
--header "instana-auth-token: your-session-token"
--header "instana-csrf-token: your-csrf-token"
--header "instana-cookie-name: in-token"

3. JWT टोकन प्रमाणीकरण (IBM प्लेटफ़ॉर्म एकीकरण)

आवश्यक हेडर:

  • instana-base-url: आपका Instana इंस्टेंस URL
  • instana-jwt-token: IBM प्लेटफ़ॉर्म से JWT टोकन
  • instana-csrf-token: अनुरोध सत्यापन के लिए CSRF टोकन

उदाहरण कॉन्फ़िगरेशन:

{
  "mcpServers": {
    "Instana MCP Server": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://0.0.0.0:8080/mcp",
        "--allow-http",
        "--header",
        "instana-base-url: https://your-instana-instance.instana.io",
        "--header",
        "instana-jwt-token: your_jwt_token_here",
        "--header",
        "instana-csrf-token: your_csrf_token_here"
      ]
    }
  }
}

प्रमाणीकरण प्राथमिकता:

  1. JWT टोकन (यदि CSRF टोकन के साथ प्रदान किया गया है) - IBM प्लेटफ़ॉर्म एकीकरण के लिए प्राथमिकता लेता है
  2. सत्र टोकन (यदि auth_token और csrf_token दोनों प्रदान किए गए हैं)
  3. API टोकन (यदि प्रदान किया गया है) - मानक प्रमाणीकरण
  4. पर्यावरण चर (INSTANA_API_TOKEN) - फ़ॉलबैक

प्रमाणीकरण प्रवाह:

  1. HTTP हेडर प्रत्येक अनुरोध में मौजूद होने चाहिए
  2. सर्वर प्राथमिकता क्रम के आधार पर क्रेडेंशियल सत्यापित करता है
  3. वैध प्रमाणीकरण के बिना अनुरोध विफल होंगे

यह डिज़ाइन सुरक्षित क्रेडेंशियल ट्रांसमिशन सुनिश्चित करता है और WebSocket → Coordinator → MCP सर्वर के माध्यम से UI-आरंभित कॉल सहित कई प्रमाणीकरण प्रवाहों का समर्थन करता है।

सुनिश्चित करें कि उपयोग किए गए टोकन में MCP टूल को कॉल करने के लिए आवश्यक अनुमतियाँ हैं। अधिक जानकारी के लिए यहाँ देखें।

स्थानीय MCP सर्वर प्रारंभ करना

किसी भी MCP क्लाइंट (Claude Desktop, GitHub Copilot, या कस्टम MCP क्लाइंट) को कॉन्फ़िगर करने से पहले, आपको स्थानीय MCP सर्वर प्रारंभ करना होगा। सर्वर दो ट्रांसपोर्ट मोड का समर्थन करता है: स्ट्रीमेबल HTTP और Stdio।

सर्वर कमांड विकल्प

CLI का उपयोग करना (PyPI इंस्टॉलेशन)

यदि आपने PyPI से mcp-instana इंस्टॉल किया है, तो mcp-instana कमांड का उपयोग करें:

mcp-instana [OPTIONS]

डेवलपमेंट इंस्टॉलेशन का उपयोग करना

स्थानीय डेवलपमेंट के लिए, uv run कमांड का उपयोग करें:

uv run src/core/server.py [OPTIONS]

उपलब्ध विकल्प:

  • --transport <mode>: ट्रांसपोर्ट मोड (विकल्प: streamable-http, stdio)
  • --env KEY=VALUE: पर्यावरण चर सेट करें (एकाधिक चर के लिए दोहराया जा सकता है, जैसे, --env INSTANA_BASE_URL=https://... --env INSTANA_API_TOKEN=...)
  • --debug: अतिरिक्त लॉगिंग के साथ डीबग मोड सक्षम करें
  • --log-level <level>: लॉगिंग स्तर सेट करें (विकल्प: DEBUG, INFO, WARNING, ERROR, CRITICAL)
  • --tools <categories>: सक्षम करने के लिए टूल श्रेणियों की अल्पविराम-पृथक सूची (जैसे, infra,app,events,website)। एक श्रेणी सक्षम करने से उससे संबंधित प्रॉम्प्ट भी सक्षम होंगे। उदाहरण के लिए: --tools infra infra टूल और सभी infra-संबंधित प्रॉम्प्ट सक्षम करता है।
  • --list-tools: सभी उपलब्ध टूल श्रेणियाँ सूचीबद्ध करें और बाहर निकलें
  • --port <port>: MCP सर्वर पोर्ट (डिफ़ॉल्ट: 8080, PORT env var के साथ ओवरराइड किया जा सकता है)
  • --verify-ssl: आउटगोइंग Instana API कॉल के लिए SSL प्रमाणपत्र सत्यापन सक्षम करें। INSTANA_SSL_VERIFY=true सेट करने के बराबर। SSL सत्यापन डिफ़ॉल्ट रूप से अक्षम है।
  • --help: सहायता संदेश दिखाएँ और बाहर निकलें

स्ट्रीमेबल HTTP मोड में प्रारंभ करना

स्ट्रीमेबल HTTP मोड एक REST API इंटरफ़ेस प्रदान करता है और अधिकांश उपयोग मामलों के लिए अनुशंसित है।

CLI का उपयोग करना (PyPI इंस्टॉलेशन)

# Start with all tools enabled (default)
mcp-instana --transport streamable-http

# Start with debug logging
mcp-instana --transport streamable-http --debug

# Start with a specific log level
mcp-instana --transport streamable-http --log-level WARNING

# Start with specific tool categories only
mcp-instana --transport streamable-http --tools infra,events

# Combine options (specific log level, custom tools)
mcp-instana --transport streamable-http --log-level DEBUG --tools app,events

डेवलपमेंट इंस्टॉलेशन का उपयोग करना

# Start with all tools enabled (default)
uv run src/core/server.py --transport streamable-http

# Start with debug logging
uv run src/core/server.py --transport streamable-http --debug

# Start with a specific log level
uv run src/core/server.py --transport streamable-http --log-level WARNING

# Start with specific tool and prompts categories only
uv run src/core/server.py --transport streamable-http --tools infra,events

# Start with custom port
uv run src/core/server.py --transport streamable-http --port 9000

# Combine options (specific log level, custom tools and prompts)
uv run src/core/server.py --transport streamable-http --log-level DEBUG --tools app,events

स्ट्रीमेबल HTTP मोड की मुख्य विशेषताएँ:

  • प्रमाणीकरण के लिए HTTP हेडर का उपयोग करता है (कोई पर्यावरण चर आवश्यक नहीं)
  • प्रति अनुरोध विभिन्न क्रेडेंशियल का समर्थन करता है
  • साझा पर्यावरणों के लिए बेहतर उपयुक्त
  • MCP सर्वर डिफ़ॉल्ट पोर्ट: 8080
  • MCP एंडपॉइंट: http://0.0.0.0:8080/mcp/

Stdio मोड में प्रारंभ करना

Stdio मोड संचार के लिए मानक इनपुट/आउटपुट का उपयोग करता है और प्रमाणीकरण के लिए पर्यावरण चर की आवश्यकता होती है।

CLI का उपयोग करना (PyPI इंस्टॉलेशन)

# Option 1: Set environment variables first
export INSTANA_BASE_URL="https://your-instana-instance.instana.io"
export INSTANA_API_TOKEN="your_instana_api_token"

# Start the server (stdio is the default if no transport specified)
mcp-instana

# Or explicitly specify stdio mode
mcp-instana --transport stdio

# Option 2: Use --env flag to set environment variables directly
mcp-instana --env INSTANA_BASE_URL=https://your-instana-instance.instana.io --env INSTANA_API_TOKEN=your_instana_api_token

# Or with explicit stdio mode
mcp-instana --transport stdio --env INSTANA_BASE_URL=https://your-instana-instance.instana.io --env INSTANA_API_TOKEN=your_instana_api_token

डेवलपमेंट इंस्टॉलेशन का उपयोग करना

# Option 1: Set environment variables first
export INSTANA_BASE_URL="https://your-instana-instance.instana.io"
export INSTANA_API_TOKEN="your_instana_api_token"

# Start the server (stdio is the default if no transport specified)
uv run src/core/server.py

# Or explicitly specify stdio mode
uv run src/core/server.py --transport stdio

# Option 2: Use --env flag to set environment variables directly
uv run src/core/server.py --env INSTANA_BASE_URL=https://your-instana-instance.instana.io --env INSTANA_API_TOKEN=your_instana_api_token

# Or with explicit stdio mode
uv run src/core/server.py --transport stdio --env INSTANA_BASE_URL=https://your-instana-instance.instana.io --env INSTANA_API_TOKEN=your_instana_api_token

Stdio मोड की मुख्य विशेषताएँ:

  • प्रमाणीकरण के लिए पर्यावरण चर का उपयोग करता है (export या --env फ़्लैग के माध्यम से सेट किया जा सकता है)
  • stdin/stdout के माध्यम से सीधा संचार
  • कुछ MCP क्लाइंट कॉन्फ़िगरेशन के लिए आवश्यक
  • --env फ़्लैग शेल पर्यावरण को संशोधित किए बिना क्रेडेंशियल सेट करने का एक सुविधाजनक तरीका प्रदान करता है

टूल श्रेणियाँ

आप केवल आवश्यक टूल और प्रॉम्प्ट श्रेणियाँ सक्षम करके सर्वर प्रदर्शन को अनुकूलित कर सकते हैं:

CLI का उपयोग करना (PyPI इंस्टॉलेशन)

# List all available categories
mcp-instana --list-tools

# Enable specific categories
mcp-instana --transport streamable-http --tools infra,app
mcp-instana --transport streamable-http --tools events

डेवलपमेंट इंस्टॉलेशन का उपयोग करना

# List all available categories
uv run src/core/server.py --list-tools

# Enable specific categories
uv run src/core/server.py --transport streamable-http --tools infra,app
uv run src/core/server.py --transport streamable-http --tools events

उपलब्ध श्रेणियाँ:

  • infra: इंफ्रास्ट्रक्चर मॉनिटरिंग टूल और प्रॉम्प्ट (resources, catalog, topology, analyze, metrics)
  • app: एप्लिकेशन प्रदर्शन टूल और प्रॉम्प्ट (resources, metrics, alerts, catalog, topology, analyze, settings, global alerts)
  • events: इवेंट मॉनिटरिंग टूल और प्रॉम्प्ट (Kubernetes events, agent monitoring)
  • website: वेबसाइट मॉनिटरिंग टूल और प्रॉम्प्ट (metrics, catalog, analyze, configuration)

SSL प्रमाणपत्र सत्यापन

आउटगोइंग Instana API कॉल के लिए SSL प्रमाणपत्र सत्यापन डिफ़ॉल्ट रूप से अक्षम है। यह स्ट्रीमेबल HTTP और Stdio दोनों ट्रांसपोर्ट मोड पर लागू होता है।

SSL प्रमाणपत्र सत्यापन सक्षम करने के लिए, --verify-ssl CLI विकल्प या INSTANA_SSL_VERIFY पर्यावरण चर का उपयोग करें।

CLI विकल्प का उपयोग करना

uv run src/core/server.py --verify-ssl

--verify-ssl विकल्प निम्नलिखित सेट करने के बराबर है:

export INSTANA_SSL_VERIFY=true

पर्यावरण चर का उपयोग करना

export INSTANA_SSL_VERIFY=true
uv run src/core/server.py

SSL सत्यापन तब अक्षम होता है जब INSTANA_SSL_VERIFY को 0, false, या no (केस-असंवेदनशील) पर सेट किया जाता है, या खाली छोड़ दिया जाता है। कोई भी अन्य मान सत्यापन सक्षम करता है — पारंपरिक विकल्पों के रूप में true, 1, या yes का उपयोग करें।

कस्टम CA बंडल का उपयोग करना

जब SSL सत्यापन सक्षम होता है, तो डिफ़ॉल्ट रूप से सिस्टम CA बंडल का उपयोग किया जाता है। कस्टम CA प्रमाणपत्र बंडल का उपयोग करने के लिए, INSTANA_CA_BUNDLE सेट करें:

export INSTANA_SSL_VERIFY=true
export INSTANA_CA_BUNDLE=/path/to/ca-bundle.crt
uv run src/core/server.py

INSTANA_CA_BUNDLE का उपयोग केवल तब किया जाता है जब SSL प्रमाणपत्र सत्यापन सक्षम हो।

सर्वर स्टार्टअप पर प्रभावी SSL सत्यापन स्थिति लॉग करता है, ताकि आप तुरंत पुष्टि कर सकें कि आपका पर्यावरण चर या CLI फ्लैग उठाया गया था या नहीं।

सर्वर स्थिति सत्यापित करना

शुरू होने के बाद, आप सत्यापित कर सकते हैं कि सर्वर चल रहा है:

Streamable HTTP मोड के लिए:

# Check MCP server
curl http://0.0.0.0:8080/mcp/

# Or with custom port
curl http://0.0.0.0:9000/mcp/

Stdio मोड के लिए: सर्वर शुरू होगा और MCP क्लाइंट से stdin इनपुट की प्रतीक्षा करेगा।

सामान्य स्टार्टअप समस्याएं

SSL / प्रमाणपत्र समस्याएं: कॉन्फ़िगरेशन विकल्पों के लिए ऊपर SSL प्रमाणपत्र सत्यापन अनुभाग देखें। यदि आपको सत्यापन सक्षम के साथ SSL त्रुटियां मिलती हैं और आप macOS का उपयोग कर रहे हैं, तो सुनिश्चित करें कि आपके Python पर्यावरण के पास सिस्टम प्रमाणपत्रों तक पहुंच है:

# macOS - Install certificates for Python
/Applications/Python\ 3.13/Install\ Certificates.command

पोर्ट पहले से उपयोग में है: यदि पोर्ट 8080 पहले से उपयोग में है, तो एक अलग पोर्ट निर्दिष्ट करें:

uv run src/core/server.py --transport streamable-http --port 9000

लापता निर्भरताएं: सुनिश्चित करें कि सभी निर्भरताएं स्थापित हैं:

uv sync

सेटअप और उपयोग

Bob IDE

Bob IBM का AI-संचालित IDE है जो मूल रूप से MCP एकीकरण का समर्थन करता है। Bob अंतर्निहित AI सहायता और अवलोकनीयता उपकरणों के साथ एक सहज विकास अनुभव प्रदान करता है।

Streamable HTTP मोड

Streamable HTTP मोड HTTP पर JSON-RPC का उपयोग करके MCP संचार के लिए एक REST API इंटरफ़ेस प्रदान करता है।

चरण 1: MCP सर्वर को Streamable HTTP मोड में शुरू करें

Bob को कॉन्फ़िगर करने से पहले, आपको MCP सर्वर को Streamable HTTP मोड में शुरू करना होगा। विस्तृत निर्देशों के लिए कृपया स्थानीय MCP सर्वर शुरू करना अनुभाग देखें।

चरण 2: Bob को कॉन्फ़िगर करें

Bob पैनल के ऊपरी दाएं कोने में, आपको MCP सर्वरों के साथ एक ड्रॉपडाउन दिखाई देगा:

इसे चुनने पर, आपको प्रोजेक्ट स्तर या वैश्विक स्तर पर MCP कॉन्फ़िगर करने का विकल्प देखने में सक्षम होना चाहिए।

MCP कॉन्फ़िगरेशन स्कोप

Bob MCP कॉन्फ़िगरेशन के दो स्तरों का समर्थन करता है, जिससे आप अपने उपयोग के मामले के लिए सबसे उपयुक्त स्कोप चुन सकते हैं:

1. वैश्विक कॉन्फ़िगरेशन (उपयोगकर्ता-स्तर)

वैश्विक कॉन्फ़िगरेशन वर्तमान उपयोगकर्ता के सभी प्रोजेक्टों में MCP सर्वर लागू करता है। यह आदर्श है जब आप चाहते हैं कि समान MCP सर्वर आपके द्वारा काम किए जाने वाले हर प्रोजेक्ट में उपलब्ध हों।

फ़ाइल स्थान:

  • macOS: ~/Library/Application Support/Bob/bob_config.json
  • Windows: %APPDATA%\Bob\bob_config.json
  • Linux: ~/.config/Bob/bob_config.json

2. प्रोजेक्ट कॉन्फ़िगरेशन (प्रोजेक्ट-स्तर)

प्रोजेक्ट कॉन्फ़िगरेशन MCP सर्वर केवल एक विशिष्ट प्रोजेक्ट पर लागू करता है। यह उपयोगी है जब विभिन्न प्रोजेक्टों को अलग-अलग MCP सर्वर कॉन्फ़िगरेशन की आवश्यकता होती है या जब आप संस्करण नियंत्रण के माध्यम से अपनी टीम के साथ MCP सेटिंग्स साझा करना चाहते हैं।

फ़ाइल स्थान:

  • आपके प्रोजेक्ट रूट निर्देशिका में .bob/bob_config.json

वैश्विक और प्रोजेक्ट कॉन्फ़िगरेशन के बीच चयन करना:

  • उन MCP सर्वरों के लिए वैश्विक कॉन्फ़िगरेशन का उपयोग करें जिन्हें आप अपने सभी प्रोजेक्टों में उपलब्ध चाहते हैं
  • प्रोजेक्ट-विशिष्ट MCP सर्वरों के लिए या अपनी टीम के साथ कॉन्फ़िगरेशन साझा करने के लिए प्रोजेक्ट कॉन्फ़िगरेशन का उपयोग करें
  • दोनों कॉन्फ़िगरेशन सह-अस्तित्व में रह सकते हैं - समान सर्वर नाम के लिए प्रोजेक्ट-स्तरीय सेटिंग्स वैश्विक सेटिंग्स पर प्राथमिकता लेती हैं

Bob और MCP कॉन्फ़िगरेशन के बारे में अधिक जानकारी के लिए, देखें: https://bob.ibm.com/docs/ide/configuration/mcp/mcp-in-bob

स्थानीय कॉन्फ़िगरेशन:

अपने स्थानीय Instana MCP सर्वर से कनेक्ट करने के लिए Bob को कॉन्फ़िगर करें:

{
  "mcpServers": {
    "Instana MCP Server": {
      "command": "npx",
      "args": [
        "mcp-remote", "http://0.0.0.0:8080/mcp/",
        "--allow-http",
        "--header", "instana-base-url: https://your-instana-instance.instana.io",
        "--header", "instana-api-token: your_instana_api_token"
      ]
    }
  }
}

दूरस्थ कॉन्फ़िगरेशन:

दूरस्थ Instana MCP सर्वर (जैसे, IBM Code Engine पर तैनात) से कनेक्ट करने के लिए Bob को कॉन्फ़िगर करें:

{
  "mcpServers": {
    "Instana MCP Server": {
      "command": "npx",
      "args": [
        "mcp-remote", "https://app-instana-750.1zetetanw8ul.us-east.codeengine.appdomain.cloud/mcp/",
        "--allow-http",
        "--header", "instana-base-url: https://your-instana-instance.instana.io",
        "--header", "instana-api-token: your_instana_api_token"
      ]
    }
  }
}

नोट: npx का उपयोग करने के लिए, हम पहले NVM (Node Version Manager) स्थापित करने की अनुशंसा करते हैं, फिर इसका उपयोग Node.js स्थापित करने के लिए करें। स्थापना निर्देश यहां उपलब्ध हैं: https://nodejs.org/en/download

चरण 3: कनेक्शन का परीक्षण करें

एक बार जब आप MCP कॉन्फ़िगरेशन सेट कर लेते हैं, तो नया कॉन्फ़िगर किया गया MCP सर्वर सक्षम के रूप में दिखाई देना चाहिए। एक हरा बिंदु इंगित करता है कि सर्वर सफलतापूर्वक चल रहा है।

अब आप Bob IDE में क्वेरी चला सकते हैं:

get me all applications from Instana in the last 24 hours

Stdio मोड

CLI का उपयोग करके कॉन्फ़िगरेशन (PyPI स्थापना - अनुशंसित):

विकल्प 1: कॉन्फ़िग में पर्यावरण चर का उपयोग करना:

{
  "mcpServers": {
    "Instana MCP Server": {
      "command": "mcp-instana",
      "args": ["--transport", "stdio"],
      "env": {
        "INSTANA_BASE_URL": "https://your-instana-instance.instana.io",
        "INSTANA_API_TOKEN": "your_instana_api_token"
      }
    }
  }
}

विकल्प 2: --env फ्लैग का उपयोग करना (वैकल्पिक विधि):

{
  "mcpServers": {
    "Instana MCP Server": {
      "command": "mcp-instana",
      "args": [
        "--transport", "stdio",
        "--env", "INSTANA_BASE_URL=https://your-instana-instance.instana.io",
        "--env", "INSTANA_API_TOKEN=your_instana_api_token"
      ]
    }
  }
}

नोट: यदि आपको "command not found" त्रुटियां मिलती हैं, तो mcp-instana का पूर्ण पथ उपयोग करें। इसे which mcp-instana के साथ खोजें और उस पथ का उपयोग करें।

विकास स्थापना का उपयोग करके कॉन्फ़िगरेशन:

विकल्प 1: कॉन्फ़िग में पर्यावरण चर का उपयोग करना:

{
  "mcpServers": {
    "Instana MCP Server": {
      "command": "uv",
      "args": [
        "--directory",
        "<path-to-mcp-instana-folder>",
        "run",
        "src/core/server.py"
      ],
      "env": {
        "INSTANA_BASE_URL": "https://your-instana-instance.instana.io",
        "INSTANA_API_TOKEN": "your_instana_api_token"
      }
    }
  }
}

विकल्प 2: --env फ्लैग का उपयोग करना (वैकल्पिक विधि):

{
  "mcpServers": {
    "Instana MCP Server": {
      "command": "uv",
      "args": [
        "--directory",
        "<path-to-mcp-instana-folder>",
        "run",
        "src/core/server.py",
        "--env", "INSTANA_BASE_URL=https://your-instana-instance.instana.io",
        "--env", "INSTANA_API_TOKEN=your_instana_api_token"
      ]
    }
  }
}

Claude Desktop

Claude Desktop MCP एकीकरण के लिए Streamable HTTP और Stdio दोनों मोड का समर्थन करता है।

कॉन्फ़िगरेशन फ़ाइल को संपादित करके Claude Desktop को कॉन्फ़िगर करें:

फ़ाइल स्थान:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Streamable HTTP मोड

Streamable HTTP मोड HTTP पर JSON-RPC का उपयोग करके MCP संचार के लिए एक REST API इंटरफ़ेस प्रदान करता है।

चरण 1: MCP सर्वर को Streamable HTTP मोड में शुरू करें

Claude Desktop को कॉन्फ़िगर करने से पहले, आपको MCP सर्वर को Streamable HTTP मोड में शुरू करना होगा। विस्तृत निर्देशों के लिए कृपया स्थानीय MCP सर्वर शुरू करना अनुभाग देखें।

चरण 2: Claude Desktop को कॉन्फ़िगर करें

हेडर के माध्यम से Instana क्रेडेंशियल पास करने के लिए Claude Desktop को कॉन्फ़िगर करें:

{
  "mcpServers": {
    "Instana MCP Server": {
      "command": "npx",
      "args": [
        "mcp-remote", "http://0.0.0.0:8080/mcp/",
        "--allow-http",
        "--header", "instana-base-url: https://your-instana-instance.instana.io",
        "--header", "instana-api-token: your_instana_api_token"
      ]
    }
  }
}

नोट: npx का उपयोग करने के लिए, हम पहले NVM (Node Version Manager) स्थापित करने की अनुशंसा करते हैं, फिर इसका उपयोग Node.js स्थापित करने के लिए करें। स्थापना निर्देश यहां उपलब्ध हैं: https://nodejs.org/en/download

चरण 3: कनेक्शन का परीक्षण करें

Claude Desktop को पुनः आरंभ करें। अब आपको Claude Desktop इंटरफ़ेस में Instana MCP सर्वर नीचे दिखाए अनुसार देखना चाहिए:

अब आप Claude Desktop में क्वेरी चला सकते हैं:

get me all endpoints from Instana

Stdio मोड

CLI का उपयोग करके कॉन्फ़िगरेशन (PyPI स्थापना - अनुशंसित):

विकल्प 1: कॉन्फ़िग में पर्यावरण चर का उपयोग करना:

{
  "mcpServers": {
    "Instana MCP Server": {
      "command": "mcp-instana",
      "args": ["--transport", "stdio"],
      "env": {
        "INSTANA_BASE_URL": "https://your-instana-instance.instana.io",
        "INSTANA_API_TOKEN": "your_instana_api_token"
      }
    }
  }
}

विकल्प 2: --env फ्लैग का उपयोग करना (वैकल्पिक विधि):

{
  "mcpServers": {
    "Instana MCP Server": {
      "command": "mcp-instana",
      "args": [
        "--transport", "stdio",
        "--env", "INSTANA_BASE_URL=https://your-instana-instance.instana.io",
        "--env", "INSTANA_API_TOKEN=your_instana_api_token"
      ]
    }
  }
}

नोट: यदि आपको "command not found" त्रुटियां मिलती हैं, तो mcp-instana का पूर्ण पथ उपयोग करें। इसे which mcp-instana के साथ खोजें और उस पथ का उपयोग करें।

विकास स्थापना का उपयोग करके कॉन्फ़िगरेशन:

विकल्प 1: कॉन्फ़िग में पर्यावरण चर का उपयोग करना:

{
  "mcpServers": {
    "Instana MCP Server": {
      "command": "uv",
      "args": [
        "--directory",
        "<path-to-mcp-instana-folder>",
        "run",
        "src/core/server.py"
      ],
      "env": {
        "INSTANA_BASE_URL": "https://your-instana-instance.instana.io",
        "INSTANA_API_TOKEN": "your_instana_api_token"
      }
    }
  }
}

विकल्प 2: --env फ्लैग का उपयोग करना (वैकल्पिक विधि):

{
  "mcpServers": {
    "Instana MCP Server": {
      "command": "uv",
      "args": [
        "--directory",
        "<path-to-mcp-instana-folder>",
        "run",
        "src/core/server.py",
        "--env", "INSTANA_BASE_URL=https://your-instana-instance.instana.io",
        "--env", "INSTANA_API_TOKEN=your_instana_api_token"
      ]
    }
  }
}

Kiro सेटअप

Kiro एक एजेंटिक IDE है, न कि एक एक्सटेंशन जिसे VS Code या किसी अन्य IDE में डाउनलोड किया जा सकता है।

चरण 1: अपने ऑपरेटिंग सिस्टम के लिए https://kiro.dev/. से Kiro डाउनलोड और स्थापित करें

चरण 2: स्थापना के बाद, Kiro लॉन्च करें और IDE में कोई भी प्रोजेक्ट खोलें। alt text

चरण 3: Kiro की सुविधाओं तक पहुंचने के लिए बाएं साइडबार में Kiro (Ghost) आइकन पर क्लिक करें। alt text

चरण 4: MCP सर्वर अनुभाग के ऊपरी दाएं कोने में Edit Config आइकन चुनें। alt text

चरण 5: MCP सर्वर कॉन्फ़िगरेशन फ़ाइल (mcp.json) खोलें और इसे अपने पसंदीदा ट्रांसपोर्ट मोड के आधार पर कॉन्फ़िगर करें:

Streamable HTTP मोड (Kiro के लिए अनुशंसित)

{
  "mcpServers": {
    "Instana MCP Server": {
      "command": "npx",
      "args": [
        "mcp-remote", "http://0.0.0.0:8080/mcp/",
        "--allow-http",
        "--header", "instana-base-url: https://your-instana-instance.instana.io",
        "--header", "instana-api-token: your_instana_api_token"
      ]
    }
  }
}

नोट: इस कॉन्फ़िगरेशन का उपयोग करने से पहले MCP सर्वर को streamable-http मोड में शुरू करना सुनिश्चित करें:

mcp-instana --transport streamable-http

Stdio मोड

विकल्प 1: कॉन्फ़िग में पर्यावरण चर का उपयोग करना:

{
  "mcpServers": {
    "Instana MCP Server": {
      "command": "mcp-instana",
      "args": ["--transport", "stdio"],
      "env": {
        "INSTANA_BASE_URL": "https://your-instana-instance.instana.io",
        "INSTANA_API_TOKEN": "your_instana_api_token"
      }
    }
  }
}

विकल्प 2: --env फ्लैग का उपयोग करना (वैकल्पिक विधि):

{
  "mcpServers": {
    "Instana MCP Server": {
      "command": "mcp-instana",
      "args": [
        "--transport", "stdio",
        "--env", "INSTANA_BASE_URL=https://your-instana-instance.instana.io",
        "--env", "INSTANA_API_TOKEN=your_instana_api_token"
      ]
    }
  }
}

चरण 6: फ़ाइल सहेजने के बाद, Enable MCP बटन पर क्लिक करें और आप अपने MCP सर्वर और उसके उपलब्ध उपकरणों को Kiro के निचले-बाएं अनुभाग में दिखाई देते हुए देखेंगे। alt text

चरण 7: AI Chat पैनल पर जाएं, अपने MCP सर्वर से संबंधित एक प्रॉम्प्ट दर्ज करें, और प्रतिक्रिया को सीधे Kiro के भीतर देखें। alt text

GitHub Copilot

GitHub Copilot VS Code कॉन्फ़िगरेशन के माध्यम से MCP एकीकरण का समर्थन करता है। VS Code के साथ GitHub Copilot एकीकरण के लिए, इस सेटअप गाइड को देखें।

Streamable HTTP मोड

चरण 1: MCP सर्वर को Streamable HTTP मोड में शुरू करें

VS Code को कॉन्फ़िगर करने से पहले, आपको MCP सर्वर को Streamable HTTP मोड में शुरू करना होगा। विस्तृत निर्देशों के लिए कृपया स्थानीय MCP सर्वर शुरू करना अनुभाग देखें।

चरण 2: VS Code को कॉन्फ़िगर करें

विस्तृत कॉन्फ़िगरेशन के लिए VS Code में MCP सर्वर का उपयोग करें देखें।

आप निम्नलिखित कॉन्फ़िगरेशन के साथ सीधे .vscode/mcp.json बना या अपडेट कर सकते हैं:

{
  "servers": {
    "Instana MCP Server": {
      "command": "npx",
      "args": [
        "mcp-remote", "http://0.0.0.0:8080/mcp/",
        "--allow-http",
        "--header", "instana-base-url: https://your-instana-instance.instana.io",
        "--header", "instana-api-token: your_instana_api_token"
      ],
      "env": {
        "PATH": "/usr/local/bin:/bin:/usr/bin",
        "SHELL": "/bin/sh"
      }
    }
  }
}

नोट: निम्नलिखित मानों को अपने वास्तविक कॉन्फ़िगरेशन से बदलें:

  • instana-base-url: आपका Instana इंस्टेंस URL
  • instana-api-token: आपका Instana API टोकन
  • command: अपने सिस्टम के Node.js स्थापना से मेल खाने के लिए npx पथ अपडेट करें (जैसे, /path/to/your/node/bin/npx)
  • पर्यावरण चर: अपने सिस्टम के लिए आवश्यकतानुसार PATH और अन्य पर्यावरण चर समायोजित करें

Stdio मोड

चरण 1: VS Code MCP कॉन्फ़िगरेशन बनाएं

CLI का उपयोग करके (PyPI स्थापना - अनुशंसित):

अपने प्रोजेक्ट रूट में .vscode/mcp.json बनाएं:

विकल्प 1: कॉन्फ़िग में पर्यावरण चर का उपयोग करना:

{
  "servers": {
    "Instana MCP Server": {
      "command": "mcp-instana",
      "args": ["--transport", "stdio"],
      "env": {
        "INSTANA_BASE_URL": "https://your-instana-instance.instana.io",
        "INSTANA_API_TOKEN": "your_instana_api_token"
      }
    }
  }
}

विकल्प 2: --env फ्लैग का उपयोग करना (वैकल्पिक विधि):

{
  "servers": {
    "Instana MCP Server": {
      "command": "mcp-instana",
      "args": [
        "--transport", "stdio",
        "--env", "INSTANA_BASE_URL=https://your-instana-instance.instana.io",
        "--env", "INSTANA_API_TOKEN=your_instana_api_token"
      ]
    }
  }
}

विकास स्थापना का उपयोग करके:

अपने प्रोजेक्ट रूट में .vscode/mcp.json बनाएं:

विकल्प 1: कॉन्फ़िग में पर्यावरण चर का उपयोग करना:

{
  "servers": {
    "Instana MCP Server": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/your/project/mcp-instana",
        "run",
        "src/core/server.py"
      ],
      "env": {
        "INSTANA_BASE_URL": "https://your-instana-instance.instana.io",
        "INSTANA_API_TOKEN": "your_instana_api_token"
      }
    }
  }
}

विकल्प 2: --env फ्लैग का उपयोग करना (वैकल्पिक विधि):

{
  "servers": {
    "Instana MCP Server": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/your/project/mcp-instana",
        "run",
        "src/core/server.py",
        "--env", "INSTANA_BASE_URL=https://your-instana-instance.instana.io",
        "--env", "INSTANA_API_TOKEN=your_instana_api_token"
      ]
    }
  }
}

नोट: निम्नलिखित मानों को अपने वास्तविक कॉन्फ़िगरेशन से बदलें:

  • CLI स्थापना के लिए: सुनिश्चित करें कि mcp-instana आपके PATH में है
  • विकास स्थापना के लिए:
    • command: अपने सिस्टम की uv स्थापना से मेल खाने के लिए uv पथ अपडेट करें (जैसे, /path/to/your/uv/bin/uv या /usr/local/bin/uv)
    • --directory: अपने mcp-instana प्रोजेक्ट निर्देशिका के पूर्ण पथ के साथ अपडेट करें
  • INSTANA_BASE_URL: आपका Instana इंस्टेंस URL
  • INSTANA_API_TOKEN: आपका Instana API टोकन

चरण 2: VS Code में सर्वर प्रबंधित करें

  1. .vscode/mcp.json खोलें - आपको शीर्ष पर सर्वर प्रबंधन नियंत्रण दिखाई देंगे
  2. Instana MCP Server के बगल में Start पर क्लिक करें सर्वर शुरू करने के लिए
  3. उपकरणों की संख्या के साथ चलने की स्थिति इंगित करती है कि सर्वर चल रहा है

चरण 3: एकीकरण का परीक्षण करें

GitHub Copilot में Agent Mode पर स्विच करें और उपकरणों को पुनः लोड करें। यहां GitHub Copilot प्रतिक्रिया का एक उदाहरण है:

GitHub Copilot Response

Mistral AI

Mistral AI विशेष रूप से Streamable HTTP मोड के माध्यम से MCP एकीकरण का समर्थन करता है।

चरण 1: MCP सर्वर को Streamable HTTP मोड में लॉन्च करें

अपने Instana क्रेडेंशियल प्रदान करके MCP सर्वर को Streamable HTTP मोड में शुरू करें। निम्नलिखित कमांड चलाएं:

uv run src/core/server.py --transport streamable-http \
  --api-token "your_instana_api_token" \
  --base-url "https://your-instana-instance.instana.io" \
  --port 8080

चरण 2: Ngrok के साथ पोर्ट फ़ॉरवर्डिंग सेट करें

अपने स्थानीय सर्वर को उजागर करने के लिए पोर्ट फ़ॉरवर्डिंग कॉन्फ़िगर करें। विस्तृत निर्देशों के लिए Ngrok सेटअप दस्तावेज़ीकरण का पालन करें।

चरण 3: Mistral AI को कॉन्फ़िगर करें

  1. बाएं साइडबार में Intelligence टैब पर नेविगेट करें और Connectors चुनें Mistral HomePage

  2. Add Connector पर क्लिक करें Connector

  3. एक कनेक्टर नाम और Ngrok-फ़ॉरवर्डेड MCP सर्वर URL दर्ज करके एक कस्टम कनेक्टर बनाएं Custom Connector

  4. एक नया चैट सत्र शुरू करें और सत्यापित करें कि MCP उपकरण सक्षम हैं। आप प्रतिक्रिया यहां देख सकते हैं Testing MCP connection Response

एकाधिक Instana MCP सर्वरों से कनेक्ट करना

आप अपने MCP क्लाइंट को एकाधिक इंस्टेंस से कनेक्ट करने के लिए कॉन्फ़िगर कर सकते हैं। नीचे एक नमूना कॉन्फ़िगरेशन है:

{
  "mcpServers": {
    "Instana MCP Server1": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://0.0.0.0:8080/mcp/",
        "--allow-http",
        "--header",
        "instana-base-url: ENV1_INSTANA_URL",
        "--header",
        "instana-api-token: ENV1_INSTANA_API_TOKEN"
      ]
    },
    "Instana MCP Server2": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://0.0.0.0:8080/mcp/",
        "--allow-http",
        "--header",
        "instana-base-url: ENV2_INSTANA_URL",
        "--header",
        "instana-api-token: ENV2_INSTANA_API_TOKEN"
      ]
    }
  }
}

किसी विशिष्ट सर्वर को लक्षित करने के लिए, सुनिश्चित करें कि:

  • सर्वर MCP कॉन्फ़िगरेशन में उपयुक्त पर्यावरण नाम के साथ कॉन्फ़िगर किया गया है (जैसे Instana MCP Server1)
  • प्रॉम्प्ट स्पष्ट रूप से सर्वर/पर्यावरण नाम का उल्लेख करता है। अनुरोध तब संबंधित कॉन्फ़िगर किए गए सर्वर पर रूट किया जाएगा। यदि प्रॉम्प्ट में कोई सर्वर/वातावरण स्पष्ट रूप से उल्लिखित नहीं है, तो MCP कॉन्फ़िगरेशन में परिभाषित पहले सर्वर को डिफ़ॉल्ट सर्वर के रूप में उपयोग करता है।

नोट: यदि अनुरोधित सर्वर डाउन है या पहुंच योग्य नहीं है, तो MCP अपेक्षित व्यवहार करता है और API विफलता को आगे भेजता है। उपयोगकर्ता को API द्वारा लौटाई गई संबंधित त्रुटि प्राप्त होगी, जो दर्शाती है कि सर्वर अनुपलब्ध है। MCP अंतर्निहित API उपलब्धता पर निर्भर करता है और स्वचालित फेलओवर नहीं करता है।

समर्थित सुविधाएँ

  • एकीकृत एप्लिकेशन और इंफ्रास्ट्रक्चर प्रबंधन (manage_instana_resources)
    • एप्लिकेशन मेट्रिक्स
      • लचीले फ़िल्टरिंग के साथ एप्लिकेशन मेट्रिक्स क्वेरी करें
      • सेवाओं और एंडपॉइंट्स की सूची बनाएं
      • टैग द्वारा समूहीकरण और मेट्रिक्स एकत्रीकरण
    • एप्लिकेशन अलर्ट कॉन्फ़िगरेशन
      • सक्रिय अलर्ट कॉन्फ़िगरेशन खोजें
      • अलर्ट कॉन्फ़िगरेशन संस्करण प्राप्त करें
      • अलर्ट कॉन्फ़िगरेशन बनाएं, अपडेट करें और हटाएं
      • अलर्ट कॉन्फ़िगरेशन सक्षम, अक्षम और पुनर्स्थापित करें
      • ऐतिहासिक बेसलाइन अपडेट करें
    • वैश्विक एप्लिकेशन अलर्ट कॉन्फ़िगरेशन
      • वैश्विक अलर्ट कॉन्फ़िगरेशन प्रबंधित करें
      • वैश्विक अलर्ट के लिए संस्करण नियंत्रण
    • एप्लिकेशन सेटिंग्स
      • एप्लिकेशन परिप्रेक्ष्य प्रबंधित करें
      • एंडपॉइंट्स और सेवाएं कॉन्फ़िगर करें
      • मैन्युअल सेवाएं प्रबंधित करें
    • एप्लिकेशन कैटलॉग
      • एप्लिकेशन टैग कैटलॉग प्राप्त करें
      • एप्लिकेशन मेट्रिक कैटलॉग प्राप्त करें
  • इंफ्रास्ट्रक्चर प्रबंधन (manage_infrastructure)
    • analyze_infrastructure को प्रतिस्थापित करने वाला एकीकृत स्मार्ट राउटर — विश्लेषण, कैटलॉग और संसाधन स्नैपशॉट के लिए एकल उपकरण
    • get_plugin_schema — एक API कॉल में प्लगइन के लिए मेट्रिक्स और टैग प्राप्त करता है (दो अलग कॉल को प्रतिस्थापित करता है)
    • Instana API कैटलॉग से सभी इकाई प्रकारों के लिए गतिशील समर्थन (JVM, Kubernetes, Docker, होस्ट, डेटाबेस, संदेश कतारें, और अधिक)
    • स्थिर स्कीमा फ़ाइलें हटाई गईं — सभी स्कीमा Instana API से लाइव प्राप्त की जाती है
    • स्नैपशॉट संसाधन संचालन: get_snapshot, get_snapshots
    • लचीला मेट्रिक एकत्रीकरण (अधिकतम, माध्य, योग, आदि)
    • टैग और गुणों द्वारा उन्नत फ़िल्टरिंग
    • समूहीकरण और क्रमबद्ध करने की क्षमताएं
    • समय सीमा क्वेरी
  • एकीकृत इवेंट प्रबंधन (manage_events)
    • इवेंट निगरानी
      • ID द्वारा इवेंट प्राप्त करें (operation="get_event")
      • IDs द्वारा इवेंट प्राप्त करें (operation="get_events_by_ids")
      • एजेंट निगरानी इवेंट प्राप्त करें (operation="get_agent_monitoring_events")
      • Kubernetes जानकारी इवेंट प्राप्त करें (operation="get_kubernetes_info_events")
      • इवेंट प्राप्त करें (operation="get_events")
    • विशेष इवेंट उपकरणों के लिए स्मार्ट रूटिंग
    • एकीकृत पैरामीटर सत्यापन (समय सीमा, max_events)
    • प्राकृतिक भाषा समय सीमा के लिए समर्थन ("पिछले 24 घंटे", "पिछले 2 दिन")
    • इवेंट फ़िल्टरिंग और अनुकूलन
  • मोबाइल ऐप निगरानी (manage_mobile_apps)
    • सत्र प्लेबैक — नया (resource_type="session_replay")
      • get_session_replay_action_beacons — मोबाइल ऐप ID और सत्र ID द्वारा एक्शन बीकन की पृष्ठांकित पुनर्प्राप्ति
      • कर्सर-आधारित पृष्ठांकन (cursor, page_size, hasMore)
    • बीकन विश्लेषण, प्रदर्शन मेट्रिक्स, भौगोलिक और डिवाइस विश्लेषण, अलर्ट प्रबंधन (मौजूदा)
  • एकीकृत वेबसाइट प्रबंधन (manage_website_resources)
    • वेबसाइट विश्लेषण (resource_type="analyze")
      • वेबसाइट बीकन समूह प्राप्त करें - समूहीकृत/एकत्रित बीकन डेटा (operation="get_beacon_groups")
      • वेबसाइट बीकन प्राप्त करें - पृष्ठांकन के साथ व्यक्तिगत बीकन डेटा (operation="get_beacons")
      • स्वचालित टैग सत्यापन और कैटलॉग-आधारित प्राप्ति कार्यप्रवाह
      • प्रतिक्रिया सारांशीकरण (70-80% पेलोड कमी)
      • कई बीकन प्रकारों के लिए समर्थन: PAGELOAD, PAGECHANGE, RESOURCELOAD, CUSTOM, HTTPREQUEST, ERROR
    • वेबसाइट कैटलॉग (resource_type="catalog")
      • वेबसाइट मेट्रिक्स कैटलॉग प्राप्त करें (operation="get_metrics")
      • बीकन प्रकार और उपयोग मामले द्वारा वेबसाइट टैग कैटलॉग प्राप्त करें (operation="get_tag_catalog")
    • वेबसाइट कॉन्फ़िगरेशन (resource_type="configuration")
      • सभी वेबसाइट प्राप्त करें (operation="get_all")
      • स्वचालित नाम समाधान के साथ ID या नाम द्वारा वेबसाइट प्राप्त करें (operation="get")
    • उन्नत कॉन्फ़िगरेशन - केवल पढ़ने योग्य (resource_type="advanced_config")
      • भू-स्थान कॉन्फ़िगरेशन प्राप्त करें (operation="get_geo_config")
      • IP मास्किंग कॉन्फ़िगरेशन प्राप्त करें (operation="get_ip_masking")
      • भू मैपिंग नियम प्राप्त करें (operation="get_geo_rules")
  • एकीकृत स्वचालन प्रबंधन (manage_automation)
    • एक्शन कैटलॉग (resource_type="catalog")
      • सभी उपलब्ध स्वचालन एक्शन सूचीबद्ध करें (operation="get_actions")
      • किसी विशिष्ट एक्शन के बारे में विस्तृत जानकारी प्राप्त करें (operation="get_action_details")
      • नाम/विवरण द्वारा मेल खाने वाले एक्शन खोजें (operation="get_action_matches")
      • एप्लिकेशन या स्नैपशॉट ID और समय विंडो द्वारा एक्शन मैच प्राप्त करें (operation="get_action_matches_by_id_and_time_window")
      • उपलब्ध एक्शन प्रकार प्राप्त करें (operation="get_action_types")
      • उपलब्ध एक्शन टैग प्राप्त करें (operation="get_action_tags")
    • एक्शन इतिहास (resource_type="history")
      • फ़िल्टरिंग के साथ एक्शन निष्पादन उदाहरण सूचीबद्ध करें (operation="list")
      • किसी विशिष्ट एक्शन निष्पादन का विवरण प्राप्त करें (operation="get_details")
  • एकीकृत सिंथेटिक निगरानी (manage_synthetics)
    • सिंथेटिक कैटलॉग (resource_type="catalog")
      • क्वेरी योजना के लिए समर्थित एकत्रीकरण के साथ उपलब्ध मेट्रिक्स प्राप्त करें (operation="get_synthetic_catalog_metrics")
      • फ़िल्टरिंग, समूहीकरण और स्मार्ट अलर्ट के लिए मान्य टैग नाम प्राप्त करें (operation="get_synthetic_tag_catalog")
    • सिंथेटिक मेट्रिक्स (resource_type="metrics")
      • स्थान या परीक्षण नाम द्वारा समूहीकृत एकत्रित सिंथेटिक मेट्रिक्स पुनर्प्राप्त करें (operation="get_metrics_result")
    • सिंथेटिक सेटिंग्स (resource_type="settings")
      • ID या नाम द्वारा सिंथेटिक परीक्षण का पूर्ण कॉन्फ़िगरेशन प्राप्त करें (operation="get_synthetic_test")
      • एप्लिकेशन, स्थान या क्रेडेंशियल द्वारा वैकल्पिक फ़िल्टरिंग के साथ सिंथेटिक परीक्षण सूचीबद्ध करें (operation="get_synthetic_tests")
      • प्रकार, भू और क्षमता मेटाडेटा के साथ सभी निगरानी स्थान सूचीबद्ध करें (operation="get_locations")
      • स्वचालित नाम समाधान के साथ ID या नाम द्वारा एकल स्थान प्राप्त करें (operation="get_location_by_id")
      • ऑनलाइन गणना के साथ सभी डेटासेंटर (प्रबंधित) स्थान प्राप्त करें (operation="get_all_datacenters")
    • सिंथेटिक परीक्षण प्लेबैक (resource_type="test_playback")
      • प्रति परीक्षण एकत्रित प्लेबैक मेट्रिक्स प्राप्त करें (operation="get_synthetic_result")
      • LAST_VALUE विश्लेषण का उपयोग करके प्रति परीक्षण सबसे हालिया परिणाम प्राप्त करें (operation="get_synthetic_result_analytic")
      • कच्ची स्थिति, त्रुटियों और टाइमस्टैम्प के साथ व्यक्तिगत परीक्षण चलाने के परिणाम प्राप्त करें (operation="get_synthetic_result_list")
      • अंतिम चलने के समय और PoP संस्करण सहित स्थान-स्तरीय सारांश मेटाडेटा प्राप्त करें (operation="get_location_summary_list")
      • प्रति-स्थान विवरण के साथ प्रति-परीक्षण सफलता दर प्राप्त करें (operation="get_test_summary_list")
      • किसी विशिष्ट परीक्षण परिणाम के लिए उपलब्ध विवरण डेटा प्रकार प्राप्त करें (operation="get_synthetic_result_metadata")
      • लॉग, HAR या स्क्रीनशॉट जैसी विवरण डेटा फ़ाइल सामग्री प्राप्त करें (operation="get_synthetic_result_detail_data")
  • कस्टम डैशबोर्ड (manage_custom_dashboards)
    • सभी कस्टम डैशबोर्ड प्राप्त करें
    • ID द्वारा विशिष्ट डैशबोर्ड प्राप्त करें
    • नया कस्टम डैशबोर्ड बनाएं
    • मौजूदा कस्टम डैशबोर्ड अपडेट करें
    • कस्टम डैशबोर्ड हटाएं
    • डैशबोर्ड के लिए साझा करने योग्य उपयोगकर्ता प्राप्त करें
    • डैशबोर्ड के लिए साझा करने योग्य API टोकन प्राप्त करें

उपलब्ध उपकरण

उपकरणश्रेणीविवरण
manage_applicationsएप्लिकेशन और इंफ्रास्ट्रक्चरएप्लिकेशन मेट्रिक्स, अलर्ट कॉन्फ़िग, सेटिंग्स और कैटलॉग प्रबंधित करने के लिए एकीकृत उपकरण
manage_websitesवेबसाइट निगरानीवेबसाइट विश्लेषण, कैटलॉग, कॉन्फ़िगरेशन और उन्नत कॉन्फ़िग संचालन के लिए एकीकृत स्मार्ट राउटर
manage_custom_dashboardsकस्टम डैशबोर्डकस्टम डैशबोर्ड CRUD संचालन प्रबंधित करने के लिए एकीकृत उपकरण
manage_infrastructureइंफ्रास्ट्रक्चरइंफ्रास्ट्रक्चर विश्लेषण, कैटलॉग (get_plugin_schema) और स्नैपशॉट संसाधन संचालन के लिए एकीकृत स्मार्ट राउटर
manage_automationस्वचालनस्वचालन के लिए एकीकृत स्मार्ट राउटर: एक्शन कैटलॉग ब्राउज़ करें और निष्पादन इतिहास देखें
manage_eventsइवेंटइवेंट निगरानी के लिए एकीकृत स्मार्ट राउटर: ID द्वारा इवेंट प्राप्त करें, IDs द्वारा इवेंट प्राप्त करें, Kubernetes इवेंट, एजेंट निगरानी इवेंट और सभी इवेंट
manage_sloSLO प्रबंधनबुद्धिमान समयक्षेत्र हैंडलिंग के साथ SLO कॉन्फ़िगरेशन, रिपोर्ट, अलर्ट और सुधार विंडो के लिए एकीकृत स्मार्ट राउटर
manage_releasesरिलीज़ प्रबंधनरिलीज़ ट्रैकिंग के लिए एकीकृत स्मार्ट राउटर: पृष्ठांकन और नाम फ़िल्टरिंग के साथ रिलीज़ सूचीबद्ध करें, रिलीज़ विवरण प्राप्त करें, समयक्षेत्र समर्थन के साथ रिलीज़ बनाएं/अपडेट करें/हटाएं
manage_maintenance_windowsरखरखाव विंडोरखरखाव विंडो जीवनचक्र प्रबंधन के लिए एकीकृत स्मार्ट राउटर: टेम्पलेट समर्थन और ServiceNow एकीकरण के साथ रखरखाव विंडो बनाएं, संशोधित करें, बंद करें और सूचीबद्ध करें
manage_mobile_appsमोबाइल ऐप निगरानीमोबाइल ऐप निगरानी के लिए एकीकृत स्मार्ट राउटर: बीकन विश्लेषण, प्रदर्शन मेट्रिक्स, सत्र प्लेबैक, कॉन्फ़िगरेशन और अलर्ट प्रबंधन
manage_syntheticsसिंथेटिक निगरानीसिंथेटिक निगरानी के लिए एकीकृत स्मार्ट राउटर: कैटलॉग, मेट्रिक्स, सेटिंग्स (केवल पढ़ने योग्य) और परीक्षण प्लेबैक परिणाम

👉 विस्तृत उपकरण दस्तावेज़ीकरण, क्षमताओं और तकनीकी संदर्भ के लिए, Tools & Examples देखें

उपकरण फ़िल्टरिंग

MCP सर्वर प्रदर्शन को अनुकूलित करने और संसाधन उपयोग को कम करने के लिए चयनात्मक उपकरण लोडिंग का समर्थन करता है। आप अपने विशिष्ट उपयोग मामले के लिए केवल आवश्यक उपकरण श्रेणियां सक्षम कर सकते हैं।

उपलब्ध उपकरण श्रेणियां

  • router: एकीकृत एप्लिकेशन और इंफ्रास्ट्रक्चर प्रबंधन

    • manage_instana_resources: एप्लिकेशन मेट्रिक्स, अलर्ट कॉन्फ़िगरेशन, सेटिंग्स और कैटलॉग के लिए एकल उपकरण
    • एप्लिकेशन परिप्रेक्ष्य, एंडपॉइंट्स, सेवाओं और मैन्युअल सेवाओं का समर्थन करता है
    • एप्लिकेशन-विशिष्ट और वैश्विक अलर्ट कॉन्फ़िगरेशन दोनों प्रबंधित करता है
    • एप्लिकेशन टैग कैटलॉग और मेट्रिक कैटलॉग तक पहुंच प्रदान करता है

  • dashboard: कस्टम डैशबोर्ड प्रबंधन

    • manage_custom_dashboards: कस्टम डैशबोर्ड के लिए CRUD संचालन
    • डैशबोर्ड निर्माण, पुनर्प्राप्ति, अपडेट और विलोपन का समर्थन करता है
    • डैशबोर्ड के लिए साझा करने योग्य उपयोगकर्ता और API टोकन प्रबंधित करता है

  • infra: इंफ्रास्ट्रक्चर प्रबंधन उपकरण

    • manage_infrastructure: इंफ्रास्ट्रक्चर विश्लेषण, कैटलॉग और स्नैपशॉट संसाधन संचालन के लिए एकीकृत स्मार्ट राउटर
    • get_plugin_schema एकल API कॉल में get_metrics + get_tag_catalog को जोड़ता है
    • आपके Instana इंस्टॉलेशन में उपलब्ध सभी इकाई प्रकारों का गतिशील रूप से समर्थन करता है (API कैटलॉग से स्वचालित रूप से लोड किया गया)
    • JVM, Kubernetes, Docker, होस्ट, डेटाबेस, संदेश कतारें, और कोई भी कस्टम या नई जोड़ी गई इकाई प्रकार शामिल हैं
    • लचीला मेट्रिक एकत्रीकरण, फ़िल्टरिंग, समूहीकरण और समय सीमा क्वेरी

  • automation: स्वचालन क्रिया उपकरण

    • manage_automation: स्वचालन कैटलॉग और निष्पादन इतिहास के लिए एकीकृत स्मार्ट राउटर
    • क्रिया कैटलॉग: क्रियाओं को ब्राउज़ करें, विवरण प्राप्त करें, नाम/विवरण द्वारा खोजें, एप्लिकेशन या स्नैपशॉट आईडी द्वारा फ़िल्टर करें
    • क्रिया इतिहास: फ़िल्टरिंग के साथ निष्पादन उदाहरणों की सूची बनाएं, निष्पादन विवरण प्राप्त करें

  • events: इवेंट निगरानी उपकरण

    • इवेंट्स: Kubernetes इवेंट्स, एजेंट निगरानी और सिस्टम इवेंट ट्रैकिंग

  • website: वेबसाइट निगरानी उपकरण

    • वेबसाइट मेट्रिक्स: वेबसाइटों के लिए प्रदर्शन मापन
    • वेबसाइट कैटलॉग: वेबसाइट मेटाडेटा और परिभाषाएँ
    • वेबसाइट विश्लेषण: वेबसाइट प्रदर्शन विश्लेषण
    • वेबसाइट कॉन्फ़िगरेशन: वेबसाइट कॉन्फ़िगरेशन प्रबंधन

  • slo: सेवा स्तर उद्देश्य (SLO) प्रबंधन

    • manage_slo: व्यापक SLO संचालन के लिए एकीकृत स्मार्ट राउटर
    • कॉन्फ़िगरेशन प्रबंधन: समय-आधारित और इवेंट-आधारित संकेतकों के समर्थन के साथ SLO कॉन्फ़िगरेशन बनाएं, पढ़ें, अपडेट करें, हटाएं
    • रिपोर्ट निर्माण: SLI मानों, त्रुटि बजट, बर्न दरों और समय-श्रृंखला चार्ट के साथ विस्तृत SLO रिपोर्ट तैयार करें
    • अलर्ट कॉन्फ़िगरेशन: त्रुटि बजट निगरानी और बर्न दर ट्रैकिंग के लिए SLO अलर्ट कॉन्फ़िगरेशन प्रबंधित करें
    • सुधार विंडो: SLO गणनाओं से नियोजित डाउनटाइम को बाहर करने के लिए रखरखाव विंडो बनाएं और प्रबंधित करें
    • बुद्धिमान समयक्षेत्र हैंडलिंग: सटीक समय संदर्भ सुनिश्चित करने के लिए datetime इनपुट के लिए स्वचालित समयक्षेत्र निष्कर्षण
    • दो-चरणीय निष्कर्षण: कई इनपुट की आवश्यकता वाले जटिल संचालन के लिए इंटरैक्टिव पैरामीटर संग्रह

  • releases: रिलीज़ ट्रैकिंग और डिप्लॉयमेंट प्रबंधन

    • manage_releases: रिलीज़ संचालन के लिए एकीकृत स्मार्ट राउटर
    • रिलीज़ सूची: कुशल पेजिनेशन (page_number, page_size) और नाम-आधारित फ़िल्टरिंग के साथ सभी रिलीज़ प्राप्त करें
    • रिलीज़ विवरण: एप्लिकेशन, सेवाओं और स्कोप सहित आईडी द्वारा विशिष्ट रिलीज़ जानकारी प्राप्त करें
    • बनाएं/अपडेट करें/हटाएं: रिलीज़ प्रबंधन के लिए पूर्ण CRUD संचालन
    • बुद्धिमान समयक्षेत्र हैंडलिंग: रिलीज़ प्रारंभ समय के लिए स्वचालित समयक्षेत्र निष्कर्षण
    • कुशल पेजिनेशन: उचित पृष्ठ-आधारित नेविगेशन के साथ अनावश्यक डेटा प्राप्ति से बचें
    • नाम फ़िल्टरिंग: नाम से रिलीज़ खोजने के लिए केस-असंवेदनशील सबस्ट्रिंग मिलान

  • maintenance_window: रखरखाव विंडो जीवनचक्र प्रबंधन

    • manage_maintenance_windows: रखरखाव विंडो संचालन के लिए एकीकृत स्मार्ट राउटर
    • विंडो संचालन: रखरखाव विंडो बनाएं, संशोधित करें, बंद करें और सूचीबद्ध करें (सक्रिय, निर्धारित, सभी, समाप्त)
    • बल्क संचालन: एक साथ कई एप्लिकेशनों के लिए रखरखाव विंडो बनाएं
    • टेम्पलेट समर्थन: सामान्य परिदृश्यों के लिए पूर्वनिर्धारित टेम्पलेट (डिप्लॉयमेंट, database_migration, infrastructure_upgrade, emergency, routine)
    • आवर्ती विंडो: RFC 5545 RRULE प्रारूप का उपयोग करके आवर्ती रखरखाव विंडो के लिए समर्थन
    • ServiceNow एकीकरण: ServiceNow परिवर्तन अनुरोधों के साथ वैकल्पिक एकीकरण
    • सत्यापन: विंडो निर्माण से पहले पैरामीटर सत्यापन
    • लचीली अवधि: मिनटों, घंटों या दिनों में अवधि निर्दिष्ट करें

  • mobile_app: मोबाइल एप्लिकेशन निगरानी

    • manage_mobile_apps: मोबाइल ऐप निगरानी संचालन के लिए एकीकृत स्मार्ट राउटर
    • सत्र रीप्ले: मोबाइल ऐप आईडी और सत्र आईडी द्वारा पेजिनेटेड सत्र रीप्ले एक्शन बीकन प्राप्त करें (resource_type="session_replay")
    • बीकन विश्लेषण: समूहीकरण और फ़िल्टरिंग के साथ मोबाइल ऐप बीकन डेटा क्वेरी करें
    • प्रदर्शन मेट्रिक्स: सत्र अवधि, क्रैश दर और HTTP अनुरोध प्रदर्शन ट्रैक करें
    • भौगोलिक विश्लेषण: देश, शहर और क्षेत्र द्वारा उपयोगकर्ता वितरण का विश्लेषण करें
    • डिवाइस विश्लेषण: विभिन्न डिवाइसों, प्लेटफार्मों और OS संस्करणों में प्रदर्शन की निगरानी करें
    • कॉन्फ़िगरेशन प्रबंधन: मोबाइल ऐप कॉन्फ़िगरेशन, जियो-लोकेशन और IP मास्किंग सेटिंग्स प्रबंधित करें
    • अलर्ट प्रबंधन: मोबाइल ऐप अलर्ट कॉन्फ़िगरेशन कॉन्फ़िगर और प्रबंधित करें

  • synthetics: सिंथेटिक निगरानी प्रबंधन

    • manage_synthetics: सभी सिंथेटिक निगरानी संचालन के लिए एकीकृत स्मार्ट राउटर
    • कैटलॉग: क्वेरी बनाने से पहले मान्य मेट्रिक आईडी और टैग नाम खोजें
    • मेट्रिक्स: स्थान या परीक्षण नाम द्वारा समूहीकृत समग्र प्रतिक्रिया समय और सफलता दर प्राप्त करें
    • सेटिंग्स: स्वचालित नाम समाधान के साथ परीक्षण और स्थान सूचीबद्ध करें और देखें; डेटासेंटर (प्रबंधित) बनाम स्व-होस्टेड (निजी) PoP की पहचान करें
    • परीक्षण प्लेबैक: प्रति-रन कच्चे परिणाम, LAST_VALUE विश्लेषण, प्रति-स्थान सफलता दर सारांश, और विवरण फ़ाइल डाउनलोड (LOGS, HAR, स्क्रीनशॉट)

उपयोग उदाहरण

CLI का उपयोग करना (PyPI इंस्टॉलेशन)

# Enable only router (unified app/infra management) and events tools
mcp-instana --tools router,events --transport streamable-http

# Enable only infrastructure analysis tools
mcp-instana --tools infra --transport streamable-http

# Enable router and infrastructure analysis
mcp-instana --tools router,infra --transport streamable-http

# Enable events and website tools
mcp-instana --tools events,website --transport streamable-http

# Enable dashboard and router tools
mcp-instana --tools dashboard,router --transport streamable-http

# Enable releases and events tools
mcp-instana --tools releases,events --transport streamable-http

# Enable maintenance window and events tools
mcp-instana --tools maintenance_window,events --transport streamable-http

# Enable all tools (default behavior)
mcp-instana --transport streamable-http

# List all available tool categories and their tools
mcp-instana --list-tools

डेवलपमेंट इंस्टॉलेशन का उपयोग करना

# Enable only router (unified app/infra management) and events tools
uv run src/core/server.py --tools router,events --transport streamable-http

# Enable only infrastructure analysis tools
uv run src/core/server.py --tools infra --transport streamable-http

# Enable router and infrastructure analysis
uv run src/core/server.py --tools router,infra --transport streamable-http

# Enable events and website tools
uv run src/core/server.py --tools events,website --transport streamable-http

# Enable dashboard and router tools
uv run src/core/server.py --tools dashboard,router --transport streamable-http

# Enable releases and events tools
uv run src/core/server.py --tools releases,events --transport streamable-http

# Enable maintenance window and events tools
uv run src/core/server.py --tools maintenance_window,events --transport streamable-http

# Enable all tools (default behavior)
uv run src/core/server.py --transport streamable-http

# List all available tool categories and their tools
uv run src/core/server.py --list-tools

टूल फ़िल्टरिंग के लाभ

  • प्रदर्शन: कम स्टार्टअप समय और मेमोरी उपयोग
  • सुरक्षा: केवल आवश्यक API तक पहुंच सीमित करें
  • स्पष्टता: विशिष्ट उपयोग मामलों पर ध्यान केंद्रित करें (जैसे, केवल इंफ्रास्ट्रक्चर निगरानी)
  • संसाधन दक्षता: कम CPU और नेटवर्क उपयोग

👉 उपयोग उदाहरणों और प्रॉम्प्ट के लिए, उदाहरण प्रॉम्प्ट देखें

Docker डिप्लॉयमेंट

MCP Instana सर्वर को उत्पादन वातावरण के लिए Docker का उपयोग करके डिप्लॉय किया जा सकता है। Docker सेटअप सुरक्षा, प्रदर्शन और न्यूनतम संसाधन उपयोग के लिए अनुकूलित है।

Docker इमेज बनाना

पूर्वापेक्षाएँ

  • Docker स्थापित और चालू
  • प्रोजेक्ट स्रोत कोड तक पहुंच

बिल्ड और रन

# Build the image
docker build -t mcp-instana:latest .

# Build with a specific tag
docker build -t mcp-instana:<image_tag> .

# Run the container (credentials are supplied via HTTP headers at request time)
docker run -p 8080:8080 mcp-instana

# Run with a custom host port
docker run -p 8081:8080 mcp-instana

📖 मल्टी-आर्किटेक्चर बिल्ड, .dockerignore, सुरक्षा सर्वोत्तम अभ्यास और उत्पादन डिप्लॉयमेंट उदाहरणों सहित व्यापक Docker दस्तावेज़ीकरण के लिए, DOCKER.md देखें।

समस्या निवारण

Docker समस्याएँ

कंटेनर प्रारंभ नहीं हो रहा

# Check container logs
docker logs <container_id>
# Common issues:
# 1. Port already in use
# 2. Invalid container image
# 3. Missing dependencies
# Credentials are passed via HTTP headers from the MCP client

कनेक्शन समस्याएँ

# Test container connectivity (expects 406 from a bare GET — means server is up)
curl http://localhost:8080/mcp
# Check port mapping
docker port <container_id>

प्रदर्शन समस्याएँ

# Check container resource usage
docker stats <container_id>
# Monitor container health
docker inspect <container_id> | grep -A 10 Health

सामान्य समस्याएँ

  • GitHub Copilot

    • यदि आपको GitHub Copilot के साथ समस्याएँ आती हैं, तो mcp.json फ़ाइल में सर्वर को प्रारंभ/बंद/पुनः प्रारंभ करने का प्रयास करें और एक समय में केवल एक सर्वर चालू रखें।

  • प्रमाणपत्र समस्याएँ

    • यदि आपको प्रमाणपत्र समस्याएँ आती हैं, जैसे [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate:
      • जांचें कि आप SSL सत्यापन के साथ curl या wget का उपयोग करके Instana API एंडपॉइंट तक पहुंच सकते हैं।
        • यदि यह काम करता है, तो आपका Python वातावरण प्रमाणपत्र सत्यापित करने में सक्षम नहीं हो सकता है और आपके शेल या सिस्टम के समान प्रमाणपत्रों तक पहुंच नहीं हो सकती है। सुनिश्चित करें कि आपका Python वातावरण सिस्टम प्रमाणपत्रों का उपयोग करता है (macOS)। आप Python में प्रमाणपत्र स्थापित करके ऐसा कर सकते हैं: /Applications/Python\ 3.13/Install\ Certificates.command
      • यदि आप SSL सत्यापन के साथ एंडपॉइंट तक नहीं पहुंच सकते हैं, तो इसके बिना प्रयास करें। यदि यह काम करता है, तो अपने सिस्टम के CA प्रमाणपत्रों की जांच करें और सुनिश्चित करें कि वे अद्यतित हैं।