Rivervo MCP: os seus sites, domínios, email, servidores e aplicações no Claude, no ChatGPT, no Cursor e noutras aplicações AI.
Ligue um assistente AI à sua conta Rivervo através do Rivervo MCP e faça a gestão de sites, domínios, email, servidores cloud e aplicações numa conversa — só apaga depois de confirmar e nunca faz pagamentos.
O Rivervo MCP é o servidor da Rivervo para o protocolo aberto Model Context Protocol (MCP). Funciona com Claude, ChatGPT, Cursor, VS Code e outras aplicações que suportam servidores MCP remotos com início de sessão. Depois de o ligar, pode perguntar ao assistente sobre as suas aplicações por palavras simples — «porque é que a última publicação da shop falhou?», «reverta a api para a versão anterior» — e ele trata do assunto através da sua conta Rivervo.
Endereço do servidor:
https://api.rivervo.com/mcpPrecisa de uma conta Rivervo com acesso a pelo menos uma aplicação. Não é necessário nenhum token da API: inicia sessão com a sua conta Rivervo, tal como no painel.
Ligar a partir de qualquer cliente MCP
- Nas definições de MCP da sua aplicação, adicione um servidor MCP remoto (pode chamar-se conector ou servidor HTTP) com o endereço
https://api.rivervo.com/mcp. Se a aplicação pedir um ID de cliente e um segredo, deixe-os em branco. - Quando a aplicação inicia a ligação, abre-se uma página da Rivervo: inicie sessão, se ainda não o tiver feito — com palavra-passe, Google, GitHub ou Telegram, e com a verificação em dois passos, se a utilizar.
- Confirme que aplicação está a pedir acesso e para onde será encaminhado a seguir, escolha o nível de acesso (ver abaixo) e clique em Permitir.
Volta à sua aplicação e o Rivervo MCP fica pronto a usar. Seguem-se indicações breves para as aplicações mais populares; os nomes dos menus podem variar de versão para versão.
O painel mostra as mesmas instruções em Definições da conta → Aplicações ligadas, ou em Como ligar, no fundo da página Aplicações.
Claude
claude.ai, Claude Desktop e telemóvel:
- No Claude, abra Settings → Connectors e escolha Add custom connector.
- Introduza um nome (por exemplo, «Rivervo») e cole o endereço do servidor. Deixe as definições avançadas (ID de cliente e segredo) em branco.
- Clique em Connect, inicie sessão na Rivervo, escolha o nível de acesso e clique em Permitir.
Para o usar numa conversa, ative-o no menu de ferramentas da conversa, se ainda não estiver ativo. Um conector adicionado no claude.ai ou no Claude Desktop fica também disponível nas aplicações móveis do Claude. Em organizações Team e Enterprise, os conectores personalizados podem ter de ser autorizados primeiro por um proprietário da organização no Claude.
Claude Code — adicione o servidor no terminal:
claude mcp add --transport http rivervo https://api.rivervo.com/mcpAcrescente --scope user para o ter disponível em todos os seus projetos, e não apenas no atual. Depois, no Claude Code, escreva /mcp, escolha rivervo e Authenticate: o navegador abre a mesma página da Rivervo, onde escolhe o nível de acesso e clica em Permitir.
ChatGPT
Se o seu plano do ChatGPT suportar conectores personalizados, adicione um novo conector com o endereço do servidor https://api.rivervo.com/mcp e escolha o início de sessão por OAuth, caso lhe perguntem como autenticar. Consoante o plano e as definições do espaço de trabalho, os conectores personalizados podem exigir o modo de programador ativo ou a autorização prévia de um administrador do espaço de trabalho.
Cursor e VS Code
Nas definições de MCP do Cursor ou do VS Code, adicione um servidor MCP remoto (HTTP) com o nome «rivervo» e o endereço https://api.rivervo.com/mcp. Na primeira ligação, o editor abre a página da Rivervo no navegador para iniciar sessão e autorizar o acesso.
Níveis de acesso
Ao ligar, escolhe o que o assistente pode fazer. São os mesmos níveis dos tokens da API:
| Nível de acesso | O que o assistente pode fazer |
|---|---|
| Só leitura | ver as suas aplicações, publicações e logs de compilação, logs de execução, métricas, utilização e gastos, e domínios; explicar erros |
| Leitura e publicação | tudo o que inclui Só leitura, e ainda publicar, voltar a publicar, reverter e reiniciar aplicações |
| Acesso total | tudo o que inclui Leitura e publicação, e ainda variáveis de ambiente (ver e alterar), ligar e desligar domínios e consultas só de leitura às bases de dados |
| Acesso total e terminal | tudo o que inclui Acesso total, e ainda executar comandos nos seus sites (npm, composer, wp-cli, scripts) com a conta do site |
Comece por Só leitura se quiser apenas respostas; pode voltar a ligar com um nível mais amplo quando quiser. Se um pedido exigir mais do que o nível escolhido, o assistente é informado disso e nada é feito.
A sua função continua a aplicar-se
O assistente atua em seu nome, com a função que tem em cada aplicação: só pode fazer o que o próprio utilizador pode fazer no painel. O nível de acesso aplica-se por cima da função.
- Leitor — o assistente só pode ler, seja qual for o nível escolhido.
- Programador — publicações, reversões, variáveis, domínios e dados, dentro do que o nível de acesso permite.
- Administrador e o titular da conta — o mesmo que Programador neste caso: tudo o que o Rivervo MCP oferece.
Se faz parte da equipa de outras contas Rivervo, o assistente também pode trabalhar nelas — sites, domínios, email, servidores e aplicações, com a função que lhe foi atribuída em cada uma: peça-lhe a lista das suas contas ou indique o nome da conta no pedido. Consulte Acesso a uma aplicação.
O que o assistente pode fazer
Consultar e investigar (Só leitura):
- listar as suas contas e aplicações e mostrar o estado e os serviços de uma aplicação;
- listar publicações e mostrar uma publicação com o final do respetivo log de compilação;
- ler os logs de execução do site, de um worker ou do agendamento, e pesquisar no histórico de logs dos últimos 7 dias;
- mostrar métricas (CPU, memória e outras) da última hora, do último dia ou da última semana, a utilização atual face aos limites e o gasto previsto para este mês;
- listar os domínios de uma aplicação e verificar se um domínio está bem configurado;
- Explicar este erro numa publicação que falhou ou num serviço que parou — a mesma explicação por AI que aparece no painel, dentro do mesmo limite diário.
Publicar (Leitura e publicação):
- publicar o commit mais recente ou voltar a publicar a versão em execução;
- reverter para uma versão anterior;
- reiniciar uma aplicação.
Configurar (Acesso total):
- listar as variáveis de ambiente (os valores ficam ocultos, a não ser que peça para os ver), definir e remover variáveis — tal como no painel, as alterações chegam à aplicação na publicação seguinte;
- ligar um domínio (o assistente mostra os registos DNS a criar) e desligá-lo;
- listar as tabelas de uma base de dados PostgreSQL ou MySQL, ler linhas e executar consultas só de leitura (
SELECT,SHOW,EXPLAIN).
Sites, domínios, email e servidores cloud
O assistente também trabalha com tudo o resto da sua conta: sites (alojamento), domínios registados na Rivervo, email profissional e servidores cloud. Encontra a ação certa a partir do que pede e executa-a através da API da Rivervo — as mesmas ações que existem no painel.
- Só leitura: listar os seus sites, domínios, domínios de email e servidores; ver bases de dados e os respetivos utilizadores, caixas de correio, registos DNS, definições de PHP, tarefas cron, SSL, erros, tráfego e disponibilidade.
- Acesso total: ler ficheiros e backups e alterar definições — por exemplo, adicionar um registo DNS, uma caixa de correio ou um reencaminhamento, criar uma base de dados e o respetivo utilizador, mudar a versão do PHP ou alterar o php.ini, adicionar um redirecionamento, instalar o WordPress ou outra aplicação do catálogo, reiniciar um servidor.
Em sites, domínios, email e servidores, tudo o que apaga, restaura ou substitui — apagar ficheiros (mesmo que seja para o lixo), bases de dados, caixas de correio, registos DNS, redirecionamentos ou regras de firewall, restaurar um backup, enviar uma cópia de teste para o site em produção, substituir ficheiros — só é feito depois de o confirmar no painel Rivervo: o assistente dá-lhe uma ligação, abre-a, vê exatamente o que vai acontecer e clica em Confirmar (ou Recusar); só então o assistente executa essa única ação, uma vez, no prazo de 15 minutos. O próprio assistente não pode confirmar nada. Nunca recebe um acesso para o navegador: as ligações para a consola do servidor, a administração do WordPress, o phpMyAdmin ou o webmail ficam no painel. Aqui, «Leitura e publicação» dá o mesmo que «Só leitura».
Com Acesso total e terminal, o assistente pode também executar código num site com a conta desse site: comandos (npm install, composer, wp plugin update, testes com curl, os seus scripts) e o respetivo resultado, escrever, carregar, mover e descomprimir ficheiros, permissões de ficheiros, tarefas cron, chaves SSH, publicações a partir do Git e aplicações Node.js ou Python. Tudo isto pode alterar ou apagar qualquer ficheiro dessa conta, por isso escolha este nível apenas quando precisar dele.
O que o assistente não pode fazer
- Apagar seja o que for: aplicações, serviços, bases de dados, backups ou buckets.
- Apagar, restaurar ou substituir seja o que for sem a sua confirmação nos seus sites, domínios, email ou servidores.
- Fazer pagamentos, mudar planos, recursos ou o limite de gastos.
- Alterar dados nas suas bases de dados — as consultas são só de leitura.
- Usar o terminal de uma aplicação ou a consola de um servidor, nem mudar quem tem acesso a uma aplicação.
Tudo isto é feito no painel.
Exemplos
- «Quais das minhas aplicações não estão a funcionar neste momento?»
- «Porque é que a última publicação da shop falhou? Mostre a parte importante do log de compilação e explique-a.»
- «Procure erros 500 nos logs da api na última hora.»
- «Publique a shop e avise-me quando estiver online.»
- «Reverta a api para a versão anterior à última publicação.»
- «Defina FEATURE_CHECKOUT=on na shop e volte a publicá-la.»
- «Quantas encomendas foram criadas hoje? A tabela é orders.»
- «Adicione um registo TXT a example.com com o valor google-site-verification=abc.»
- «Crie uma base de dados e um utilizador para um novo site WordPress em example.com.»
- «Porque é que example.com mostra um erro 500? Leia o log de erros e corrija a definição no wp-config.php.»
- «Mude example.com para o PHP 8.3 e aumente o memory_limit para 512M.»
Se o assistente lhe pede confirmação antes de uma ação que altera algo — uma publicação, uma reversão, uma variável — depende da sua aplicação e das definições dela. O Claude, por exemplo, pergunta antes dessas ações, a não ser que o tenha autorizado a avançar sem perguntar.
Desligar
Em Definições da conta → Aplicações ligadas aparecem todas as aplicações ligadas à sua conta através do Rivervo MCP, com o nível de acesso e a data da última utilização. Desligar termina o acesso de imediato: para voltar a usá-la, é preciso ligar e autorizar de novo.
Remover o Rivervo MCP na sua aplicação só o retira dessa aplicação; para ter a certeza de que deixou de ter acesso, desligue-o também no painel.
Privacidade e segurança
- Inicia sessão numa página da própria Rivervo; o assistente nunca vê a sua palavra-passe. Recebe uma chave que só funciona com o Rivervo MCP — não com a API REST nem com o painel — e apenas com o nível de acesso que escolheu.
- A ligação mantém-se ativa enquanto for usada. Se ficar 90 dias sem ser usada, terá de iniciar sessão de novo.
- Só o titular pode aprovar uma ligação: alguém que tenha entrado na sua conta em seu nome não pode.
- O que o assistente lê através do Rivervo MCP — logs, variáveis que pede para ver, linhas da sua base de dados — passa a fazer parte da conversa nessa aplicação e é tratado segundo os termos e a política de privacidade do respetivo fornecedor (no Claude, a Anthropic; no ChatGPT, a OpenAI). Peça segredos apenas quando precisar deles.
- Cada alteração feita através do Rivervo MCP é uma alteração feita com a sua conta, com as mesmas regras e limites do painel e da API REST.
Consulte também Ferramentas para programadores para tokens da API, a API REST e a linha de comandos rivervo.