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.
Índice
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
- No painel, abra Configurações → API e MCP.
- 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.
- 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.
| Ferramenta | O que faz |
|---|---|
get_overviewleitura | A 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_serversleitura | Os servidores, com estado, último sinal e versão do agente. |
list_plansleitura | Os planos, com servidor, armazenamento, agenda (ou o plano depois do qual rodam), última e próxima execução. |
get_planleitura | Um 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_backupsleitura | As 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_backupleitura | Uma 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_storagesleitura | Os armazenamentos, com versionamento e Object Lock. |
list_restore_proofsleitura | Para cada servidor e armazenamento: quando o teste de restauração por amostra provou que o backup restaura, ou se falhou. |
list_eventsleitura | Os 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ção | Executa agora um plano ativo. Plano pausado é recusado: a pausa foi de propósito, retome antes. |
pause_planoperação | Pede para pausar um plano. Nada é apagado; só pausa depois de o dono do token aprovar no painel. |
resume_planoperação | Retoma um plano pausado. |
create_planoperação | Pede 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ção | Pede 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_accountsleitura | As 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ção | Pede 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ção | Pede 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ção | Pede 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_approvalleitura | Mostra 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 →