MCP da sua conta

​

Conectar

export CUBE_API_KEY=cube_…

claude mcp add --transport http cube-hosting https://app.cubehosting.com.br/api/mcp --header "Authorization: Bearer $CUBE_API_KEY"

{
  "mcpServers": {
    "cube-hosting": {
      "url": "https://app.cubehosting.com.br/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:CUBE_API_KEY}"
      }
    }
  }
}

• Claude Code: o terminal troca $CUBE_API_KEY pela chave quando você roda o comando, e o Claude Code a guarda na configuração dele, no seu computador. Confira com claude mcp list.
• Cursor: o JSON vai em ~/.cursor/mcp.json. O ${env:CUBE_API_KEY} lê a chave da variável de ambiente, então ela não fica escrita no arquivo.
• Outro editor: use o mesmo endereço e o cabeçalho Authorization na configuração de MCP dele.

​

Ferramentas

​

Regras

• Nunca apaga nada: não existe ferramenta de excluir projeto, arquivo, backup ou variável. Para isso, use o painel.
• Não mexe em arquivos nem em configurações, e o valor de uma variável nunca sai: só os nomes, e só com chave de leitura e escrita (como na API).
• Mascarado: tokens, chaves, senhas, e-mails e IPs chegam trocados por um aviso, como DISCORD_TOKEN=[valor removido].
• Só a sua conta: um projeto de outra conta responde not_found, igual a um que não existe.
• Você confirma: o Claude Code e o Cursor pedem a sua confirmação antes de usar uma ferramenta, a não ser que você libere. Para só consultar, use uma chave de leitura.
• Log é dado: o que o projeto escreve no log vai marcado como texto do projeto, e o agente não deve seguir ordens que estejam nele.

​

Limites e Atividade

• Cada pedido ao MCP conta 1 no limite da API do seu plano, somado com a API e a CLI. Ao conectar, o agente faz 3 pedidos (initialize, notifications/initialized e tools/list); depois, 1 por ferramenta. Passou do limite: HTTP 429 rate_limit_exceeded com Retry-After. Num lote, cada pedido conta 1, como se viesse sozinho.
• Os logs abrem no máximo uma vez a cada 5 segundos por projeto: antes disso, get_logs responde too_many_requests.
• Tudo o que o agente faz entra na Atividade com “via MCP” e o nome da chave, como “via MCP (chave Claude Code)”.
• Revogar a chave em Chaves de API desliga o agente no pedido seguinte.

​

Erros

​

Para quem monta o próprio cliente

• JSON-RPC 2.0 por POST, uma mensagem por pedido; a resposta vem em application/json, e uma notificação recebe 202 sem corpo.
• Lote (só até a versão 2025-03-26): até 10 mensagens, que rodam uma depois da outra. Vazio ou com mais de 10 → HTTP 400 com o erro -32600. O pedido do lote que passa do limite não roda e volta com o erro -32000, com data.code = rate_limit_exceeded.
• stop_project e restart_project vêm com destructiveHint: true, porque tiram o projeto do ar; as de leitura vêm com readOnlyHint: true.
• Sem sessão: não há Mcp-Session-Id, e GET e DELETE respondem 405.
• Versões do protocolo: 2025-11-25, 2025-06-18, 2025-03-26 e 2024-11-05.
• Métodos: initialize, ping, tools/list e tools/call.

curl -s https://app.cubehosting.com.br/api/mcp \
  -H "Authorization: Bearer $CUBE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_projects","arguments":{}}}'