Qovery

Getting Started

MCP Server

​

Overview

The Qovery MCP Server lets you interact with your Qovery infrastructure from any MCP-compatible client (Claude, Claude Code, ChatGPT, etc.) using natural language.

What is MCP? The Model Context Protocol is an open standard developed by Anthropic that allows AI assistants to interact with external tools and systems. Learn more →

​

Prerequisites

• MCP-Compatible Client: Any MCP-compatible application
• Qovery Account: Active account with infrastructure
• API Token: Generate from Qovery Console (Settings -> API Tokens) (only needed if you don’t use OAuth)

​

Setup

​

1. Generate Your Qovery API Token (if not using OAuth)

1

Open Qovery Console

Go to console.qovery.com

2

Navigate to Settings

Click on the settings icon in your organization

3

Access API Tokens

Go to API Tokens section

4

Generate Token

Click “Generate Token” and copy it

Save this token securely. You won’t be able to see it again!

​

2. Configure Your MCP Client

The Qovery MCP Server is accessible at:

https://mcp.qovery.com/mcp

OAuth: If your client supports OAuth, use the MCP Server URL and configure the OAuth callback port. Example with Claude Code:

claude mcp add --transport http qovery https://mcp.qovery.com/mcp --callback-port 4242

API Token:

https://mcp.qovery.com/mcp?token=<your-token>

Refer to your specific MCP client’s documentation for detailed setup instructions on how to add a custom MCP server.

The Qovery MCP Server is also available through the MCP Registry.

​

Authentication

The Qovery MCP Server supports 2 authentication methods:

• 1. OAuth
• 2. API Token

Use the MCP Server URL and configure an OAuth callback port. Example with Claude Code:

​

Usage Examples

Once connected, you can interact with your infrastructure naturally: 

"Show me all my environments" "What services are running in production?" "List projects in my organization"

​

Troubleshooting

​

MCP Server Not Connecting

**Issue**: Client doesn’t show Qovery tools or cannot connect **Solutions**: 
1. Verify the MCP Server URL is correct: `https://mcp.qovery.com/mcp`
2. Check your internet connection
3. Restart your MCP client
4. Contact Qovery Support if the issue persists

​

Authentication Errors

**Issue**: “Authentication failed” or “Invalid token” errors **Solutions**: 
1. Verify your API token is correct (check for copy-paste errors)
2. Ensure the token hasn’t been revoked or expired
3. Generate a new API token if needed from Qovery Console

​

Security Best Practices

**API Token Security**:
* Never share your API tokens publicly
* Don’t commit tokens to version control
* Revoke tokens you no longer need from Qovery Console
* Use tokens with the minimum required permissions
* Rotate tokens regularly

​

Token Permissions

The API token has the same permissions as the role you selected during creation: 
* Can only access resources within your organization
* Respects organization RBAC policies
* All actions are audited in Qovery Console

​

Next Steps

## Console Copilot

Use the built-in Console Copilot for quick help

![https://mintcdn.com/qovery/Nvnl0g5BHzA0XQmy/images/logos/slack-icon.svg?fit=max&auto=format&n=Nvnl0g5BHzA0XQmy&q=85&s=fa9fe6399994b9124e77f1d1120d41bb](IMAGE) 

## Slack Bot

Set up the Slack Bot for team collaboration

## View Capabilities

Explore everything Copilot can do

## Common Tasks

Practical examples and use cases

​

Resources

* **MCP Protocol**: modelcontextprotocol.io
* **Claude**: claude.ai
* **Technical Blog**: How We Built an Agentic DevOps Copilot

Was this page helpful?

YesNo

Raise issue

Qovery Slack BotInfrastructure Management