setup-gcx

Configure gcx contexts for Grafana Cloud and on-prem instances.

535|42|Updated Mar 23, 2026
One-click install
npx skills add https://github.com/grafana/gcx --skill setup-gcx
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: setup-gcx
Source: https://github.com/grafana/gcx/tree/main/claude-plugin/skills/setup-gcx
Command: npx skills add https://github.com/grafana/gcx --skill setup-gcx

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Configure gcx for Grafana instances across Cloud and On-Prem, including authentication, context setup, and first-time configuration.

Core Features & Use Cases

  • Supports Grafana Cloud and on-prem deployments with context-based configuration.
  • Establishes authentication methods (token or user/password) and TLS settings; sets active context and verifies connectivity.
  • Guides first-time setup workflows and troubleshooting, including environment variable overrides for CI/CD and default datasource configuration.

Quick Start

Create a context for your Grafana Cloud or On-Prem environment and configure authentication and server details as described.

Frequently Asked Questions about setup-gcx

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure gcx for Grafana Cloud and on-premise authentication?

Configure gcx authentication by establishing context-based connections to Grafana instances. You must provide a server URL along with either an API token or a user/password combination, plus optional TLS settings to verify connectivity.

Can I use environment variables to set up Grafana contexts for CI/CD pipelines?

Yes, you can use environment variables to override context settings for CI/CD flows. This allows automated pipelines to establish Grafana connections without manual configuration by injecting server URLs and authentication tokens dynamically.

What authentication methods are supported for connecting to Grafana instances?

Grafana instances support token-based authentication and user/password credentials. You must supply one of these methods alongside the server URL when configuring a context, with optional TLS settings for secure connections.

How do I switch between multiple Grafana server configurations using contexts?

Context-based configuration allows you to define multiple Grafana server profiles and set an active context. This switches the current connection target, enabling seamless transitions between Cloud, on-prem, and CI/CD environments.

Does gcx support custom TLS settings for on-prem Grafana deployments?

Yes, custom TLS settings are supported when establishing connections to on-prem Grafana deployments. You can configure these optional security parameters alongside the required server URL and authentication credentials to ensure secure connectivity.

What is the best way to troubleshoot first-time Grafana setup and connectivity verification?

First-time setup troubleshooting involves verifying your server URL, checking authentication credentials, and confirming TLS settings. The configuration workflow validates connectivity to ensure your active context successfully reaches the target Grafana instance.