Skip to content

Add ADR-011: Azure Application Insights MCP Server#241

Merged
xenobiasoft merged 1 commit into
mainfrom
docs/adr-011-azure-mcp-server
Apr 26, 2026
Merged

Add ADR-011: Azure Application Insights MCP Server#241
xenobiasoft merged 1 commit into
mainfrom
docs/adr-011-azure-mcp-server

Conversation

@xenobiasoft
Copy link
Copy Markdown
Owner

Description

Adds ADR-011 documenting the architectural decision to build a custom Sudoku.McpServer that exposes read-only Application Insights telemetry tools over the Model Context Protocol (MCP) HTTP+SSE transport, deployed as an Azure App Service.

Type of Change

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • Documentation update
  • Code refactoring
  • Performance improvement
  • Other (please describe):

Changes Made

  • Added docs/adr/ADR-011-azure-mcp-server.md documenting the decision to create a custom MCP server for Azure Application Insights observability
  • Covers context (why the portal workflow was insufficient), alternatives considered (pre-built Azure MCP server, direct REST API), and the chosen approach
  • Documents all 6 exposed MCP tools (QueryLogs, GetExceptionSummary, GetRequestMetrics, GetGameTelemetry, GetActiveUsers, GetDependencyHealth)
  • Captures authentication approach (Managed Identity via DefaultAzureCredential), configuration contract, and enforced rules

Testing

  • I have tested these changes locally
  • All existing tests pass
  • I have added new tests (if applicable)

Screenshots (if applicable)

N/A — documentation-only change.

Checklist

  • My code follows the project's coding standards
  • I have performed a self-review of my own code
  • I have commented my code, particularly in hard-to-understand areas
  • My changes generate no new warnings
  • I have updated the documentation (if necessary)

Documents the decision to build a custom Sudoku.McpServer exposing
read-only Application Insights tools over the MCP HTTP+SSE transport,
deployed to Azure App Service with Managed Identity authentication.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@github-actions
Copy link
Copy Markdown

Azure Static Web Apps: Your stage site is ready! Visit it here: https://gray-bush-02024e71e-241.westus2.7.azurestaticapps.net

@xenobiasoft xenobiasoft merged commit 05eca14 into main Apr 26, 2026
10 checks passed
@xenobiasoft xenobiasoft deleted the docs/adr-011-azure-mcp-server branch April 26, 2026 17:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant