Servidor MCP

O GuaraCloud expõe um endpoint hospedado de Model Context Protocol em:

https://mcp.guaracloud.com/mcp

Use esse endpoint em clientes de IA compatíveis com MCP para inspecionar projetos, gerenciar serviços, fazer deploy, consultar logs, trabalhar com cron workers, gerenciar domínios e executar as mesmas operações remotas disponíveis na CLI do GuaraCloud.

Autenticação

O servidor MCP autentica com chaves de API do GuaraCloud. Crie uma chave no dashboard e envie-a como:

X-API-Key: gk_live_...

ou:

Authorization: Bearer gk_live_...

X-API-Key é verificado primeiro; Authorization: Bearer é aceito para clientes que só permitem o cabeçalho Authorization (é normalizado para a mesma chamada ao backend).

Chaves somente leitura podem listar e inspecionar recursos. Ferramentas que alteram recursos exigem uma chave com escopo de escrita.

Configuração do cliente

Claude Code

A forma mais rápida de conectar o GuaraCloud ao Claude Code é usando o comando nativo claude mcp add:

claude mcp add guaracloud https://mcp.guaracloud.com/mcp \
  -h "X-API-Key: gk_live_..." \
  --transport http

Substitua gk_live_... pela chave de API criada no dashboard do GuaraCloud. O Claude Code persiste a entrada no seu registro MCP e as ferramentas ficam disponíveis na próxima sessão.

Outros clientes MCP

A maioria dos clientes MCP (Cursor, Continue.dev, integrações customizadas) aceita uma entrada de transporte HTTP streamable. Aponte-os para o endpoint hospedado:

{
  "mcpServers": {
    "guaracloud": {
      "url": "https://mcp.guaracloud.com/mcp",
      "headers": {
        "X-API-Key": "gk_live_..."
      }
    }
  }
}

Ferramentas disponíveis

O servidor MCP publica uma ferramenta para cada comando remoto da CLI. Os nomes das ferramentas usam underscores compatíveis com MCP, incluindo:

• projects_list, projects_create, projects_info, projects_map, projects_observatory
• services_list, services_create, services_info, services_start, services_stop, services_restart, services_resize, services_delete
• deploy, deployments_list, rollback, status, logs, build_logs, scale
• env_list, env_set, env_unset
• domains_list, domains_add, domains_remove
• catalog_list, catalog_info, catalog_schema, catalog_query, catalog_deploy
• crons_list, crons_create, crons_info, crons_update, crons_delete, crons_suspend, crons_resume, crons_trigger, crons_runs
• services_metrics, services_traces_list, services_traces_get, services_vulnerabilities, services_profiles_get

Comandos locais da CLI, como login, logout e alterações de arquivo de configuração local, são representados como verificações seguras de autenticação ou contexto porque clientes MCP não armazenam o keychain da CLI nem o arquivo .guara.json.

Exemplo de requisição

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "services_list",
    "arguments": {
      "projectSlug": "meu-projeto"
    }
  }
}

Fluxo recomendado