Настройка удаленного сервера MCP Управление Azure для Grafana

Каждый экземпляр Управляемой Grafana Azure включает встроенную конечную точку сервера контекста модели (MCP).

Конечная точка MCP Управляемой Grafana Azure позволяет инструментам и приложениям программно взаимодействовать с экземпляром Grafana, использующим MCP. Конечная точка MCP службы Управление Azure для Grafana использует тот же механизм аутентификации, что и экземпляр Grafana, поддерживая как Microsoft Entra ID, так и токен учетной записи сервиса Grafana.

Путь к конечной точке

Формат пути конечной точки управляемой Azure Grafana MCP — https://<grafana-endpoint>/api/azure-mcp.

Доступные средства MCP

Управление Azure для Grafana MCP предоставляет следующие инструменты для взаимодействия с Управление Azure для Grafana:

Конфигурация MCP

Чтобы подключиться к конечной точке MCP управляемой Grafana Azure, необходимо настроить клиент MCP с соответствующими параметрами. Управление Azure для Grafana MCP поддерживает следующие методы проверки подлинности:

• Токен учетной записи службы Grafana: токен, генерированный из вашего экземпляра Grafana. Формат — glsa_xxx.
• Токен идентификатора Microsoft Entra ID: токен идентификатора Microsoft Entra ID (например, из управляемого удостоверения или учетной записи службы).
• Аутентификация OAuth с помощью Microsoft Entra ID: интерактивный браузерный поток входа. Клиент MCP автоматически обрабатывает поток OAuth. Поддерживается Visual Studio Code с GitHub Copilot и Visual Studio с GitHub Copilot.

Токен учетной записи службы Grafana

Используйте маркер учетной записи службы Grafana для проверки подлинности. Начните с создания маркера:

1. В пользовательском интерфейсе экземпляра Grafana перейдите к Администрирование>Учетные записи службы.

2. Создайте новую учетную запись службы с помощью соответствующих разрешений.

3. Создайте маркер.

4. Скопируйте маркер учетной записи службы Grafana с форматом glsa_xxx. Вставьте его в параметры конфигурации:

   {
     "my-grafana-mcp-server": {
       "disabled": false,
       "timeout": 60,
       "type": "streamableHttp",
       "url": "https://my-grafana-d5ggtqegcr2safcp.wcus.grafana.azure.com/api/azure-mcp",
       "headers": {
         "Authorization": "Bearer glsa_xxxxxxxxxxxxxxxxxxxxxxxx_xxxxxxx"
       }
     }
   }
   

Токен идентификатора Microsoft Entra

Используйте маркер идентификатора Microsoft Entra для проверки подлинности. Этот подход полезен при использовании управляемых удостоверений или служебных субъектов.

• Используйте Azure CLI, чтобы получить токен Microsoft Entra ID для аудитории Управление Azure для Grafana 6f2d169c-08f3-4a4c-a982-bcaf2d038c45:

  az account get-access-token --resource 6f2d169c-08f3-4a4c-a982-bcaf2d038c45 --query accessToken -o tsv
  

• Кроме того, используйте управляемое удостоверение, чтобы программным способом получить токен для аудитории Управление Azure для Grafana 6f2d169c-08f3-4a4c-a982-bcaf2d038c45.

  {
    "my-grafana-mcp-server": {
      "disabled": false,
      "timeout": 60,
      "type": "streamableHttp",
      "url": "https://my-grafana-d5ggtqegcr2safcp.wcus.grafana.azure.com/api/azure-mcp",
      "headers": {
        "Authorization": "Bearer <entra-id-token>"
      }
    }
  }
  

Проверка подлинности OAuth с помощью идентификатора Microsoft Entra

Управление Azure для Grafana MCP поддерживает проверку подлинности OAuth с помощью идентификатора Microsoft Entra. Настройка маркера вручную не требуется. Поддерживаются следующие клиенты:

• Visual Studio Code с GitHub Copilot
• Visual Studio с помощью GitHub Copilot

В конфигурации VISUAL STUDIO CODE или Visual Studio MCP добавьте следующий параметр. Замените <grafana-endpoint> на ваш конечный пункт Grafana.

{
  "servers": {
    "my-grafana-mcp-server": {
      "type": "http",
      "url": "https://<grafana-endpoint>/api/azure-mcp"
    }
  }
}

При подключении GitHub Copilot к серверу MCP вам будет предложено войти с помощью учетной записи идентификатора Microsoft Entra.

Примеры

В следующих примерах показано, как настроить Управление Azure для Grafana MCP по типу клиента.

Пример 1. Visual Studio Code с потоком OAuth

Visual Studio Code с GitHub Copilot поддерживает аутентификацию OAuth через Microsoft Entra ID. Настройка маркера вручную не требуется. Клиент MCP автоматически обрабатывает поток OAuth и запрашивает вход с помощью учетной записи Microsoft Entra ID.

{
  "<your-grafana-mcp-server-name>": {
    "type": "http",
    "url": "https://<grafana-endpoint>/api/azure-mcp"
  }
}

Параметры конфигурации

Пример 2: Visual Studio Code с токеном сервисной учетной записи

Чтобы настроить Visual Studio Code для работы с токеном сервисной учетной записи Grafana, добавьте заголовок Authorization с токеном.

{
  "<your-grafana-mcp-server-name>": {
    "type": "http",
    "url": "https://<grafana-endpoint>/api/azure-mcp",
    "headers": {
      "Authorization": "Bearer glsa_xxxxxxxxxxxxxxxxxxxxxxxx_xxxxxxx"
    }
  }
}

Параметры конфигурации

Пример 3: Claude Code с токеном сервисной учетной записи

Чтобы настроить MCP для Claude Code, используйте параметры конфигурации, аналогичные следующему примеру. Используйте маркер учетной записи службы Grafana для проверки подлинности.

{
  "<your-grafana-mcp-server-name>": {
    "disabled": false,
    "timeout": 60,
    "type": "streamableHttp",
    "url": "https://<grafana-endpoint>/api/azure-mcp",
    "headers": {
      "Authorization": "Bearer glsa_xxxxxxxxxxxxxxxxxxxxxxxx_xxxxxxx"
    }
  }
}

Параметры конфигурации

Пример 4: OpenClaw с токеном учётной записи службы

Чтобы настроить MCP для OpenClaw, используйте команду openclaw mcp set с токеном сервисной учетной записи Grafana.

openclaw mcp set mcp '{"url":"https://<grafana-endpoint>/api/azure-mcp","transport":"streamable-http","headers":{"Authorization":"Bearer glsa_xxxxxxxxxxxxxxxxxxxxxxxx_xxxxxxx"}}'

Затем перезапустите шлюз, чтобы получить конфигурацию:

openclaw gateway restart

Ограничения

• В настоящее время конечная точка Управление Azure для Grafana MCP включена в Управление Azure для Grafana только для общедоступных облачных инстансов Azure, а не для суверенных облаков.
• Подключение к Управление Azure для Grafana через частную конечную точку сейчас не поддерживается.

Troubleshooting

Если возникли проблемы, откройте проблему в репозитории GitHub в Управление Azure для Grafana.

Связанный контент

• Проверка подлинности в API уровня данных Управление Azure для Grafana с помощью Microsoft Entra ID
• Настройка MCP для агентов Ai Foundry
• Включение зональной избыточности