MCP (agentes de IA) - Hyze Cloud

O MCP (Model Context Protocol) é o padrão aberto que conecta agentes de IA a ferramentas externas. O servidor MCP da Hyze Cloud expõe operações read-only da plataforma para que você possa perguntar ao seu agente, em linguagem natural, coisas como “liste meus apps” ou “por que meu deploy falhou”.

O servidor MCP é somente leitura no MVP. Ele opera com a sua API key e passa pelas mesmas regras de permissão da API pública — nenhum recurso extra, nenhum acesso direto a bancos ou workers.

O que o agente pode fazer

apps_list — listar os apps do seu workspace (com busca e paginação)
apps_get — detalhes de um app: status, URL pública, repositório, último commit
deployments_list — histórico de deploys com status e resumo de erro
apps_logs — logs recentes de runtime (com limite de tamanho)
domains_list — domínios do app com status de verificação e SSL

Operações de escrita (criar app, deploy, restart, excluir) não estão disponíveis no MCP ainda.

Requisito: uma API key

O MCP usa a mesma autenticação da API pública. Se você ainda não tem uma key, siga o guia de chave de API: Settings → Developer → Create Key no Dashboard. Guarde a key em um lugar seguro (gerenciador de senhas ou variável de ambiente). Ela fica ligada ao seu workspace e define o que o agente pode ver.

Configurar no Claude Code

Abra o terminal e execute:

claude mcp add --transport http hyze https://mcp.hyzecloud.com/mcp \
  --header "Authorization: Bearer hyze_sua_chave"

Verifique a conexão:

claude mcp list

A sintaxe de configuração pode variar entre versões. Se o comando falhar, confira a versão do seu cliente — recomendamos sempre a versão mais recente.

Configurar em outros clientes

Qualquer cliente MCP com suporte a “Streamable HTTP” funciona com:

URL: https://mcp.hyzecloud.com/mcp
Header: Authorization: Bearer hyze_sua_chave

Em clientes que usam JSON de configuração, fica assim:

{
  "mcpServers": {
    "hyze": {
      "type": "http",
      "url": "https://mcp.hyzecloud.com/mcp",
      "headers": {
        "Authorization": "Bearer hyze_sua_chave"
      }
    }
  }
}

Exemplos de uso

Depois de conectar, experimente perguntar ao agente:

“Liste meus apps da Hyze”
“Qual o status do app X e qual a URL pública dele?”
“Por que o último deploy do app X falhou?”
“Mostre os logs recentes do app X”

Revogar acesso

Para desconectar um agente, revogue a API key no dashboard (Settings → Developer). O agente perde o acesso imediatamente, sem precisar mexer na configuração do cliente.

Use uma key dedicada ao agente. Assim você pode revogá-la sem afetar suas outras integrações.

Relacionado

Autenticação — como a API key funciona
Ver logs — diagnóstico pela API

​O que o agente pode fazer

​Requisito: uma API key

​Configurar no Claude Code

​Configurar em outros clientes

​Exemplos de uso

​Revogar acesso

​Relacionado

O que o agente pode fazer

Requisito: uma API key

Configurar no Claude Code

Configurar em outros clientes

Exemplos de uso

Revogar acesso

Relacionado