theharithsa/Dynatrace-Managed-MCP

Dynatrace Managed MCP Server

A comprehensive Model Context Protocol server for Dynatrace Managed environments

Table of Contents

• Features
• Installation
• Configuration
• Available Tools
• OpenTelemetry Integration
• Prompt Guides
• Development
• API Token Permissions
• Troubleshooting
• Authors
• Contributing
• Support

Features

Production Ready

• 39 comprehensive tools covering the complete Dynatrace API
• Enterprise-grade error handling
• Request tracking with UUID
• Automatic retry logic

Full Observability

• Built-in OpenTelemetry tracing
• Parent-child span relationships
• Performance metrics
• Error tracking with stack traces

AI-First Design

• Raw JSON responses for LLM interpretation
• No pre-formatting - let AI handle presentation
• Future-proof API field support
• Universal client compatibility

Enterprise Security

• API token authentication
• Secure credential handling
• Configurable timeouts
• Comprehensive logging

Installation

Option 1: NPM (Recommended)

npm install -g @theharithsa/dynatrace-managed-mcp-server

Option 2: From Source

git clone https://github.com/theharithsa/Dynatrace-Managed-MCP.git
cd Dynatrace-Managed-MCP
npm install
npm run build

Configuration

Environment Variables

Required Variables

Optional Variables

OpenTelemetry Variables

VS Code Configuration

Create .vscode/mcp.json in your workspace:

{
  "servers": {
    "dynatrace-managed": {
      "command": "npx",
      "args": ["@theharithsa/dynatrace-managed-mcp-server"],
      "env": {
        "DYNATRACE_MANAGED_URL": "https://your-cluster.dynatrace.com",
        "DYNATRACE_ENVIRONMENT_ID": "your-environment-id",
        "DYNATRACE_API_TOKEN": "dt0c01.xxxxx"
      }
    }
  }
}

Claude Desktop Configuration

{
  "mcpServers": {
    "dynatrace-managed": {
      "command": "npx",
      "args": ["@theharithsa/dynatrace-managed-mcp-server"],
      "env": {
        "DYNATRACE_MANAGED_URL": "https://your-cluster.dynatrace.com",
        "DYNATRACE_ENVIRONMENT_ID": "your-environment-id",
        "DYNATRACE_API_TOKEN": "dt0c01.xxxxx"
      }
    }
  }
}

Full Configuration with OpenTelemetry

{
  "mcpServers": {
    "dynatrace-managed": {
      "command": "npx",
      "args": ["@theharithsa/dynatrace-managed-mcp-server"],
      "env": {
        "DYNATRACE_MANAGED_URL": "https://your-cluster.dynatrace.com",
        "DYNATRACE_ENVIRONMENT_ID": "your-environment-id",
        "DYNATRACE_API_TOKEN": "dt0c01.xxxxx",
        "REQUEST_TIMEOUT": "30000",
        "MAX_RETRIES": "3",
        "LOG_LEVEL": "info",
        "OTEL_EXPORTER_OTLP_ENDPOINT": "https://your-tenant.live.dynatrace.com/api/v2/otlp/v1/traces",
        "OTEL_EXPORTER_OTLP_HEADERS": "Authorization=Api-Token dt0c01.xxxxx",
        "OTEL_RESOURCE_ATTRIBUTES": "service.name=mcp-server,service.version=1.0.0",
        "OTEL_TRACES_EXPORTER": "otlp",
        "OTEL_EXPORTER_OTLP_TRACES_PROTOCOL": "http/protobuf"
      }
    }
  }
}

Available Tools (39 Total)

Problems Management (8 tools)

Metrics Management (6 tools)

Entity Management (5 tools)

Events Management (7 tools)

Additional Tools

OpenTelemetry Integration

This server includes built-in OpenTelemetry instrumentation using @theharithsa/opentelemetry-instrumentation-mcp.

Span Attributes

Prompt Guides

Detailed guides for crafting effective prompts are available in the dynatrace-agent-rules/ folder:

Development

Prerequisites

• Node.js 18+
• npm 9+

Quick Start

# Install dependencies
npm install

# Build the project
npm run build

# Run in development mode
npm run dev

# Run tests
npm test

Adding New Tools

1. Create a new file in src/capabilities/
2. Follow the existing Zod schema pattern
3. Register in src/index.ts
4. Add tests in test/

API Token Permissions

Create an API token with these scopes:

Troubleshooting

Connection Issues

# Test connectivity
curl -H "Authorization: Api-Token YOUR_TOKEN" \
  "https://YOUR_CLUSTER/e/YOUR_ENV/api/v2/problems"

Debug Mode

# Enable verbose logging
DEBUG=mcp:* npm start

Common Errors

Troubleshooting

Windows: npx command not recognized

If you encounter 'dynatrace-managed-mcp-server' is not recognized as an internal or external command when running npx @theharithsa/dynatrace-managed-mcp-server, the npm global bin folder may not be in your PATH.

Solution:

1. Add the npm global bin folder to your PATH:

   [Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\Users\<username>\AppData\Roaming\npm", [EnvironmentVariableTarget]::User)
   

2. Restart VS Code or your terminal for the PATH change to take effect.

3. Verify the installation:

   npx @theharithsa/dynatrace-managed-mcp-server --help
   

Alternative: Use the installed command directly

If you've installed the package globally, you can run it directly:

npm install -g @theharithsa/dynatrace-managed-mcp-server
dynatrace-managed-mcp-server --help

Authors

• Vishruth Harithsa - @theharithsa
• Mithun Gangadharaiah - @mithungangadharaiah

Contributing

Contributions are welcome! Please see for guidelines.

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions

License

This project is licensed under the .

Made with ❤️ for the Dynatrace community