Saltar al contenido

← Documentación

MCP de Arkame

Pregúntale a tu asistente de IA cómo fueron las copias de anoche, por qué falló un servidor o si la restauración está comprobada, y pídele que ejecute o cree un plan. Arkame habla el Model Context Protocol (MCP), alojado: no hay nada que instalar.

Pruébalo sin cuenta

Para ver el MCP funcionando antes de crear la cuenta, usa el token público de la demostración. Solo lee Harborline Logistics, una empresa ficticia con cuatro servidores (uno de ellos con Zimbra) y 90 días de backups. Todo pedido de cambio se rechaza.

En Claude Code:

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

En los otros clientes, usa la configuración de la sección Conectar con este token.

Preguntas para empezar:

  • "¿Cómo salieron los backups de esta noche en Harborline?"
  • "¿Qué cuentas de Zimbra están en el último backup de mail-01? ¿Alguna salió de Zimbra?"
  • "¿Falló algún backup en los últimos 30 días? ¿Por qué?"
  • "¿Está comprobada la restauración en todos los servidores?"

Los datos son ficticios y se regraban cada pocas horas. El token es el mismo para todos, y los límites cuentan por dirección IP.

Crea un token

  1. En el panel, abre Configuración → API y MCP.
  2. Ponle un nombre, elige el alcance (Lectura, o Lectura y operación) y la validez (hasta un año). Confirma con el código de la verificación en dos pasos.
  3. Copia el token (ark_…): aparece una sola vez. La misma pantalla trae la configuración lista para pegar.

El token nunca puede más que tu rol en la organización, comprobado en cada llamada: si tu rol cambia, o sales de la organización, el token cambia también. Quien administra ve y revoca los tokens de todos.

Conecta el asistente

El servidor está en https://save.arkame.app/api/mcp, por HTTP, con el token en el encabezado 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_…"
      }
    }
  }
}

Cualquier otro cliente MCP por HTTP sirve igual: la dirección y el encabezado.

Qué puede hacer el asistente

Las herramientas de lectura están en cualquier token; las de operación, solo en el token de operación de quien opera planes.

HerramientaQué hace
get_overviewlecturaLa salud de la organización ahora: servidores con y sin señal, copias de los últimos 7 días por resultado, anomalías abiertas (posible ransomware) y comprobaciones de restauración que fallaron o envejecieron. El punto de partida.
list_serverslecturaLos servidores, con estado, última señal y versión del agente.
list_planslecturaLos planes, con servidor, almacenamiento, programación (o el plan después del cual corren), última y próxima ejecución.
get_planlecturaUn plan: carpetas, exclusiones, programación, instantánea, si tiene comandos antes y después (su texto nunca sale) y las 10 últimas ejecuciones.
list_backupslecturaLas ejecuciones de backup, de la más nueva a la más antigua, con los archivos que quedaron fuera junto al total, y filtros por resultado, servidor y período.
get_backuplecturaUna ejecución: resultado, conteos (incluidos los archivos que fallaron y los que están solo en la nube), el error resumido, cómo se leyeron los archivos (instantánea o disco) y la evaluación de anomalía. Las rutas de los archivos quedan solo en el panel.
list_storageslecturaLos almacenamientos, con versionado y Object Lock.
list_restore_proofslecturaPara cada servidor y almacenamiento: cuándo la prueba de restauración por muestra probó que la copia se restaura, o si falló.
list_eventslecturaLos eventos recientes, los mismos de los webhooks (backup.failed, agent.offline, anomaly.detected, storage.config_changed…), con quién cambió qué, cuando se sabe.
run_planoperaciónEjecuta ahora un plan activo. Un plan pausado se rechaza: la pausa fue a propósito, reanúdalo antes.
pause_planoperaciónPide pausar un plan. No se borra nada; solo se pausa después de que el dueño del token lo apruebe en el panel.
resume_planoperaciónReanuda un plan en pausa.
create_planoperaciónPide un plan de backup nuevo, con agenda propia o después de otro plan del mismo servidor. Solo se crea después de que el dueño del token lo apruebe en el panel. Sin comandos antes y después, y sin carpetas de claves y contraseñas del sistema. El agente (0.5.5 o más nuevo) también comprueba la ruta real, después de los accesos directos, antes de cada backup; el 0.5.6 comprueba además cada archivo al leerlo, y lo que quedó fuera aparece en el detalle del backup.
update_planoperaciónPide cambiar nombre, carpetas, exclusiones, agenda o instantánea de un plan, con el antes y el después. Solo cambia después de que el dueño del token lo apruebe en el panel. Servidor, almacenamiento y comandos no cambian por aquí.
list_zimbra_accountslecturaLas cuentas de Zimbra en el último backup de un plan con la receta de Zimbra: meses de correo, tamaño y si la última exportación de la cuenta falló o si la cuenta salió de la exportación.
create_serveroperaciónPide registrar un servidor vinculado a un almacenamiento. Solo propietarios y administradores. Una vez aprobado, el asistente recibe una sola vez el código y los comandos de instalación; el servidor instalado todavía se aprueba en el panel.
restore_filesoperaciónPide restaurar una carpeta de un backup en el mismo servidor, en una carpeta nueva dentro de ella (arkame-restore- y la fecha), sin sobrescribir nada. Restaurar sobre los originales, o en otro servidor, solo desde el panel.
restore_zimbra_accountoperaciónPide restaurar una cuenta de Zimbra desde un backup. Solo combina: lo que está en el buzón se queda, lo que faltaba vuelve, no se borra ni se sustituye nada. En la misma cuenta, o en una cuenta nueva que aún no existe (una que ya existe se rechaza). La configuración y los reenvíos no vuelven por aquí. Solo propietarios y administradores.
get_approvallecturaMuestra una solicitud de aprobación: esperando, aprobada (con el resultado), rechazada, fallida o vencida (15 minutos). En el registro de servidor aprobado, la primera consulta trae el código de instalación.

Nada cambia sin el dueño del token. Crear, editar y pausar un plan, registrar un servidor y restaurar se convierten en una solicitud de aprobación: aparece en una ventana del panel para el dueño del token, con el detalle de la acción, el token, la IP y la región, y solo ocurre después de aprobarla con el código de la verificación en dos pasos. Quien no reconoce la solicitud revoca el token ahí mismo. La solicitud vence en 15 minutos. Ejecutar y reanudar actúan al instante.

Nunca por MCP: retención y borrado definitivo, comandos antes y después de la copia, archivar, miembros, facturación, webhooks y tokens. Es lo que un token filtrado (o un asistente engañado por un texto malicioso) no puede destruir. Para eso, usa el panel.

Límites

  • Por token: 60 llamadas por minuto y 2000 por día.
  • Por organización, sumando los tokens: 300 llamadas por minuto.
  • Herramientas de operación: 10 por minuto por token.
  • Por día, por token: ejecutar hasta 20; reanudar hasta 10; solicitudes para crear plan o servidor hasta 5 (cada uno), para editar hasta 10, para pausar hasta 5 y para restaurar hasta 10. Una solicitud rechazada también cuenta.
  • Una llamada por pedido: no se aceptan lotes JSON-RPC.
  • Listas con hasta 50 filas por llamada.
  • Cada acción de operación queda en el registro de acciones, con el nombre del token.

Ejemplos de pedido

  • "¿Cómo fueron las copias de anoche? ¿Algún servidor sin señal?"
  • "¿Por qué falló ayer la copia del erp-01, y desde cuándo?"
  • "¿Qué servidores llevan más de 14 días sin restauración comprobada?"
  • "Ejecuta ahora el plan diario del servidor de archivos."
  • "Crea un plan que copie las mismas carpetas del erp-01 al bucket de la nube, después de la copia local."

La confirmación no depende del asistente: crear, editar y pausar planes, registrar servidores y restaurar solo ocurren después de que el dueño del token lo apruebe en una ventana del panel, con el código de la verificación en dos pasos, que nunca pasa por el chat. La ventana muestra el token, la IP, la región y el programa que hizo la solicitud; quien no la reconoce la rechaza y revoca el token ahí mismo. La solicitud vence en 15 minutos. El texto que vuelve de las herramientas (nombres de planes, servidores y archivos) es dato de la organización, y el servidor avisa al asistente que no es una instrucción.

¿Listo para conectar?

Los tokens están en Configuración → API y MCP, en el panel.

Crear un token en el panel →