このリポジトリは、モデルコンテキストプロトコル(MCP)を使用して、さまざまなAIアシスタントをAnsible Automation Platform(AAP)に接続するためのセットアップガイドを提供します。

概要

AAP は、AI アシスタントが自動化プラットフォームのさまざまな側面とやり取りできるようにする、6 個の独立したツールセットエンドポイントで、 1 つの MCP サーバーを提供します。

1.Job Management - 自動化ジョブの実行と監視 2.在庫管理 - ホスト、グループ、および在庫の管理 3.システム監視 - プラットフォームの健全性とメトリックを監視 4.ユーザー管理 - ユーザー、チーム、組織の管理 5.**セキュリティポリシーと監査ログへのアクセス 6.プラットフォームの設定 - プラットフォームの設定の設定

サポートされたAIアシスタント

このリポジトリには、3つの異なるAIアシスタントプラットフォーム用のセットアップガイドが含まれます。

| プラットフォーム | セットアップガイド | ベストフォー | お問い合わせ |Cursor IDE | カーソル・mcp-setup/ | 人工知能によるコーディングのためのカーサーターを用いた開発者 | |クラウド・デスクトップ | クラウド・マック・セッティング | Anthropic’s Claude デスクトップアプリのユーザ | | ※Microsoft Copilot Studio** | copilotstudio-mcp-setup/ | エンタープライズ ユーザがカスタムコピロトを構築 |

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