> ## Documentation Index
> Fetch the complete documentation index at: https://www.qovery.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting Started with Qovery AI Copilot

> Start automating your infrastructure with agentic AI

## Overview

Qovery AI Copilot is your intelligent assistant for managing infrastructure. It's available through three interfaces: the **Console** (built-in), **Slack Bot** (team collaboration), and **MCP Server** (power users). All allow you to interact with your Qovery infrastructure using natural language.

## Activation

To enable Qovery AI Copilot for your organization:

<Steps>
  <Step title="Access Organization Settings">
    Log into [Qovery Console](https://console.qovery.com) as an **organization administrator** and navigate to your organization settings.
  </Step>

  <Step title="Open AI Copilot Page">
    Go to the **AI Copilot** section in the settings menu.
  </Step>

  <Step title="Review and Accept Terms & Conditions">
    Read the AI Copilot Terms & Conditions carefully and accept them to proceed.
  </Step>

  <Step title="Enable AI Copilot">
    Click the **Enable AI Copilot** button. You will receive a copy of the Terms & Conditions via email for your records.
  </Step>

  <Step title="Access the Copilot Panel">
    Once enabled, you'll have access to the AI Copilot management panel where you can:

    * View and manage recurring tasks
    * Disable the AI Copilot if needed
    * Configure copilot settings
  </Step>
</Steps>

<Note>
  Only **organization administrators** can enable or disable the AI Copilot for the organization.
</Note>

<Warning>
  **Experimental Feature**: This is an experimental feature. Functionality may change, and billing terms are not final.
</Warning>

## Operating Modes

The Qovery AI Copilot operates in two modes:

<CardGroup cols={2}>
  <Card title="Read-Only Mode (Current)" icon="eye">
    **Safe exploration and information access**

    * View information and status
    * Get help and recommendations
    * Troubleshoot issues
    * Learn about features
    * **Cannot make changes** to infrastructure

    **Available in:** Console, Slack Bot, MCP Server
  </Card>

  <Card title="Read-Write Mode (Coming Soon)" icon="pen-to-square">
    **Full automation capabilities - In Development**

    * Everything in read-only mode
    * Deploy and restart services
    * Create/modify/delete resources
    * Update configurations
    * Manage environment variables

    **Status:** Coming soon for Slack Bot and MCP Server
  </Card>
</CardGroup>

<Note>
  **Current Status**: The AI Copilot currently operates in **read-only mode** across all interfaces. Read-write mode is under active development and will be available soon.
</Note>

## Choose Your Interface

Qovery AI Copilot is available through three interfaces:

<CardGroup cols={3}>
  <Card title="Console" icon="browser" href="/copilot/console">
    **Built-in help (Recommended)**

    Get contextual assistance directly in the Qovery Console.

    * 🔒 Read-only mode only
    * No setup required
    * Contextual awareness
    * Always available
    * Quick access (⌘ I)
  </Card>

  <Card title="Slack Bot" icon="https://mintcdn.com/qovery/Nvnl0g5BHzA0XQmy/images/logos/slack-icon.svg?fit=max&auto=format&n=Nvnl0g5BHzA0XQmy&q=85&s=fa9fe6399994b9124e77f1d1120d41bb" href="/copilot/slack-bot" width="24" height="24" data-path="images/logos/slack-icon.svg">
    **Best for teams**

    Use Copilot in Slack for collaborative infrastructure management.

    * 🔓 Read-write mode supported
    * Team collaboration
    * Mobile access
    * Full automation
    * Shared visibility
  </Card>

  <Card title="MCP Server" icon="desktop" href="/copilot/mcp-server">
    **Best for power users**

    Use Copilot in Claude Desktop for advanced workflows.

    * 🔓 Read-write mode supported
    * Desktop integration
    * Most powerful
    * Advanced features
    * Richer context
  </Card>
</CardGroup>

## Prerequisites

* **Qovery Account**: Active account with infrastructure deployed
* **For Console**: No additional setup needed! Just log into the [Qovery Console](https://console.qovery.com)
* **For Slack Bot**: Slack workspace and API token
* **For MCP Server**: Claude Desktop and API token

## Quick Start

Choose your preferred interface to get started:

<Tabs>
  <Tab title="Console (Easiest)">
    <Steps>
      <Step title="Log into Console">
        Go to [Qovery Console](https://console.qovery.com)
      </Step>

      <Step title="Click AI Copilot">
        Click the **AI Copilot** button (top-right) or press `⌘ I`
      </Step>

      <Step title="Start Asking">
        Ask questions or click on suggested actions
      </Step>
    </Steps>

    [Full Console Copilot Guide →](/copilot/console)
  </Tab>

  <Tab title="Slack Bot (For Teams)">
    <Steps>
      <Step title="Get API Token">
        Generate an API token from [Qovery Console](https://console.qovery.com)
      </Step>

      <Step title="Configure Bot">
        DM the bot in Slack with `/qovery-token <your-token> <channel-id>`
      </Step>

      <Step title="Start Using">
        Go to your channel and interact with @qovery
      </Step>
    </Steps>

    [Full Slack Bot Setup Guide →](/copilot/slack-bot)
  </Tab>

  <Tab title="MCP Server (For Power Users)">
    <Steps>
      <Step title="Install MCP Server">
        Follow the [MCP Server setup guide](/copilot/mcp-server)
      </Step>

      <Step title="Configure Authentication">
        Add your Qovery API token to the MCP Server configuration
      </Step>

      <Step title="Start Claude Desktop">
        Launch Claude Desktop with Qovery MCP Server enabled
      </Step>

      <Step title="Start Using">
        Interact with Copilot in Claude Desktop
      </Step>
    </Steps>

    [Full MCP Server Setup Guide →](/copilot/mcp-server)
  </Tab>
</Tabs>

## Your First Interactions

### Check Infrastructure Status

```
"Show me all my environments"
"What's the status of production?"
"List all applications in staging environment"
```

### Deploy Applications

```
"Deploy the latest version of my-api to staging"
"Redeploy the frontend application"
"Stop all services in the dev environment"
```

### Investigate Issues

```
"Why is my application deployment failing?"
"Show me error logs from the last hour"
"Check if the database is running"
```

## Understanding How Copilot Works

### Natural Language Understanding

Qovery AI Copilot understands natural language requests:

<Tabs>
  <Tab title="Casual Language">
    ✅ "Can you deploy my app?"
    ✅ "Stop everything in dev"
    ✅ "Show me what's broken"
  </Tab>

  <Tab title="Technical Language">
    ✅ "Deploy application-id xyz123 to environment prod"
    ✅ "Scale the API service to 5 replicas"
    ✅ "Update DATABASE\_URL environment variable"
  </Tab>

  <Tab title="Mixed Approach">
    ✅ "Deploy the payment-api (commit abc123) to production"
    ✅ "Clone staging to a new environment called feature-test"
    ✅ "Investigate 500 errors in the logs"
  </Tab>
</Tabs>

### Context Awareness

Copilot maintains conversation context:

```
You: "Show me the production environment"
Copilot: [Displays production details]

You: "Clone it to staging-test"
Copilot: [Creates clone without asking which environment]

You: "Now deploy version 2.0 there"
Copilot: [Deploys to staging-test automatically]
```

### Autonomous Execution

For complex tasks, Copilot breaks them down and executes automatically:

**Your Request**: "Create a staging environment for the new feature"

**Copilot's Actions**:

1. Creates new environment
2. Configures networking
3. Sets up databases
4. Deploys applications
5. Validates everything is running
6. Reports success

## Best Practices

### Be Specific When Needed

<Tabs>
  <Tab title="Good">
    ✅ "Deploy my-api to production"
    ✅ "Scale the database in staging"
    ✅ "Show logs for the last 30 minutes"
  </Tab>

  <Tab title="Can Be Improved">
    ⚠️ "Deploy something" (which app?)
    ⚠️ "Fix the error" (which error?)
    ⚠️ "Make it faster" (which service?)
  </Tab>
</Tabs>

If Copilot needs more information, it will ask clarifying questions.

### Use Follow-Up Questions

Build on previous interactions:

```
You: "Show me production resources"
Copilot: [Shows resources]

You: "Which ones are using the most CPU?"
Copilot: [Analyzes and reports]

You: "Scale up the top one by 2x"
Copilot: [Scales the identified service]
```

### Leverage Agentic Capabilities

Let Copilot handle complex workflows:

**Instead of**:

```
1. "Show me all environments"
2. "Check which ones are inactive"
3. "Calculate cost savings"
4. "Stop the inactive ones"
```

**Just ask**:

```
"Stop all environments that have been inactive for more than 24 hours"
```

Copilot will plan and execute all steps autonomously.

## Safety & Guardrails

### Confirmation for Destructive Actions

Copilot will ask for confirmation before:

* Deleting environments or services
* Stopping production workloads
* Making infrastructure changes

### Respects Permissions

Copilot can only perform actions you're authorized to do:

* Uses your Qovery credentials
* Follows RBAC policies
* Cannot bypass security controls

### Audit Trail

All Copilot actions are logged:

* View in Qovery Console audit logs
* Track what was changed and when
* Identify which actions Copilot performed

## Common Use Cases

### Daily Operations

```
"Show me the status of all services"
"Deploy the latest commit to staging"
"Restart the API service"
"Check database connection"
```

### Troubleshooting

```
"Why is my deployment failing?"
"Investigate errors in production"
"Show me logs for pod xyz123"
"Debug the connection timeout"
```

### Cost Optimization

```
"Show me which services cost the most"
"Find underutilized resources"
"Stop non-production environments for the weekend"
"Analyze spending over the last month"
```

### Infrastructure Management

```
"Create a new staging environment"
"Clone production to a test environment"
"Update environment variables for all services"
"Scale up the database"
```

## Getting Help

If you're unsure what Copilot can do:

```
"What can you help me with?"
"Show me examples of what you can do"
"Help me troubleshoot an issue"
```

Copilot will provide guidance and suggestions.

## Limitations (Beta)

Current limitations while in beta:

* **Console is Read-Only**: Console Copilot operates permanently in read-only mode for safety
* **Default Mode is Read-Only**: Slack Bot and MCP Server default to read-only mode
* **Confirmation Required**: Destructive operations require user confirmation in read-write mode
* **Beta Features**: Some capabilities still being developed
* **Response Time**: Complex operations may take time

## Next Steps

<CardGroup cols={3}>
  <Card title="Console Copilot" icon="browser" href="/copilot/console">
    Start using the built-in Console Copilot (no setup!)
  </Card>

  <Card title="Slack Bot" icon="https://mintcdn.com/qovery/Nvnl0g5BHzA0XQmy/images/logos/slack-icon.svg?fit=max&auto=format&n=Nvnl0g5BHzA0XQmy&q=85&s=fa9fe6399994b9124e77f1d1120d41bb" href="/copilot/slack-bot" width="24" height="24" data-path="images/logos/slack-icon.svg">
    Set up Copilot in Slack for team collaboration
  </Card>

  <Card title="MCP Server" icon="desktop" href="/copilot/mcp-server">
    Set up Copilot in Claude Desktop for power users
  </Card>

  <Card title="View All Capabilities" icon="list" href="/copilot/capabilities/infrastructure-management">
    Explore everything Copilot can do
  </Card>

  <Card title="Common Tasks" icon="book" href="/copilot/examples/common-tasks">
    Learn from practical examples
  </Card>

  <Card title="Advanced Workflows" icon="code" href="/copilot/examples/advanced-workflows">
    Complex automation scenarios
  </Card>
</CardGroup>

## Feedback & Support

We're actively improving Qovery AI Copilot. Share your feedback:

* **GitHub**: Report issues on [GitHub](https://github.com/Qovery/qovery-mcp-server)
* **Email**: Contact [support@qovery.com](mailto:support@qovery.com)

Your feedback helps us build better automation!