McpApplicationInsights 0.1.0
dotnet tool install --global McpApplicationInsights --version 0.1.0
dotnet new tool-manifest
dotnet tool install --local McpApplicationInsights --version 0.1.0
#tool dotnet:?package=McpApplicationInsights&version=0.1.0
nuke :add-package McpApplicationInsights --version 0.1.0
McpApplicationInsights
Servidor MCP somente leitura para Application Insights. Quem usa escolhe a assinatura e o componente visíveis no próprio login. O pacote não escolhe ambiente sozinho.
A credencial fica na máquina (az login). O pacote não guarda segredo, assinatura nem token.
Repositório: https://github.com/SouzaMatheus-dev/mcp-applicationinsights
Escopo
Leitura de falhas de request, falhas de dependência, exceções e consulta Kusto no componente escolhido.
Criar alerta, alterar recurso ou gravar telemetria continua fora deste servidor.
Requisitos
| Item | Detalhe |
|---|---|
| .NET | SDK 8 para desenvolver. A ferramenta instalada usa o runtime exigido pelo dotnet tool |
| Login | az login concluído, inclusive o MFA, no tenant da assinatura |
| Rede | HTTPS até o inventário de recursos e até a consulta de logs |
| Conta | Acesso de leitura à assinatura e ao componente |
O login do portal não vale para o CLI. Se usuario_conectado falhar, rode az login de novo.
Instalação
dotnet tool install --global McpApplicationInsights
dotnet tool update --global McpApplicationInsights
O comando instalado é mcp-applicationinsights.
No Cursor, com a ferramenta global:
{
"mcpServers": {
"appinsights": {
"command": "mcp-applicationinsights"
}
}
}
Ou via dnx, sem instalação prévia. dnx exige SDK 10. Em máquina com SDK 8 ou 9, use a ferramenta global.
{
"mcpServers": {
"appinsights": {
"command": "dnx",
"args": ["McpApplicationInsights", "--yes"]
}
}
}
Configuração
Nada disso entra no repositório. Variável vazia significa o padrão.
| Variável | Padrão | Função |
|---|---|---|
AZURE_TENANT_ID |
login padrão do CLI | Tenant usado na credencial |
AZURE_SUBSCRIPTION_ID |
todas as assinaturas visíveis | Restringe a lista e a consulta |
APPINSIGHTS_RESOURCE_GROUP |
todos os grupos | Restringe os componentes |
APPINSIGHTS_MAX_ROWS |
40 |
Teto de linhas devolvidas, de 1 a 100 |
Exemplo no Cursor, quando a pessoa já sabe o tenant:
{
"mcpServers": {
"appinsights": {
"command": "mcp-applicationinsights",
"env": {
"AZURE_TENANT_ID": "",
"AZURE_SUBSCRIPTION_ID": "",
"APPINSIGHTS_RESOURCE_GROUP": ""
}
}
}
}
Deixe o valor só na configuração local do cliente. Não commite tenant, assinatura nem token.
Uso
listar_assinaturase espere a escolha.listar_componentescom a assinatura escolhida e espere o componente.- Só então consulte falhas, exceções ou Kusto.
Se a resposta vier com escolher: true, apresente as opções e pare. Não chute assinatura nem componente.
Catálogo
Todas as ferramentas são leitura. A janela vai de 1 a 168 horas. O padrão é 24.
| Ferramenta | Uso |
|---|---|
listar_assinaturas |
Assinaturas do login, para a pessoa escolher |
listar_componentes |
Componentes da assinatura escolhida |
usuario_conectado |
Identidade do token, sem devolver o JWT |
falhas_por_operacao |
Falhas de request, no recorte da aba de operações |
falhas_de_dependencia |
Dependências com falha |
excecoes |
Exceções agrupadas |
amostras_falha |
Até 15 requests com falha de uma operação |
consultar_kql |
Kusto de leitura no componente escolhido |
consultar_kql recusa comando de controle (.drop, .set, .delete, .create, .alter, .ingest).
Desenvolvimento
dotnet test McpApplicationInsights.slnx
A publicação no NuGet dispara na tag v*. O workflow .github/workflows/publish-nuget.yml testa, empacota e envia com Trusted Publishing, na conta matneves. O passo a passo da primeira vez está em docs/publicacao-nuget.md.
Limitações
- A consulta só começa depois da assinatura e do componente. Nome repetido em mais de uma assinatura devolve a lista, em vez de escolher sozinho.
- Listas de inventário mostram até 100 componentes. Cada tabela de resultado respeita
APPINSIGHTS_MAX_ROWS. - A query string de URL sai das amostras. JWT encontrado no resultado vira
[jwt omitido]. - Este pacote não cobre escrita: alerta, recurso e telemetria continuam fora daqui.
Solução de problemas
| Sintoma | O que fazer |
|---|---|
Falha ao obter token |
Rode az login no tenant da assinatura e conclua o MFA. |
escolher: true |
Mostre as opções e chame de novo com a assinatura e o componente escolhidos. |
Nenhum componente encontrado |
Confira o nome em listar_componentes. O filtro por ambiente, se existir, está em AZURE_SUBSCRIPTION_ID e APPINSIGHTS_RESOURCE_GROUP. |
Bloqueado: só consulta de leitura |
A Kusto tem comando de controle. Reescreva como leitura. |
| HTTP no inventário | A conta não enxerga a assinatura, ou o login do CLI expirou. |
Licença
MIT.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 was computed. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
This package has no dependencies.
| Version | Downloads | Last Updated |
|---|---|---|
| 0.1.0 | 125 | 9/30/2026 |