AI Integration on DevOps-OS

MCP Setup & Configuration

Mon, 01 Jan 0001 00:00:00 +0000

MCP Setup & Configuration Guide#

This guide covers detailed setup and configuration of DevOps-OS as an MCP (Model Context Protocol) server for local and remote use with Claude, ChatGPT, and other AI assistants.

What is MCP?#

MCP (Model Context Protocol) is an open standard that lets AI assistants directly call tools and functions in your applications. DevOps-OS exposes all its pipeline generators as MCP tools, allowing Claude or ChatGPT to generate CI/CD pipelines, Kubernetes configs, and SRE dashboards on your behalf.

Environment Variables Reference

Mon, 01 Jan 0001 00:00:00 +0000

DevOps-OS MCP: Environment Variables Reference#

Complete reference for all environment variables that control DevOps-OS MCP server behavior and features.

Quick Reference#

Variable	Default	Type	Feature
`DEVOPS_OS_TRANSPORT`	`stdio`	string	Communication protocol
`DEVOPS_OS_PROFILE`	`local`	string	Deployment profile
`DEVOPS_OS_HOST`	`127.0.0.1`	string	HTTP bind address
`DEVOPS_OS_PORT`	`8000`	int	HTTP bind port
`DEVOPS_OS_MCP_ENDPOINT`	`/mcp`	string	MCP endpoint path
`DEVOPS_OS_LOG_LEVEL`	`INFO`	string	Logging verbosity
`DEVOPS_OS_REQUEST_SIZE_MB`	`10`	int	Max request size
`DEVOPS_OS_RESPONSE_SIZE_MB`	`50`	int	Max response size
`DEVOPS_OS_EXECUTION_TIMEOUT`	`30`	int	Tool timeout (seconds)
`DEVOPS_OS_MAX_CONCURRENT_CALLS`	`10`	int	Max concurrent tool executions
`DEVOPS_OS_JWT_ISSUER`	None	string	JWT issuer URL
`DEVOPS_OS_JWT_AUDIENCE`	None	string	JWT audience
`DEVOPS_OS_JWT_JWKS_URL`	Auto-derived	string	JWKS endpoint URL
`DEVOPS_OS_JWT_ALGORITHMS`	`RS256,ES256`	string	Allowed JWT algorithms
`DEVOPS_OS_ENABLE_SUGGESTIONS`	`true`	boolean	Enable prompt suggestions
`DEVOPS_OS_SUGGESTION_CONFIDENCE_THRESHOLD`	`medium`	string	Suggestion confidence filter
`DEVOPS_OS_MAX_SUGGESTIONS_PER_RESPONSE`	`2`	int	Max suggestions
`DEVOPS_OS_INCLUDE_EXAMPLES_IN_SUGGESTIONS`	`true`	boolean	Include prompt examples

Transport & Server Configuration#

`DEVOPS_OS_TRANSPORT`#

Type: String
Default: stdio
Valid Values: stdio, sse, streamable-http

OpenAI Codex Integration

Mon, 01 Jan 0001 00:00:00 +0000

OpenAI Codex Integration Guide#

This guide covers setting up and using DevOps-OS with OpenAI Codex for code generation and pipeline automation.

What is OpenAI Codex?#

OpenAI Codex is a powerful AI model trained on publicly available code from the internet. It understands dozens of programming languages and can generate, edit, and explain code in context.

Why Use Codex with DevOps-OS?#

Feature	Benefit
Natural language to code	Describe your pipeline in plain English, get YAML/Jenkinsfile back
Code completion	Start a pipeline definition, let Codex finish it
Multi-language support	Generate pipelines for GitHub Actions, Jenkins, GitLab CI, etc.
Context awareness	Understands your existing infrastructure patterns
Integration with your IDE	Use Codex plugins in VS Code, JetBrains, or other editors

Architecture Overview#

┌──────────────────────────────────────┐
│ Developer (IDE or Chat) │
│ "Generate a Python CI/CD pipeline" │
└────────────────┬─────────────────────┘
 │
 ▼
 ┌────────────────────────────┐
 │ OpenAI Codex API │
 │ (davinci-codex model) │
 └────────────────┬───────────┘
 │
 ▼
 ┌────────────────────────────┐
 │ DevOps-OS Skills │
 │ (openai_functions.json) │
 └────────────────┬───────────┘
 │
 ▼
 ┌────────────────────────────┐
 │ Generated Artifacts │
 │ - GitHub Actions YAML │
 │ - Jenkins Declarative │
 │ - Kubernetes manifests │
 │ - ArgoCD configs │
 └────────────────────────────┘

Prerequisites#

OpenAI API Key with access to Codex models
Python 3.10+
pip (Python package manager)
DevOps-OS repository cloned locally

Get Your OpenAI API Key#

Go to OpenAI Platform
Sign up or log in with your OpenAI account
Create a new API key
Copy and save it securely (you won’t be able to view it again)

Installation#

Step 1: Clone and Install DevOps-OS#

git clone https://github.com/cloudengine-labs/devops_os.git
cd devops_os

# Create virtual environment
python3 -m venv .venv
source .venv/bin/activate # macOS/Linux
# .venv\Scripts\activate # Windows

# Install dependencies
pip install -r mcp_server/requirements.txt
pip install openai # For direct API usage

Step 2: Set Your OpenAI API Key#

# macOS/Linux
export OPENAI_API_KEY="sk-your-api-key-here"

# Windows (PowerShell)
$env:OPENAI_API_KEY = "sk-your-api-key-here"

# Or add to your shell profile for persistence:
# ~/.bashrc, ~/.zshrc, or ~/.bash_profile
echo 'export OPENAI_API_KEY="sk-your-api-key-here"' >> ~/.zshrc
source ~/.zshrc

Method 1: Direct API Integration#

Use OpenAI Codex directly with DevOps-OS skill definitions.

ChatGPT Custom GPT Integration

Mon, 01 Jan 0001 00:00:00 +0000

ChatGPT Custom GPT Integration Guide#

This guide covers setting up and using DevOps-OS with ChatGPT and Custom GPTs for pipeline generation and DevOps automation.

What is ChatGPT and Custom GPTs?#

ChatGPT is an advanced AI chatbot that understands natural language and can perform complex tasks. Custom GPTs let you create specialized versions of ChatGPT with custom instructions, knowledge files, and function calling capabilities.

Why Use ChatGPT with DevOps-OS?#

Feature	Benefit
User-friendly UI	No coding required, just chat
Custom GPT	Create a specialized DevOps assistant for your team
Function calling	ChatGPT directly invokes DevOps-OS generators
Knowledge base	Attach your org’s runbooks and best practices
Shareable	Create a GPT once, share with your team
Web search	ChatGPT can research infrastructure patterns for you

Prerequisites#

ChatGPT Plus account (paid subscription required for Custom GPTs)
DevOps-OS repository cloned locally or deployed to a server
Python 3.10+ (for running the HTTP server)
HTTPS endpoint (ChatGPT requires HTTPS, not HTTP)

Get ChatGPT Plus#

Go to ChatGPT
Click “Upgrade to Plus” (bottom left)
Choose your plan ($20/month)
Complete payment

Architecture Overview#

┌──────────────────────────────────────┐
│ ChatGPT (Web or Mobile App) │
│ "Generate a Kubernetes config │
│ for my Node.js microservice" │
└────────────────┬─────────────────────┘
 │ HTTPS request
 ▼
 ┌────────────────────────────────┐
 │ Custom GPT (Your DevOps Bot) │
 │ ┌──────────────────────────┐ │
 │ │ System Instructions │ │
 │ │ - DevOps best practices │ │
 │ │ - Your team's standards │ │
 │ └──────────────────────────┘ │
 └────────────────┬────────────────┘
 │
 ▼
 ┌────────────────────────────────┐
 │ DevOps-OS HTTP Server │
 │ (Running on your infrastructure) │
 │ ┌──────────────────────────┐ │
 │ │ Function Definitions │ │
 │ │ (openai_functions.json) │ │
 │ └──────────────────────────┘ │
 └────────────────┬────────────────┘
 │
 ▼
 ┌────────────────────────────────┐
 │ DevOps-OS Generators │
 │ - Python CLI functions │
 │ - Validation and constraints │
 └────────────────┬────────────────┘
 │
 ▼
 ┌────────────────────────────────┐
 │ Generated Artifacts │
 │ - GitHub Actions YAML │
 │ - Jenkins Declarative │
 │ - Kubernetes manifests │
 │ - ArgoCD configs │
 │ - Prometheus alerts │
 └────────────────────────────────┘

Step 1: Deploy DevOps-OS as HTTP Server#

Your DevOps-OS must be accessible from the internet over HTTPS for ChatGPT to call it.

AI Integration on DevOps-OS

MCP Setup & Configuration

MCP Setup & Configuration Guide#

What is MCP?#

Environment Variables Reference

DevOps-OS MCP: Environment Variables Reference#

Quick Reference#

Transport & Server Configuration#

DEVOPS_OS_TRANSPORT#

OpenAI Codex Integration

OpenAI Codex Integration Guide#

What is OpenAI Codex?#

Why Use Codex with DevOps-OS?#

Architecture Overview#

Prerequisites#

Get Your OpenAI API Key#

Installation#

Step 1: Clone and Install DevOps-OS#

Step 2: Set Your OpenAI API Key#

Method 1: Direct API Integration#

ChatGPT Custom GPT Integration

ChatGPT Custom GPT Integration Guide#

What is ChatGPT and Custom GPTs?#

Why Use ChatGPT with DevOps-OS?#

Prerequisites#

Get ChatGPT Plus#

Architecture Overview#

Step 1: Deploy DevOps-OS as HTTP Server#

`DEVOPS_OS_TRANSPORT`#