7.4. 将 AI 代理连接到 Ansible MCP 服务器

流程

1. 进入您要连接到 Ansible Automation Platform 的 AI 工具。

2. 按照您的 AI 客户端的说明来配置 MCP 服务器设置。

   通常，您必须在 mcp.json 文件中指定 MCP 服务器配置。

3. 在配置 mcp.json 文件时，以以下格式添加 Ansible MCP 服务器 URL：

   <Ansible MCP server URL>/ &lt;toolset&gt; /mcp

   key:

   • Ansible MCP 服务器 URL = Ansible MCP 服务器的 URL。例如： https://api.example.com/。

     要获取 Ansible MCP 服务器 URL，请联系您的机构管理员。

   • Toolset = 要连接的工具集。例如，job_management、inventory_management、system_monitoring、user_management、security_compliance 和 platform_configuration。

   • token = Ansible MCP 服务器的 API 令牌。

     使用以下格式在 mcp.json 文件中添加有关 Ansible MCP 服务器的详情：

     "mcpServers": {
             "aap-mcp-job-management": {
               "type": "http",
               "url": "https://api.example.com/job_management/mcp",
               "headers": {
                 "Authorization": "Bearer ${env:MY_SERVICE_TOKEN}"
               }
             },
             "aap-mcp-inventory-management": {
               "type": "http",
               "url": "https://api.example.com/inventory_management/mcp",
               "headers": {
                 "Authorization": "Bearer ${env:MY_SERVICE_TOKEN}"
               }
             },
             "aap-mcp-system-monitoring": {
               "type": "http",
               "url": "https://api.example.com/system_monitoring/mcp",
               "headers": {
                 "Authorization": "Bearer ${env:MY_SERVICE_TOKEN}"
               }
             },
             "aap-mcp-user-management": {
               "type": "http",
               "url": "https://api.example.com/user_management/mcp",
               "headers": {
                 "Authorization": "Bearer ${env:MY_SERVICE_TOKEN}"
               }
             },
             "aap-mcp-security-compliance": {
               "type": "http",
               "url": "https://api.example.com/security_compliance/mcp",
               "headers": {
                 "Authorization": "Bearer ${env:MY_SERVICE_TOKEN}"
               }
             },
             "aap-mcp-platform-configuration": {
               "type": "http",
               "url": "https://api.example.com/platform_configuration/mcp",
               "headers": {
                 "Authorization": "Bearer ${env:MY_SERVICE_TOKEN}"
               }
             }
           },

     Copy to Clipboard Toggle word wrap
     重要

     使用简洁的 MCP 服务器名称，最好限制为 20 个字符。这是因为 AI 代理将 MCP 服务器名称与工具名称相结合，以创建唯一标识符，大多数 AI 代理对这个组合标识符强制使用 64 个字符的限制。