IBM Instana MCP Server

ทางการ

เซิร์ฟเวอร์ IBM Instana MCP ช่วยให้สามารถโต้ตอบกับแพลตฟอร์มการสังเกตการณ์ IBM Instana ได้อย่างราบรื่น ช่วยให้คุณเข้าถึงข้อมูลการสังเกตการณ์แบบเรียลไทม์ได้โดยตรงภายในขั้นตอนการทำงานพัฒนาของคุณ

GitHub

ลองใช้ MCP นี้ผู้สนับสนุน

คุณทำอะไรได้บ้างด้วย IBM Instana MCP?

สอบถามประสิทธิภาพแอปพลิเคชัน — ขอข้อมูลเมตริกของแอปพลิเคชัน การแจ้งเตือน หรือรายละเอียดแคตตาล็อกโดยใช้เครื่องมือหมวดหมู่ app เช่น get_app_metrics หรือ get_app_alerts
ตรวจสอบสุขภาพโครงสร้างพื้นฐาน — ดึงข้อมูลทรัพยากรโครงสร้างพื้นฐาน โทโพโลยี และเมตริกผ่านเครื่องมือ infra เช่น get_infra_metrics หรือ get_infra_topology
ติดตามเหตุการณ์และอุบัติการณ์ — เข้าถึงเหตุการณ์ Kubernetes หรือข้อมูลการตรวจสอบเอเจนต์ด้วยเครื่องมือ events เช่น get_k8s_events หรือ get_agent_status
วิเคราะห์การตรวจสอบเว็บไซต์ — ดึงข้อมูลเมตริกเว็บไซต์ ข้อมูลแคตตาล็อก หรือการกำหนดค่าโดยใช้เครื่องมือ website เช่น get_website_metrics หรือ get_website_config
กรองเครื่องมือตามหมวดหมู่ — เปิดใช้งานเฉพาะหมวดหมู่เครื่องมือที่จำเป็นเมื่อเริ่มต้นด้วยแฟล็ก --tools (เช่น --tools infra,events) เพื่อเพิ่มประสิทธิภาพ

เอกสาร

สารบัญ

MCP Server สำหรับ IBM Instana

MCP Server สำหรับ IBM Instana

📚 ลิงก์ด่วน

เครื่องมือและตัวอย่าง - เอกสารเครื่องมือที่ครอบคลุมพร้อมตัวอย่างการใช้งานจริง
นโยบายความเป็นส่วนตัว - ข้อมูลการจัดการข้อมูลและความเป็นส่วนตัว
คู่มือการปรับใช้ด้วย Docker - คู่มือการปรับใช้ Docker ที่ครอบคลุม การสร้างแบบหลายสถาปัตยกรรม และการตั้งค่าสำหรับการผลิต

MCP Server ของ Instana ช่วยให้การโต้ตอบกับแพลตฟอร์ม Instana observability เป็นไปอย่างราบรื่น ช่วยให้คุณเข้าถึงข้อมูล observability แบบเรียลไทม์ได้โดยตรงภายในขั้นตอนการทำงานการพัฒนาของคุณ

มันทำหน้าที่เป็นสะพานเชื่อมระหว่างไคลเอนต์ (เช่น AI agents หรือเครื่องมือที่กำหนดเอง) และ Instana REST APIs โดยแปลงคำขอของผู้ใช้เป็นคำขอ Instana API และจัดรูปแบบการตอบกลับให้เป็นโครงสร้างที่อ่านและใช้งานได้ง่าย

Server รองรับทั้งโหมดการส่งข้อมูล Streamable HTTP และ Stdio เพื่อความเข้ากันได้สูงสุดกับ MCP clients ต่างๆ สำหรับรายละเอียดเพิ่มเติม โปรดดู ข้อกำหนดโหมดการส่งข้อมูล 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 Host (เช่น Claude Desktop, VS Code หรือไคลเอนต์อื่นๆ) ที่เชื่อมต่อกับ Instana MCP Server เมื่อคุณขอข้อมูลเกี่ยวกับการแจ้งเตือนของ Instana กระบวนการต่อไปนี้จะเกิดขึ้น:

MCP client ดึงรายการเครื่องมือที่มีอยู่จาก Instana MCP server
คำขอของคุณถูกส่งไปยัง LLM พร้อมกับคำอธิบายเครื่องมือ
LLM วิเคราะห์เครื่องมือที่มีอยู่และเลือกเครื่องมือที่เหมาะสมสำหรับการดึงข้อมูลการแจ้งเตือนของ Instana
ไคลเอนต์ดำเนินการเครื่องมือที่เลือกผ่าน Instana MCP server
ผลลัพธ์ (การแจ้งเตือนล่าสุด) จะถูกส่งกลับไปยัง LLM
LLM สร้างการตอบกลับเป็นภาษาธรรมชาติ
การตอบกลับจะแสดงให้คุณเห็น

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

หลังการติดตั้ง คุณสามารถรัน server ได้โดยใช้คำสั่ง mcp-instana โดยตรง

ตัวเลือก 2: การติดตั้งสำหรับการพัฒนา

สำหรับการพัฒนาหรือการปรับแต่งในเครื่อง คุณสามารถ clone และตั้งค่าโปรเจกต์ในเครื่องได้

การติดตั้ง uv

โปรเจกต์นี้ใช้ uv ซึ่งเป็นตัวติดตั้งและตัวแก้ไขแพ็กเกจ Python ที่รวดเร็ว ในการติดตั้ง uv คุณมีหลายตัวเลือก:

การใช้ pip:

pip install uv

การใช้ Homebrew (macOS):

brew install uv

สำหรับตัวเลือกการติดตั้งเพิ่มเติมและคำแนะนำโดยละเอียด โปรดเยี่ยมชม เอกสาร uv

การตั้งค่าสภาพแวดล้อม

หลังจากติดตั้ง uv แล้ว ให้ตั้งค่าสภาพแวดล้อมของโปรเจกต์โดยรัน:

uv sync

การตรวจสอบสิทธิ์แบบใช้ Header สำหรับโหมด Streamable HTTP

เมื่อใช้ โหมด Streamable HTTP คุณต้องส่งข้อมูลประจำตัวของ Instana ผ่าน HTTP headers วิธีนี้ช่วยเพิ่มความปลอดภัยและความยืดหยุ่นโดย:

หลีกเลี่ยงการจัดเก็บข้อมูลประจำตัวในตัวแปรสภาพแวดล้อม
รองรับการใช้ข้อมูลประจำตัวที่แตกต่างกันสำหรับคำขอที่แตกต่างกัน
รองรับสภาพแวดล้อมที่ใช้ร่วมกันซึ่งการแก้ไขตัวแปรสภาพแวดล้อมถูกจำกัด
รองรับทั้งการตรวจสอบสิทธิ์แบบ API token และแบบ session

โหมดการตรวจสอบสิทธิ์ที่รองรับ:

1. การตรวจสอบสิทธิ์ด้วย API Token (การเรียก API โดยตรง)

Headers ที่จำเป็น:

instana-base-url: URL ของอินสแตนซ์ Instana ของคุณ
instana-api-token: API token ของ Instana ของคุณ

ตัวอย่าง:

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

2. การตรวจสอบสิทธิ์ด้วย Session Token (การเรียกจาก UI)

Headers ที่จำเป็น:

instana-base-url: URL ของอินสแตนซ์ Instana ของคุณ
instana-auth-token: โทเค็นการตรวจสอบสิทธิ์เซสชันจาก backend ของ UI
instana-csrf-token: CSRF token จาก backend ของ UI
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 Token (การเชื่อมต่อกับ IBM Platform)

Headers ที่จำเป็น:

instana-base-url: URL ของอินสแตนซ์ Instana ของคุณ
instana-jwt-token: JWT token จาก IBM Platform
instana-csrf-token: CSRF token สำหรับการตรวจสอบคำขอ

ตัวอย่างการกำหนดค่า:

{
  "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"
      ]
    }
  }
}

ลำดับความสำคัญของการตรวจสอบสิทธิ์:

JWT Token (หากระบุพร้อมกับ CSRF token) - มีลำดับความสำคัญสูงสุดสำหรับการเชื่อมต่อกับ IBM Platform
Session Tokens (หากระบุทั้ง auth_token และ csrf_token)
API Token (หากระบุ) - การตรวจสอบสิทธิ์มาตรฐาน
ตัวแปรสภาพแวดล้อม (INSTANA_API_TOKEN) - ทางเลือกสำรอง

ขั้นตอนการตรวจสอบสิทธิ์:

ต้องมี HTTP headers ในทุกคำขอ
Server ตรวจสอบข้อมูลประจำตัวตามลำดับความสำคัญ
คำขอที่ไม่มีการตรวจสอบสิทธิ์ที่ถูกต้องจะล้มเหลว

การออกแบบนี้ช่วยให้การส่งข้อมูลประจำตัวปลอดภัยและรองรับขั้นตอนการตรวจสอบสิทธิ์หลายรูปแบบ รวมถึงการเรียกจาก UI ผ่าน WebSocket → Coordinator → MCP Server

ตรวจสอบให้แน่ใจว่าโทเค็นที่ใช้มีสิทธิ์ที่จำเป็นในการเรียกใช้เครื่องมือ MCP ดูข้อมูลเพิ่มเติม ที่นี่

การเริ่ม MCP Server ในเครื่อง

ก่อนกำหนดค่า MCP client ใดๆ (Claude Desktop, GitHub Copilot หรือ MCP clients ที่กำหนดเอง) คุณต้องเริ่ม MCP server ในเครื่องก่อน Server รองรับโหมดการส่งข้อมูลสองโหมด: Streamable HTTP และ Stdio

ตัวเลือกคำสั่งของ Server

การใช้ CLI (การติดตั้งจาก PyPI)

หากคุณติดตั้ง mcp-instana จาก PyPI ให้ใช้คำสั่ง 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) การเปิดใช้งานหมวดหมู่จะเปิดใช้งาน prompts ที่เกี่ยวข้องด้วย ตัวอย่างเช่น: --tools infra เปิดใช้งานเครื่องมือ infra และ prompts ที่เกี่ยวข้องกับ infra ทั้งหมด
--list-tools: แสดงรายการหมวดหมู่เครื่องมือที่มีทั้งหมดและออกจากโปรแกรม
--port <port>: พอร์ตของ MCP server (ค่าเริ่มต้น: 8080 สามารถแทนที่ได้ด้วยตัวแปรสภาพแวดล้อม PORT)
--verify-ssl: เปิดใช้งานการตรวจสอบใบรับรอง SSL สำหรับการเรียก Instana API ขาออก เทียบเท่ากับการตั้งค่า INSTANA_SSL_VERIFY=true การตรวจสอบ SSL ถูกปิดใช้งานโดยค่าเริ่มต้น
--help: แสดงข้อความช่วยเหลือและออกจากโปรแกรม

การเริ่มในโหมด Streamable HTTP

โหมด Streamable 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

คุณสมบัติหลักของโหมด Streamable HTTP:

ใช้ HTTP headers สำหรับการตรวจสอบสิทธิ์ (ไม่จำเป็นต้องใช้ตัวแปรสภาพแวดล้อม)
รองรับข้อมูลประจำตัวที่แตกต่างกันต่อคำขอ
เหมาะสำหรับสภาพแวดล้อมที่ใช้ร่วมกัน
พอร์ตเริ่มต้นของ MCP server: 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 client บางรูปแบบ
แฟล็ก --env เป็นวิธีที่สะดวกในการตั้งค่าข้อมูลประจำตัวโดยไม่ต้องแก้ไขสภาพแวดล้อมของเชลล์

หมวดหมู่เครื่องมือ

คุณสามารถปรับประสิทธิภาพของ server ได้โดยการเปิดใช้งานเฉพาะหมวดหมู่เครื่องมือและ prompts ที่คุณต้องการ:

การใช้ 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: เครื่องมือและ prompts สำหรับการตรวจสอบโครงสร้างพื้นฐาน (resources, catalog, topology, analyze, metrics)
app: เครื่องมือและ prompts สำหรับประสิทธิภาพแอปพลิเคชัน (resources, metrics, alerts, catalog, topology, analyze, settings, global alerts)
events: เครื่องมือและ prompts สำหรับการตรวจสอบเหตุการณ์ (Kubernetes events, agent monitoring)
website: เครื่องมือและ prompts สำหรับการตรวจสอบเว็บไซต์ (metrics, catalog, analyze, configuration)

การตรวจสอบใบรับรอง SSL

การตรวจสอบใบรับรอง SSL สำหรับการเรียก Instana API ขาออก ถูกปิดใช้งานโดยค่าเริ่มต้น สิ่งนี้ใช้กับทั้งโหมด Streamable HTTP และ Stdio

เพื่อเปิดใช้งานการตรวจสอบใบรับรอง SSL ให้ใช้ตัวเลือก CLI --verify-ssl หรือตัวแปรสภาพแวดล้อม 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: เซิร์ฟเวอร์จะเริ่มต้นและรออินพุตจาก stdin จาก MCP clients

ปัญหาการเริ่มต้นที่พบบ่อย

ปัญหา 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

ขาด dependencies: ตรวจสอบให้แน่ใจว่าติดตั้ง dependencies ทั้งหมดแล้ว:

uv sync

การติดตั้งและการใช้งาน

Bob IDE

Bob เป็น IDE ที่ขับเคลื่อนด้วย AI ของ IBM ที่รองรับการรวม MCP โดยกำเนิด Bob มอบประสบการณ์การพัฒนาที่ราบรื่นด้วยความช่วยเหลือ AI ในตัวและเครื่องมือสังเกตการณ์

โหมด Streamable HTTP

โหมด Streamable HTTP ให้อินเทอร์เฟซ REST API สำหรับการสื่อสาร MCP โดยใช้ JSON-RPC ผ่าน HTTP

ขั้นตอนที่ 1: เริ่ม MCP Server ในโหมด Streamable HTTP

ก่อนกำหนดค่า Bob คุณต้องเริ่ม MCP server ในโหมด Streamable HTTP โปรดดูส่วน การเริ่ม MCP Server ในเครื่อง สำหรับคำแนะนำโดยละเอียด

ขั้นตอนที่ 2: กำหนดค่า Bob

ที่มุมขวาบนของแผง Bob คุณจะเห็นเมนูแบบเลื่อนลงพร้อม MCP servers:

เมื่อเลือกสิ่งนี้ คุณควรเห็นตัวเลือกในการกำหนดค่า MCP ในระดับโปรเจกต์หรือระดับโกลบอล

ขอบเขตการกำหนดค่า MCP

Bob รองรับการกำหนดค่า MCP สองระดับ ช่วยให้คุณเลือกขอบเขตที่เหมาะสมกับกรณีการใช้งานของคุณ:

1. การกำหนดค่าโกลบอล (ระดับผู้ใช้)

การกำหนดค่าโกลบอลใช้ MCP servers กับทุกโปรเจกต์ของผู้ใช้ปัจจุบัน เหมาะสำหรับเมื่อคุณต้องการให้ MCP servers เดียวกันพร้อมใช้งานในทุกโปรเจกต์ที่คุณทำงาน

ตำแหน่งไฟล์:

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

2. การกำหนดค่าโปรเจกต์ (ระดับโปรเจกต์)

การกำหนดค่าโปรเจกต์ใช้ MCP servers กับโปรเจกต์เฉพาะเท่านั้น มีประโยชน์เมื่อโปรเจกต์ต่างกันต้องการการกำหนดค่า MCP ที่แตกต่างกัน หรือเมื่อคุณต้องการแชร์การตั้งค่า MCP กับทีมผ่านระบบควบคุมเวอร์ชัน

ตำแหน่งไฟล์:

.bob/bob_config.json ในไดเรกทอรีรากของโปรเจกต์ของคุณ

การเลือกระหว่างการกำหนดค่าโกลบอลและโปรเจกต์:

ใช้ การกำหนดค่าโกลบอล สำหรับ MCP servers ที่คุณต้องการให้พร้อมใช้งานในทุกโปรเจกต์
ใช้ การกำหนดค่าโปรเจกต์ สำหรับ MCP servers เฉพาะโปรเจกต์หรือเพื่อแชร์การกำหนดค่ากับทีม
การกำหนดค่าทั้งสองสามารถอยู่ร่วมกันได้ - การตั้งค่าระดับโปรเจกต์จะมีความสำคัญเหนือกว่าการตั้งค่าระดับโกลบอลสำหรับชื่อเซิร์ฟเวอร์เดียวกัน

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับ Bob และการกำหนดค่า MCP เยี่ยมชม: https://bob.ibm.com/docs/ide/configuration/mcp/mcp-in-bob

การกำหนดค่าในเครื่อง:

กำหนดค่า Bob เพื่อเชื่อมต่อกับ Instana MCP server ในเครื่องของคุณ:

{
  "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"
      ]
    }
  }
}

การกำหนดค่าระยะไกล:

กำหนดค่า Bob เพื่อเชื่อมต่อกับ Instana MCP server ระยะไกล (เช่น ปรับใช้บน IBM Code Engine):

{
  "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 server ที่กำหนดค่าใหม่ควรปรากฏเป็นเปิดใช้งาน จุดสีเขียวบ่งบอกว่าเซิร์ฟเวอร์ทำงานสำเร็จ

ตอนนี้คุณสามารถรันคำสั่งใน Bob IDE:

get me all applications from Instana in the last 24 hours

โหมด Stdio

การกำหนดค่าโดยใช้ CLI (การติดตั้ง PyPI - แนะนำ):

ตัวเลือกที่ 1: ใช้ตัวแปรสภาพแวดล้อมใน config:

{
  "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: ใช้ตัวแปรสภาพแวดล้อมใน config:

{
  "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 รองรับทั้งโหมด Streamable HTTP และ Stdio สำหรับการรวม MCP

กำหนดค่า Claude Desktop โดยแก้ไขไฟล์การกำหนดค่า:

ตำแหน่งไฟล์:

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

โหมด Streamable HTTP

โหมด Streamable HTTP ให้อินเทอร์เฟซ REST API สำหรับการสื่อสาร MCP โดยใช้ JSON-RPC ผ่าน HTTP

ขั้นตอนที่ 1: เริ่ม MCP Server ในโหมด Streamable HTTP

ก่อนกำหนดค่า Claude Desktop คุณต้องเริ่ม MCP server ในโหมด Streamable HTTP โปรดดูส่วน การเริ่ม MCP Server ในเครื่อง สำหรับคำแนะนำโดยละเอียด

ขั้นตอนที่ 2: กำหนดค่า Claude Desktop

กำหนดค่า Claude Desktop เพื่อส่งข้อมูลรับรอง Instana ผ่าน headers:

{
  "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"
      ]
    }
  }
}

ขั้นตอนที่ 3: ทดสอบการเชื่อมต่อ

รีสตาร์ท Claude Desktop ตอนนี้คุณควรเห็น Instana MCP Server ในอินเทอร์เฟซ Claude Desktop ดังที่แสดงด้านล่าง:

ตอนนี้คุณสามารถรันคำสั่งใน Claude Desktop:

get me all endpoints from Instana

โหมด Stdio

การกำหนดค่าโดยใช้ CLI (การติดตั้ง PyPI - แนะนำ):

ตัวเลือกที่ 1: ใช้ตัวแปรสภาพแวดล้อมใน config:

{
  "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"
      ]
    }
  }
}

การกำหนดค่าโดยใช้การติดตั้งสำหรับการพัฒนา:

ตัวเลือกที่ 1: ใช้ตัวแปรสภาพแวดล้อมใน config:

{
  "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 แบบ agentic ไม่ใช่ส่วนขยายที่สามารถดาวน์โหลดลงใน VS Code หรือ IDE อื่นได้

ขั้นตอนที่ 1: ดาวน์โหลดและติดตั้ง Kiro สำหรับระบบปฏิบัติการของคุณจาก https://kiro.dev/.

ขั้นตอนที่ 2: หลังการติดตั้ง เปิด Kiro และเปิดโปรเจกต์ใดก็ได้ใน IDE alt text

ขั้นตอนที่ 3: คลิกไอคอน Kiro (Ghost) ที่แถบด้านข้างซ้ายเพื่อเข้าถึงคุณสมบัติของ Kiro alt text

ขั้นตอนที่ 4: เลือกไอคอน Edit Config ที่มุมขวาบนของส่วน MCP Servers alt text

ขั้นตอนที่ 5: เปิดไฟล์การกำหนดค่า MCP server (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 server ในโหมด streamable-http ก่อนใช้การกำหนดค่านี้:

mcp-instana --transport streamable-http

โหมด Stdio

ตัวเลือกที่ 1: ใช้ตัวแปรสภาพแวดล้อมใน config:

{
  "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 server และเครื่องมือที่มีอยู่ปรากฏในส่วนล่างซ้ายของ Kiro alt text

ขั้นตอนที่ 7: ไปที่แผง AI Chat ป้อนพรอมต์ที่เกี่ยวข้องกับ MCP server ของคุณ และดูคำตอบโดยตรงภายใน Kiro alt text

GitHub Copilot

GitHub Copilot รองรับการรวม MCP ผ่านการกำหนดค่า VS Code สำหรับการรวม GitHub Copilot กับ VS Code โปรดดู คู่มือการตั้งค่า นี้

โหมด Streamable HTTP

ขั้นตอนที่ 1: เริ่ม MCP Server ในโหมด Streamable HTTP

ก่อนกำหนดค่า VS Code คุณต้องเริ่ม MCP server ในโหมด Streamable HTTP โปรดดูส่วน การเริ่ม MCP Server ในเครื่อง สำหรับคำแนะนำโดยละเอียด

ขั้นตอนที่ 2: กำหนดค่า VS Code

ดู ใช้ MCP servers ใน VS Code สำหรับการกำหนดค่าโดยละเอียด

คุณสามารถสร้างหรืออัปเดต .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: URL ของ Instana instance ของคุณ
instana-api-token: โทเค็น API ของ Instana ของคุณ
command: อัปเดตพาธ npx ให้ตรงกับการติดตั้ง Node.js ของระบบของคุณ (เช่น /path/to/your/node/bin/npx)
ตัวแปรสภาพแวดล้อม: ปรับ PATH และตัวแปรสภาพแวดล้อมอื่น ๆ ตามความจำเป็นสำหรับระบบของคุณ

โหมด Stdio

ขั้นตอนที่ 1: สร้างการกำหนดค่า MCP ของ VS Code

ใช้ CLI (การติดตั้ง PyPI - แนะนำ):

สร้าง .vscode/mcp.json ในไดเรกทอรีรากของโปรเจกต์ของคุณ:

ตัวเลือกที่ 1: ใช้ตัวแปรสภาพแวดล้อมใน config:

{
  "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: ใช้ตัวแปรสภาพแวดล้อมใน config:

{
  "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: URL ของ Instana instance ของคุณ
INSTANA_API_TOKEN: โทเค็น API ของ Instana ของคุณ

ขั้นตอนที่ 2: จัดการเซิร์ฟเวอร์ใน VS Code

เปิด .vscode/mcp.json - คุณจะเห็นตัวควบคุมการจัดการเซิร์ฟเวอร์ที่ด้านบน
คลิก Start ถัดจาก Instana MCP Server เพื่อเริ่มเซิร์ฟเวอร์
สถานะการทำงานพร้อมกับจำนวนเครื่องมือบ่งบอกว่าเซิร์ฟเวอร์กำลังทำงาน

ขั้นตอนที่ 3: ทดสอบการรวม

สลับไปที่โหมด Agent ใน GitHub Copilot และโหลดเครื่องมือใหม่ นี่คือตัวอย่างการตอบสนองของ GitHub Copilot:

GitHub Copilot Response

Mistral AI

Mistral AI รองรับการรวม MCP เฉพาะผ่านโหมด Streamable HTTP เท่านั้น

ขั้นตอนที่ 1: เปิด MCP Server ในโหมด Streamable HTTP

เริ่ม MCP server ในโหมด Streamable HTTP โดยระบุข้อมูลรับรอง Instana ของคุณ รันคำสั่งต่อไปนี้:

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

ไปที่แท็บ Intelligence ในแถบด้านข้างซ้ายและเลือก Connectors
คลิก Add Connector
สร้างตัวเชื่อมต่อแบบกำหนดเองโดยป้อนชื่อตัวเชื่อมต่อและ URL ของ MCP server ที่ส่งต่อผ่าน Ngrok
เริ่มเซสชันแชทใหม่และตรวจสอบว่าเครื่องมือ MCP เปิดใช้งานอยู่ คุณสามารถดูคำตอบได้ที่นี่

การเชื่อมต่อกับ Instana MCP Servers หลายตัว

คุณสามารถกำหนดค่า MCP client ของคุณเพื่อเชื่อมต่อกับหลายอินสแตนซ์ ด้านล่างเป็นตัวอย่างการกำหนดค่า:

{
  "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)
พรอมต์ระบุชื่อเซิร์ฟเวอร์/สภาพแวดล้อมอย่างชัดเจน คำขอจะถูกส่งต่อไปยังเซิร์ฟเวอร์ที่กำหนดค่าไว้ตามลำดับ หากไม่มีเซิร์ฟเวอร์/สภาพแวดล้อมใดถูกระบุอย่างชัดเจนในพรอมpt MCP จะใช้เซิร์ฟเวอร์แรกที่กำหนดไว้ในคอนฟิกูเรชันเป็นเซิร์ฟเวอร์เริ่มต้น

หมายเหตุ: หากเซิร์ฟเวอร์ที่ร้องขอหยุดทำงานหรือไม่สามารถเข้าถึงได้ MCP จะทำงานตามที่คาดหวังและส่งต่อความล้มเหลวของ API ไปยังผู้ใช้ ผู้ใช้จะได้รับข้อผิดพลาดที่ส่งกลับมาจาก API ซึ่งระบุว่าเซิร์ฟเวอร์ไม่พร้อมใช้งาน MCP ขึ้นอยู่กับความพร้อมใช้งานของ API พื้นฐานและไม่มีการทำ failover อัตโนมัติ

คุณสมบัติที่รองรับ

เครื่องมือที่มี

เครื่องมือ	หมวดหมู่	คำอธิบาย
`manage_applications`	แอปพลิเคชันและโครงสร้างพื้นฐาน	เครื่องมือรวมสำหรับจัดการเมตริกแอปพลิเคชัน การกำหนดค่าการแจ้งเตือน การตั้งค่า และแคตตาล็อก
`manage_websites`	การตรวจสอบเว็บไซต์	เราเตอร์อัจฉริยะแบบรวมสำหรับการวิเคราะห์เว็บไซต์ แคตตาล็อก การกำหนดค่า และการดำเนินการกำหนดค่าขั้นสูง
`manage_custom_dashboards`	แดชบอร์ดที่กำหนดเอง	เครื่องมือรวมสำหรับจัดการการดำเนินการ CRUD ของแดชบอร์ดที่กำหนดเอง
`manage_infrastructure`	โครงสร้างพื้นฐาน	เราเตอร์อัจฉริยะแบบรวมสำหรับการวิเคราะห์โครงสร้างพื้นฐาน แคตตาล็อก (`get_plugin_schema`) และการดำเนินการสแนปช็อตทรัพยากร
`manage_automation`	ระบบอัตโนมัติ	เราเตอร์อัจฉริยะแบบรวมสำหรับระบบอัตโนมัติ: เรียกดูแคตตาล็อกการดำเนินการและดูประวัติการดำเนินการ
`manage_events`	เหตุการณ์	เราเตอร์อัจฉริยะแบบรวมสำหรับการตรวจสอบเหตุการณ์: รับเหตุการณ์ตาม ID รับเหตุการณ์ตาม ID หลายรายการ เหตุการณ์ Kubernetes เหตุการณ์การตรวจสอบเอเจนต์ และเหตุการณ์ทั้งหมด
`manage_slo`	การจัดการ SLO	เราเตอร์อัจฉริยะแบบรวมสำหรับการกำหนดค่า SLO รายงาน การแจ้งเตือน และหน้าต่างการแก้ไขพร้อมการจัดการเขตเวลาอัจฉริยะ
`manage_releases`	การจัดการรีลีส	เราเตอร์อัจฉริยะแบบรวมสำหรับการติดตามรีลีส: แสดงรายการรีลีสพร้อมการแบ่งหน้าและการกรองชื่อ รับรายละเอียดรีลีส สร้าง/อัปเดต/ลบรีลีสพร้อมการรองรับเขตเวลา
`manage_maintenance_windows`	หน้าต่างการบำรุงรักษา	เราเตอร์อัจฉริยะแบบรวมสำหรับการจัดการวงจรชีวิตหน้าต่างการบำรุงรักษา: สร้าง แก้ไข ปิด และแสดงรายการหน้าต่างการบำรุงรักษาพร้อมการรองรับเทมเพลตและการรวม ServiceNow
`manage_mobile_apps`	การตรวจสอบแอปมือถือ	เราเตอร์อัจฉริยะแบบรวมสำหรับการตรวจสอบแอปมือถือ: วิเคราะห์ beacon เมตริกประสิทธิภาพ การเล่นซ้ำเซสชัน การกำหนดค่า และการจัดการการแจ้งเตือน
`manage_synthetics`	การตรวจสอบแบบสังเคราะห์	เราเตอร์อัจฉริยะแบบรวมสำหรับการตรวจสอบแบบสังเคราะห์: แคตตาล็อก เมตริก การตั้งค่า (อ่านอย่างเดียว) และผลลัพธ์การเล่นซ้ำการทดสอบ

👉 สำหรับเอกสารเครื่องมือโดยละเอียด ความสามารถ และการอ้างอิงทางเทคนิค ดู เครื่องมือและตัวอย่าง

การกรองเครื่องมือ

MCP เซิร์ฟเวอร์รองรับการโหลดเครื่องมือแบบเลือกเพื่อเพิ่มประสิทธิภาพและลดการใช้ทรัพยากร คุณสามารถเปิดใช้งานเฉพาะหมวดหมู่เครื่องมือที่คุณต้องการสำหรับกรณีการใช้งานเฉพาะของคุณ

หมวดหมู่เครื่องมือที่มี

router: การจัดการแอปพลิเคชันและโครงสร้างพื้นฐานแบบรวม
- manage_instana_resources: เครื่องมือเดียวสำหรับเมตริกแอปพลิเคชัน การกำหนดค่าการแจ้งเตือน การตั้งค่า และแคตตาล็อก
- รองรับมุมมองแอปพลิเคชัน เอนด์พอยต์ บริการ และบริการด้วยตนเอง
- จัดการการกำหนดค่าการแจ้งเตือนทั้งเฉพาะแอปพลิเคชันและระดับโลก
- ให้การเข้าถึงแคตตาล็อกแท็กแอปพลิเคชันและแคตตาล็อกเมตริก
dashboard: การจัดการแดชบอร์ดที่กำหนดเอง
- manage_custom_dashboards: การดำเนินการ CRUD สำหรับแดชบอร์ดที่กำหนดเอง
- รองรับการสร้าง การดึงข้อมูล การอัปเดต และการลบแดชบอร์ด
- จัดการผู้ใช้ที่สามารถแชร์ได้และโทเค็น API สำหรับแดชบอร์ด
infra: เครื่องมือการจัดการโครงสร้างพื้นฐาน
- manage_infrastructure: เราเตอร์อัจฉริยะแบบรวมสำหรับการวิเคราะห์โครงสร้างพื้นฐาน แคตตาล็อก และการดำเนินการสแนปช็อตทรัพยากร
- get_plugin_schema รวม get_metrics + get_tag_catalog ในการเรียก API ครั้งเดียว
- รองรับประเภทเอนทิตีทั้งหมดที่มีในการติดตั้ง Instana ของคุณแบบไดนามิก (โหลดจากแคตตาล็อก API อัตโนมัติ)
- รวมถึง JVM, Kubernetes, Docker, โฮสต์, ฐานข้อมูล, คิวข้อความ และประเภทเอนทิตีที่กำหนดเองหรือเพิ่มใหม่ใดๆ
- การรวมเมตริก การกรอง การจัดกลุ่ม และคิวรีช่วงเวลาที่ยืดหยุ่น
automation: เครื่องมือสำหรับการดำเนินการอัตโนมัติ
- manage_automation: เราเตอร์อัจฉริยะแบบรวมสำหรับแคตตาล็อกอัตโนมัติและประวัติการดำเนินการ
- แคตตาล็อกการดำเนินการ: เรียกดูการดำเนินการ ดูรายละเอียด ค้นหาตามชื่อ/คำอธิบาย กรองตามแอปพลิเคชันหรือ ID สแนปช็อต
- ประวัติการดำเนินการ: แสดงรายการอินสแตนซ์การดำเนินการพร้อมการกรอง ดูรายละเอียดการดำเนินการ
events: เครื่องมือสำหรับการตรวจสอบเหตุการณ์
- เหตุการณ์: เหตุการณ์ Kubernetes การตรวจสอบเอเจนต์ และการติดตามเหตุการณ์ของระบบ
website: เครื่องมือสำหรับการตรวจสอบเว็บไซต์
- เมตริกเว็บไซต์: การวัดประสิทธิภาพสำหรับเว็บไซต์
- แคตตาล็อกเว็บไซต์: ข้อมูลเมตาและคำจำกัดความของเว็บไซต์
- การวิเคราะห์เว็บไซต์: การวิเคราะห์ประสิทธิภาพของเว็บไซต์
- การกำหนดค่าเว็บไซต์: การจัดการการกำหนดค่าเว็บไซต์
slo: การจัดการระดับวัตถุประสงค์การให้บริการ (SLO)
- manage_slo: เราเตอร์อัจฉริยะแบบรวมสำหรับการดำเนินการ SLO ที่ครอบคลุม
- การจัดการการกำหนดค่า: สร้าง อ่าน อัปเดต ลบการกำหนดค่า SLO พร้อมรองรับตัวบ่งชี้ตามเวลาและตามเหตุการณ์
- การสร้างรายงาน: สร้างรายงาน SLO โดยละเอียดพร้อมค่า SLI งบประมาณข้อผิดพลาด อัตราการเผาไหม้ และแผนภูมิอนุกรมเวลา
- การกำหนดค่าการแจ้งเตือน: จัดการการกำหนดค่าการแจ้งเตือน SLO สำหรับการตรวจสอบงบประมาณข้อผิดพลาดและการติดตามอัตราการเผาไหม้
- หน้าต่างการแก้ไข: สร้างและจัดการหน้าต่างการบำรุงรักษาเพื่อแยกการหยุดทำงานที่วางแผนไว้ออกจากการคำนวณ SLO
- การจัดการเขตเวลาอัจฉริยะ: การดึงเขตเวลาโดยอัตโนมัติสำหรับอินพุตวันที่และเวลาเพื่อให้แน่ใจว่าบริบทเวลาถูกต้อง
- การดึงข้อมูลแบบสองรอบ: การรวบรวมพารามิเตอร์แบบโต้ตอบสำหรับการดำเนินการที่ซับซ้อนซึ่งต้องใช้อินพุตหลายรายการ
releases: การติดตามการเผยแพร่และการจัดการการปรับใช้
- manage_releases: เราเตอร์อัจฉริยะแบบรวมสำหรับการดำเนินการเผยแพร่
- แสดงรายการการเผยแพร่: รับการเผยแพร่ทั้งหมดพร้อมการแบ่งหน้าอย่างมีประสิทธิภาพ (page_number, page_size) และการกรองตามชื่อ
- รายละเอียดการเผยแพร่: ดึงข้อมูลการเผยแพร่เฉพาะตาม ID รวมถึงแอปพลิเคชัน บริการ และขอบเขต
- สร้าง/อัปเดต/ลบ: การดำเนินการ CRUD อย่างเต็มรูปแบบสำหรับการจัดการการเผยแพร่
- การจัดการเขตเวลาอัจฉริยะ: การดึงเขตเวลาโดยอัตโนมัติสำหรับเวลาเริ่มต้นการเผยแพร่
- การแบ่งหน้าอย่างมีประสิทธิภาพ: หลีกเลี่ยงการดึงข้อมูลซ้ำซ้อนด้วยการนำทางตามหน้าอย่างเหมาะสม
- การกรองตามชื่อ: การจับคู่สตริงย่อยที่ไม่คำนึงถึงตัวพิมพ์ใหญ่-เล็กเพื่อค้นหาการเผยแพร่ตามชื่อ
maintenance_window: การจัดการวงจรชีวิตหน้าต่างการบำรุงรักษา
- manage_maintenance_windows: เราเตอร์อัจฉริยะแบบรวมสำหรับการดำเนินการหน้าต่างการบำรุงรักษา
- การดำเนินการหน้าต่าง: สร้าง แก้ไข ปิด และแสดงรายการหน้าต่างการบำรุงรักษา (ใช้งานอยู่ ตามกำหนดการ ทั้งหมด หมดอายุ)
- การดำเนินการแบบกลุ่ม: สร้างหน้าต่างการบำรุงรักษาสำหรับหลายแอปพลิเคชันพร้อมกัน
- การรองรับเทมเพลต: เทมเพลตที่กำหนดไว้ล่วงหน้าสำหรับสถานการณ์ทั่วไป (การปรับใช้ การย้ายฐานข้อมูล การอัปเกรดโครงสร้างพื้นฐาน เหตุฉุกเฉิน กิจวัตร)
- หน้าต่างที่เกิดซ้ำ: รองรับหน้าต่างการบำรุงรักษาที่เกิดซ้ำโดยใช้รูปแบบ RFC 5545 RRULE
- การบูรณาการ ServiceNow: การบูรณาการเสริมกับคำขอเปลี่ยนแปลง ServiceNow
- การตรวจสอบ: การตรวจสอบพารามิเตอร์ก่อนการสร้างหน้าต่าง
- ระยะเวลาที่ยืดหยุ่น: ระบุระยะเวลาเป็นนาที ชั่วโมง หรือวัน
mobile_app: การตรวจสอบแอปพลิเคชันมือถือ
- manage_mobile_apps: เราเตอร์อัจฉริยะแบบรวมสำหรับการดำเนินการตรวจสอบแอปมือถือ
- การเล่นซ้ำเซสชัน: ดึงบีคอนการเล่นซ้ำเซสชันแบบแบ่งหน้าตาม ID แอปมือถือและ ID เซสชัน (resource_type="session_replay")
- การวิเคราะห์บีคอน: คิวรีข้อมูลบีคอนแอปมือถือพร้อมการจัดกลุ่มและการกรอง
- เมตริกประสิทธิภาพ: ติดตามระยะเวลาเซสชัน อัตราการขัดข้อง และประสิทธิภาพคำขอ HTTP
- การวิเคราะห์ทางภูมิศาสตร์: วิเคราะห์การกระจายของผู้ใช้ตามประเทศ เมือง และภูมิภาค
- การวิเคราะห์อุปกรณ์: ตรวจสอบประสิทธิภาพในอุปกรณ์ แพลตฟอร์ม และเวอร์ชันระบบปฏิบัติการต่างๆ
- การจัดการการกำหนดค่า: จัดการการกำหนดค่าแอปมือถือ การระบุตำแหน่งทางภูมิศาสตร์ และการตั้งค่าการปกปิด IP
- การจัดการการแจ้งเตือน: กำหนดค่าและจัดการการกำหนดค่าการแจ้งเตือนแอปมือถือ
synthetics: การจัดการการตรวจสอบแบบสังเคราะห์
- manage_synthetics: เราเตอร์อัจฉริยะแบบรวมสำหรับการดำเนินการตรวจสอบแบบสังเคราะห์ทั้งหมด
- แคตตาล็อก: ค้นพบ ID เมตริกและชื่อแท็กที่ถูกต้องก่อนสร้างคิวรี
- เมตริก: ดึงเวลาตอบสนองรวมและอัตราความสำเร็จที่จัดกลุ่มตามตำแหน่งหรือชื่อการทดสอบ
- การตั้งค่า: แสดงรายการและค้นหาการทดสอบและตำแหน่งพร้อมการแก้ไขชื่ออัตโนมัติ ระบุศูนย์ข้อมูล (Managed) เทียบกับโฮสต์เอง (Private) PoPs
- การเล่นซ้ำการทดสอบ: ผลลัพธ์ดิบต่อการรัน การวิเคราะห์ 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

📖 สำหรับเอกสาร Docker ที่ครอบคลุม รวมถึงการสร้างแบบหลายสถาปัตยกรรม .dockerignore แนวทางปฏิบัติด้านความปลอดภัยที่ดีที่สุด และตัวอย่างการปรับใช้สำหรับการผลิต ดู 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:
  - ตรวจสอบว่าคุณสามารถเข้าถึงปลายทาง API ของ Instana ได้โดยใช้ curl หรือ wget พร้อมการตรวจสอบ SSL
    - หากใช้งานได้ สภาพแวดล้อม Python ของคุณอาจไม่สามารถตรวจสอบใบรับรองได้ และอาจไม่สามารถเข้าถึงใบรับรองเดียวกันกับเชลล์หรือระบบของคุณ ตรวจสอบให้แน่ใจว่าสภาพแวดล้อม Python ของคุณใช้ใบรับรองระบบ (macOS) คุณสามารถทำได้โดยติดตั้งใบรับรองลงใน Python: /Applications/Python\ 3.13/Install\ Certificates.command
  - หากคุณไม่สามารถเข้าถึงปลายทางได้ด้วยการตรวจสอบ SSL ให้ลองโดยไม่ใช้ หากใช้งานได้ ตรวจสอบใบรับรอง CA ของระบบของคุณและตรวจสอบให้แน่ใจว่าเป็นเวอร์ชันล่าสุด