Grafana Integration

To connect MCP Express to Grafana, configure authentication and alerting permissions before enabling alert management tools. This integration provides secure access to list alert rules, inspect firing alerts, and manage silences using a Grafana service account token.

Once connected, you can automate alert monitoring and silence workflows, keeping all operations scoped to the configured Grafana instance.

Connection Parameters

Parameter	Technical Description	Required
Grafana URL	Base URL for your Grafana instance.	Yes
Grafana Token	Grafana service account token used to authenticate API requests. This integration requires a service account token.	Yes

info

Service Account Required: You must create a dedicated Grafana service account with alerting permissions enabled. Personal user tokens are not recommended for production automation.

tip

Best Practice: Use a dedicated service account for this integration only. Grant only alerting permissions and rotate tokens regularly.

Create a Grafana Service Account Token

Create a dedicated service account and token before configuring MCP Express:

note

If your Grafana UI differs from the steps below, refer to the official documentation: Service accounts.

1. In Grafana, go to Administration > Users and access > Service accounts.
2. Select New service account.
3. Enter a name such as mcp-express-alerting and save.
4. Assign the alerting permission to this service account.
5. Open the service account and create a token.
6. Copy the generated token and use it for the Grafana Token field in your mcp-express configuration.