Qovery

Um servidor MCP para o Qovery AI Copilot que permite implantar aplicativos e gerenciar Kubernetes em infraestruturas AWS, GCP, Azure e On-Premise com linguagem natural.

Ver em qovery.comExperimente este MCPPatrocinado

Documentação

Servidor MCP

Conecte qualquer cliente compatível com MCP à sua infraestrutura Qovery

Visão Geral

O Servidor MCP da Qovery permite que você interaja com sua infraestrutura Qovery a partir de qualquer cliente compatível com MCP (Claude, Claude Code, ChatGPT, etc.) usando linguagem natural.

**O que é MCP?** O Model Context Protocol é um padrão aberto desenvolvido pela Anthropic que permite que assistentes de IA interajam com ferramentas e sistemas externos. [Saiba mais →](https://modelcontextprotocol.io) **Quer implantar um novo aplicativo a partir do código-fonte?** O Servidor MCP é para gerenciar infraestrutura *existente*. Para implantar um novo aplicativo a partir do seu código usando um agente de IA, instale a [Skill do Agente Qovery](/docs/getting-started/quickstart/ai-agent) — ela funciona com Claude Code, Cursor, OpenCode e mais de 30 ferramentas de codificação com IA. A skill e o Servidor MCP se complementam: use a skill para implantar e o Servidor MCP para gerenciar.

Pré-requisitos

Cliente Compatível com MCP: Qualquer aplicativo compatível com MCP
Conta Qovery: Conta ativa com infraestrutura

Configuração

O Servidor MCP da Qovery está acessível em https://mcp.qovery.com/mcp. Você pode encontrar essa URL e gerenciar seu acesso MCP no Console em Configurações > Servidor MCP. Escolha um dos dois métodos de autenticação abaixo para conectar seu cliente MCP.

Se o seu cliente MCP suporta OAuth, esta é a opção mais fácil — não é necessária geração de token. O cliente lidará com a autenticação automaticamente.

**Exemplo com Claude Code:**

```bash theme={null}
# Read-only (default)
claude mcp add --transport http qovery https://mcp.qovery.com/mcp --callback-port 4242

# Read/write
claude mcp add --transport http qovery "https://mcp.qovery.com/mcp?read_write=true" --callback-port 4242
```

Consulte a documentação do seu cliente MCP para saber como configurar OAuth com uma URL de servidor personalizada.

Se o seu cliente MCP não suporta OAuth, gere um token de API da Qovery e passe-o via URL.

**Passo 1 — Gere um token:**

<Steps>
  <Step title="Open Qovery Console">
    Vá para [console.qovery.com](https://console.qovery.com)
  </Step>

  <Step title="Navigate to Settings">
    Clique no ícone de configurações na sua organização
  </Step>

  <Step title="Access API Tokens">
    Vá para a seção **API Tokens**
  </Step>

  <Step title="Generate Token">
    Clique em "Gerar Token" e copie-o

    <Warning>
      Guarde este token com segurança. Você não poderá vê-lo novamente!
    </Warning>
  </Step>
</Steps>

**Passo 2 — Configure seu cliente MCP:**

Use o seguinte formato de URL, substituindo `your_qovery_token` pelo seu token:

```
# Read-only (default)
https://mcp.qovery.com/mcp?token=your_qovery_token

# Read/write
https://mcp.qovery.com/mcp?token=your_qovery_token&read_write=true
```

Você também pode passar o token via um cabeçalho `Authorization` em vez disso:

Se você quiser usar um token de API da Qovery, por exemplo, para poder limitar a permissão do que pode ser feito.
Você pode criar um token com permissão somente leitura/visualização para garantir que nenhuma ação destrutiva possa ser realizada.

<Tabs>
  <Tab title="Claude Code">
    Configure o Claude Code para adicionar seu token Qovery nos cabeçalhos HTTP

    ```bash theme={null}
    claude mcp add --transport http qovery https://mcp.qovery.com/mcp --header 'Authorization: Token qov_xxxx'
    ```

    ```
    Authorization: Token your_qovery_token
    ```
  </Tab>
</Tabs>

O Servidor MCP da Qovery também está disponível através do [Registro MCP](https://registry.modelcontextprotocol.io/v0.1/servers?search=com.qovery).

Modos de Acesso

Modo	Padrão	Descrição
Somente leitura	Sim	Pode consultar e listar recursos (ambientes, serviços, implantações, etc.)
Leitura/escrita	Não (`read_write=true`)	Também pode acionar implantações, atualizar configurações e realizar operações de escrita

A ferramenta `devops_copilot` depende de duas configurações no seu Console Qovery:

O Copilot deve estar habilitado — se desabilitado, a ferramenta não será acessível de forma alguma, independentemente da sua configuração MCP
O acesso de escrita deve estar habilitado — necessário para usar a ferramenta no modo leitura/escrita (além do parâmetro de URL read_write=true)

Habilite o modo de escrita apenas quando necessário. Prefira o modo somente leitura para limitar o raio de impacto de ações não intencionais da IA.

Exemplos de Uso

Uma vez conectado, você pode interagir com sua infraestrutura naturalmente:

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

Solução de Problemas

Servidor MCP Não Conectando

Problema: O cliente não mostra as ferramentas Qovery ou não consegue conectar

Soluções:

Verifique se a URL do Servidor MCP está correta: https://mcp.qovery.com/mcp
Verifique sua conexão com a internet
Reinicie seu cliente MCP
Entre em contato com o Suporte Qovery se o problema persistir

Erros de Autenticação

Problema: Erros de "Falha na autenticação" ou "Token inválido"

Soluções:

Verifique se o seu token de API está correto (verifique erros de copiar e colar)
Garanta que o token não foi revogado ou expirado
Gere um novo token de API, se necessário, no Console Qovery

Boas Práticas de Segurança

**Segurança do Token de API**:

Nunca compartilhe seus tokens de API publicamente
Não faça commit de tokens no controle de versão
Revogue tokens que você não precisa mais no Console Qovery
Use tokens com as permissões mínimas necessárias
Rotacione tokens regularmente

Permissões do Token

O token de API tem as mesmas permissões que o papel que você selecionou durante a criação:

Só pode acessar recursos dentro da sua organização
Respeita as políticas de RBAC da organização
Todas as ações são auditadas no Console Qovery

Próximos Passos

Use o Copilot integrado do Console para obter ajuda rápida Configure o Bot do Slack para colaboração em equipe Explore tudo o que o Copilot pode fazer Exemplos práticos e casos de uso

Recursos

Protocolo MCP: modelcontextprotocol.io
Claude: claude.ai
Blog Técnico: Como Construímos um Copiloto DevOps Agêntico

Gerencie sua infraestrutura e aplicativos com linguagem natural

Peça ao Claude para listar ambientes, verificar o status do aplicativo, acompanhar logs ou acionar um deploy. Tudo através do Servidor MCP da Qovery. Sem necessidade de kubectl.

Experimente Qovery grátis →