Этот репозиторий предоставляет руководства по настройке для подключения различных помощников ИИ к платформе Ansible Automation Platform (AAP) с использованием протокола Model Context Protocol (MCP).

Обзор

AAP предоставляет ** один MCP-сервер** с 6 отдельными конечными точками набора инструментов, которые позволяют помощникам ИИ взаимодействовать с различными аспектами вашей платформы автоматизации:

1. ** Управление рабочими местами** - выполнение и контроль за работой по автоматизации
2. Управление запасами - Управление хостами, группами и запасами 3.Системный мониторинг - Мониторинг состояния и показателей платформы
3. Управление пользователями - Управление пользователями, командами и организациями 5.Безопасность и соответствие - Политики безопасности доступа и журналы аудита
4. Конфигурация платформы - Настройка настроек платформы

Поддерживаемые помощники

Это хранилище включает в себя руководства по настройке для трех различных платформ помощников ИИ:

Оригинальное название: Setup Guide | Best for

|Cursor IDE | cursor-mcp-setup/ | Разработчики, использующие Cursor для кодирования с помощью ИИ | Claude Desktop | claude-mcp-setup/ | Пользователи приложения Claude Desktop от Anthropic Microsoft Copilot Studio | Copilotstudio-mcp-setup/ | Пользователи Enterprise, создающие пользовательские копилоты |

Ansible Automation Platform MCP Integration

This repository provides setup guides for connecting various AI assistants to Ansible Automation Platform (AAP) using the Model Context Protocol (MCP).

Overview

AAP provides one MCP server with 6 separate toolset endpoints that enable AI assistants to interact with different aspects of your automation platform:

1. Job Management - Execute and monitor automation jobs
2. Inventory Management - Manage hosts, groups, and inventories
3. System Monitoring - Monitor platform health and metrics
4. User Management - Manage users, teams, and organizations
5. Security & Compliance - Access security policies and audit logs
6. Platform Configuration - Configure platform settings

Supported AI Assistants

This repository includes setup guides for three different AI assistant platforms:

Quick Start

1. Deploy the AAP MCP Server (if not already done):

   • Deploy on RHEL
   • Deploy on OpenShift
   • GitHub Repository

2. Get Your AAP API Token:

   • Follow the Red Hat documentation
   • Save your token in mcp_key.txt (gitignored for security)

3. Choose Your Platform and follow the appropriate setup guide:

   • Cursor IDE Setup - JSON-based configuration with environment variables
   • Claude Desktop Setup - JSON configuration for Claude Desktop app
   • Microsoft Copilot Studio Setup - OpenAPI-based Custom Connector via Power Apps

Repository Structure

mcp-demo/
├── cursor-mcp-setup/          # Cursor IDE configuration
│   ├── README.md              # Detailed Cursor setup guide
│   ├── mcp-config-template.json
│   ├── KNOWN_ISSUES.md
│   └── TOOL_NAME_LIMITS.md
├── claude-mcp-setup/          # Claude Desktop configuration
│   ├── README.md              # Detailed Claude setup guide
│   └── [configuration files]
├── copilotstudio-mcp-setup/   # Microsoft Copilot Studio setup
│   ├── README.md              # Detailed Copilot Studio setup guide
│   └── aap-mcp-openapi.yaml   # OpenAPI specification
├── images/                    # Shared images and diagrams