Skip to content

Commit 17371a4

Browse files
authored
docs: clarify requirement for Grafana 9.0 for full functionality (#212)
1 parent c8a5974 commit 17371a4

File tree

1 file changed

+18
-0
lines changed

1 file changed

+18
-0
lines changed

README.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,10 @@ A [Model Context Protocol][mcp] (MCP) server for Grafana.
44

55
This provides access to your Grafana instance and the surrounding ecosystem.
66

7+
## Requirements
8+
9+
- **Grafana version 9.0 or later** is required for full functionality. Some features, particularly datasource-related operations, may not work correctly with earlier versions due to missing API endpoints.
10+
711
## Features
812

913
_The following features are currently available in MCP server. This list is for informational purposes only and does not represent a roadmap or commitment to future features._
@@ -458,6 +462,20 @@ grafanaConfig := mcpgrafana.GrafanaConfig{
458462
contextFunc := mcpgrafana.ComposedStdioContextFunc(grafanaConfig)
459463
```
460464

465+
## Troubleshooting
466+
467+
### Grafana Version Compatibility
468+
469+
If you encounter the following error when using datasource-related tools:
470+
471+
```
472+
get datasource by uid : [GET /datasources/uid/{uid}][400] getDataSourceByUidBadRequest {"message":"id is invalid"}
473+
```
474+
475+
This typically indicates that you are using a Grafana version earlier than 9.0. The `/datasources/uid/{uid}` API endpoint was introduced in Grafana 9.0, and datasource operations will fail on earlier versions.
476+
477+
**Solution:** Upgrade your Grafana instance to version 9.0 or later to resolve this issue.
478+
461479
## Development
462480

463481
Contributions are welcome! Please open an issue or submit a pull request if you have any suggestions or improvements.

0 commit comments

Comments
 (0)