chore: add MCP integration and refactor documentation into modular how-to guides
- Moved GraphQL query samples into a new `docs/queries` directory for better organization. - Added new queries and mutations, including `createHost.graphql` and `GetApiVersion.graphql`. - Introduced `mcp-config.yaml` and updated `docker-compose.yml` for MCP integration. - Updated IntelliJ `.idea/workspace.xml` settings to reflect project changes. - Added new how-to guides (`docs/howtos`) for permissions, tags, MCP integration, and schema usage. - Enhanced tests by updating file paths and improving sample data locations. - Refined permissions and host group structures in `zabbix-hostgroups.ts` and `resolvers.ts`.
This commit is contained in:
parent
2a82fe6cf2
commit
4ec61ffba1
33 changed files with 439 additions and 165 deletions
24
docs/howtos/README.md
Normal file
24
docs/howtos/README.md
Normal file
|
|
@ -0,0 +1,24 @@
|
|||
# How-To Guides
|
||||
|
||||
This directory contains detailed guides on how to use and extend the Zabbix GraphQL API.
|
||||
|
||||
## Available Guides
|
||||
|
||||
### 📊 [Schema and Schema Extension](./schema.md)
|
||||
Learn about the GraphQL schema structure, how Zabbix entities map to GraphQL types, and how to use the dynamic schema extension system.
|
||||
|
||||
### 🗂️ [Hierarchical Data Mapping](./hierarchical_data_mapping.md)
|
||||
Understand how the API automatically maps flat Zabbix item keys into nested GraphQL objects using hierarchical resolvers and type hinting.
|
||||
|
||||
### 🔐 [Roles and Permissions Extension](./permissions.md)
|
||||
Discover how the permission system works, how to define permission levels using Zabbix template groups, and how to query user permissions.
|
||||
|
||||
### 🏷️ [Zabbix Tags Usage](./tags.md)
|
||||
Learn how Zabbix tags are used for device classification, host categorization, and as metadata within the GraphQL API.
|
||||
|
||||
### 🤖 [MCP Integration](./mcp.md)
|
||||
Discover how to integrate the Zabbix GraphQL API with the Model Context Protocol (MCP) to enable LLMs to interact with your Zabbix data.
|
||||
|
||||
---
|
||||
|
||||
For practical examples of GraphQL operations, check the [Sample Queries](../queries/) directory.
|
||||
Loading…
Add table
Add a link
Reference in a new issue