Pular para o conteúdo

← Documentação

MCP do Arkame

Pergunte ao seu assistente de IA como foram os backups desta noite, por que um servidor falhou ou se a restauração está comprovada, e peça para executar ou criar um plano. O Arkame fala o Model Context Protocol (MCP), hospedado: não há nada a instalar.

Experimente sem conta

Para ver o MCP funcionando antes de criar a conta, use o token público da demonstração. Ele só lê a Harborline Logistics, uma empresa fictícia com quatro servidores (um deles com Zimbra) e 90 dias de backups. Todo pedido de mudança é recusado.

No Claude Code:

claude mcp add --transport http arkame-demo https://save.arkame.app/api/mcp \
  --header "Authorization: Bearer ark_demo3udDYUJZLkUyggylcEst_-so91lJrIC4idHYcgY"

Nos outros clientes, use a configuração da seção Conectar com este token.

Perguntas para começar:

  • "Como foram os backups desta noite na Harborline?"
  • "Quais contas do Zimbra estão no último backup do mail-01? Alguma saiu do Zimbra?"
  • "Algum backup falhou nos últimos 30 dias? Por quê?"
  • "A restauração está comprovada em todos os servidores?"

Os dados são fictícios e são regravados a cada poucas horas. O token é o mesmo para todos, e os limites contam por endereço IP.

Crie um token

  1. No painel, abra Configurações → API e MCP.
  2. Dê um nome, escolha o escopo (Leitura, ou Leitura e operação) e a validade (até um ano). Confirme com o código da verificação em duas etapas.
  3. Copie o token (ark_…): ele aparece uma vez só. A mesma tela traz a configuração pronta para colar.

O token nunca pode mais do que o seu papel na organização, lido a cada chamada: se o seu papel mudar, ou se você sair da organização, o token muda junto. Quem administra vê e revoga os tokens de todos.

Conecte o assistente

O servidor fica em https://save.arkame.app/api/mcp, por HTTP, com o token no cabeçalho Authorization: Bearer.

Claude Code

claude mcp add --transport http arkame https://save.arkame.app/api/mcp \
  --header "Authorization: Bearer ark_…"

Claude Desktopclaude_desktop_config.json

{
  "mcpServers": {
    "arkame": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://save.arkame.app/api/mcp",
        "--header",
        "Authorization:${ARKAME_AUTH}"
      ],
      "env": {
        "ARKAME_AUTH": "Bearer ark_…"
      }
    }
  }
}

Cursor~/.cursor/mcp.json

{
  "mcpServers": {
    "arkame": {
      "url": "https://save.arkame.app/api/mcp",
      "headers": {
        "Authorization": "Bearer ark_…"
      }
    }
  }
}

VS Code.vscode/mcp.json

{
  "servers": {
    "arkame": {
      "type": "http",
      "url": "https://save.arkame.app/api/mcp",
      "headers": {
        "Authorization": "Bearer ark_…"
      }
    }
  }
}

Outro cliente compatível com MCP por HTTP serve do mesmo jeito: o endereço e o cabeçalho.

O que o assistente pode fazer

Ferramentas de leitura estão em qualquer token; as de operação, só no token de operação de quem opera planos.

FerramentaO que faz
get_overviewleituraA saúde da organização agora: servidores com e sem sinal, backups dos últimos 7 dias por desfecho, anomalias abertas (possível ransomware) e comprovações de restauração que falharam ou envelheceram. O ponto de partida.
list_serversleituraOs servidores, com estado, último sinal e versão do agente.
list_plansleituraOs planos, com servidor, armazenamento, agenda (ou o plano depois do qual rodam), última e próxima execução.
get_planleituraUm plano: pastas, exclusões, agenda, instantâneo, se tem comandos antes e depois (o texto deles nunca sai) e as 10 últimas execuções.
list_backupsleituraAs execuções de backup, das mais novas para as mais antigas, com os arquivos que ficaram de fora ao lado do total, e filtros por desfecho, servidor e período.
get_backupleituraUma execução: desfecho, contagens (inclusive os arquivos que falharam e os que estão só na nuvem), o erro resumido, como os arquivos foram lidos (instantâneo ou disco) e a avaliação de anomalia. Os caminhos dos arquivos ficam só no painel.
list_storagesleituraOs armazenamentos, com versionamento e Object Lock.
list_restore_proofsleituraPara cada servidor e armazenamento: quando o teste de restauração por amostra provou que o backup restaura, ou se falhou.
list_eventsleituraOs eventos recentes, os mesmos dos webhooks (backup.failed, agent.offline, anomaly.detected, storage.config_changed…), com quem mudou o quê, quando se sabe.
run_planoperaçãoExecuta agora um plano ativo. Plano pausado é recusado: a pausa foi de propósito, retome antes.
pause_planoperaçãoPede para pausar um plano. Nada é apagado; só pausa depois de o dono do token aprovar no painel.
resume_planoperaçãoRetoma um plano pausado.
create_planoperaçãoPede um plano de backup novo, com agenda própria ou depois de outro plano do mesmo servidor. Só nasce depois de o dono do token aprovar no painel. Sem comandos antes e depois, e sem pastas de chaves e senhas do sistema. O agente (0.5.5 ou mais novo) confere também o caminho real, depois dos atalhos, antes de cada backup; o 0.5.6 confere ainda cada arquivo na hora de ler, e o que ficou de fora aparece no detalhe do backup.
update_planoperaçãoPede para mudar nome, pastas, exclusões, agenda ou instantâneo de um plano, com o antes e o depois. Só muda depois de o dono do token aprovar no painel. Servidor, armazenamento e comandos não mudam por aqui.
list_zimbra_accountsleituraAs contas do Zimbra no último backup de um plano com a receita do Zimbra: meses de e-mail, tamanho e se a última exportação da conta falhou ou se a conta saiu da exportação.
create_serveroperaçãoPede o cadastro de um servidor ligado a um armazenamento. Só proprietário e administrador. Depois de aprovado, o assistente recebe uma vez o código e os comandos de instalação; o servidor instalado ainda é aprovado no painel.
restore_filesoperaçãoPede para restaurar uma pasta de um backup no mesmo servidor, numa pasta nova dentro dela (arkame-restore- e a data), sem sobrescrever nada. Restaurar por cima dos originais, ou em outro servidor, só pelo painel.
restore_zimbra_accountoperaçãoPede para restaurar uma conta do Zimbra de um backup. Só mescla: o que está na caixa fica, o que faltava volta, nada é apagado nem substituído. Na própria conta, ou numa conta nova que ainda não existe (uma que já existe é recusada). A configuração e os encaminhamentos não voltam por aqui. Só proprietário e administrador.
get_approvalleituraMostra um pedido de aprovação: esperando, aprovado (com o resultado), recusado, que falhou ou vencido (15 minutos). No cadastro de servidor aprovado, a primeira consulta traz o código de instalação.

Nada muda sem o dono do token. Criar, editar e pausar um plano, cadastrar um servidor e restaurar viram um pedido de aprovação: aparece numa janela do painel para o dono do token, com o detalhe da ação, o token, o IP e a região, e só acontece depois de aprovado com o código da verificação em duas etapas. Quem não reconhece o pedido revoga o token ali mesmo. O pedido vence em 15 minutos. Executar e retomar agem na hora.

Nunca pelo MCP: retenção e exclusão definitiva, comandos antes e depois do backup, arquivar, membros, cobrança, webhooks e tokens. É o que um token vazado (ou um assistente enganado por um texto malicioso) não consegue destruir. Para isso, use o painel.

Limites

  • Por token: 60 chamadas por minuto e 2000 por dia.
  • Por organização, somando os tokens: 300 chamadas por minuto.
  • Ferramentas de operação: 10 por minuto por token.
  • Por dia, por token: executar até 20; retomar até 10; pedidos para criar plano ou servidor até 5 (cada um), para editar até 10, para pausar até 5 e para restaurar até 10. Pedido recusado também conta.
  • Uma chamada por pedido: lote JSON-RPC não é aceito.
  • Listas com até 50 linhas por chamada.
  • Toda ação de operação fica no registro de ações, com o nome do token.

Exemplos de pedido

  • "Como foram os backups desta noite? Algum servidor sem sinal?"
  • "Por que o backup do erp-01 falhou ontem, e desde quando?"
  • "Quais servidores estão com a restauração comprovada há mais de 14 dias?"
  • "Execute agora o plano diário do servidor de arquivos."
  • "Crie um plano que copie as mesmas pastas do erp-01 para o bucket da nuvem, depois do backup local."

A confirmação não depende do assistente: criar, editar e pausar planos, cadastrar servidor e restaurar só acontecem depois de o dono do token aprovar numa janela do painel, com o código da verificação em duas etapas, que nunca passa pelo chat. A janela mostra o token, o IP, a região e o programa que fez o pedido; quem não o reconhece recusa e revoga o token ali mesmo. O pedido vence em 15 minutos. O texto que volta das ferramentas (nomes de planos, servidores e arquivos) é dado da organização, e o servidor avisa ao assistente que não é instrução.

Pronto para conectar?

Os tokens ficam em Configurações → API e MCP, no painel.

Criar um token no painel →