mka1 es la interfaz de línea de comandos oficial para la API de MKA1.
Cada operación que puedes llamar a través de la API REST está disponible como un comando, con flags, canalización de stdin, múltiples formatos de salida y un explorador de comandos interactivo.
Úsala para:
- Automatizar llamadas puntuales a la API y trabajos de CI sin necesidad de un SDK.
- Inspeccionar datos en vivo rápidamente — listar respuestas, descargar archivos, buscar en un almacén vectorial.
- Prototipar cuerpos de solicitud antes de trasladarlos al SDK de TypeScript, C# o Python.
Instalación
Los binarios precompilados para cada plataforma compatible están disponibles en downloads.mka1.com. Las URLs*-latest siempre redirigen a la versión más reciente, por lo que puedes marcarlas en scripts y CI.
| Plataforma | Arquitectura | Descarga |
|---|---|---|
| macOS | arm64 (Apple silicon) | mka1_darwin_arm64-latest.tar.gz |
| macOS | x86_64 (Intel) | mka1_darwin_x86_64-latest.tar.gz |
| Linux | x86_64 (Debian/Ubuntu) | mka1_linux_x86_64-latest.deb |
| Linux | x86_64 (RHEL/Fedora) | mka1_linux_x86_64-latest.rpm |
| Windows | x86_64 | mka1_windows_x86_64-latest.zip |
macOS
arm64 por x86_64 en Macs con Intel.
Linux
Windows
Descargamka1_windows_x86_64-latest.zip, descomprímelo y agrega la carpeta que contiene mka1.exe a tu variable PATH.
Verifica la instalación
Imprime la versión de la CLI para confirmar que el binario está en tuPATH:
--help, que imprime una descripción, uso y los flags aplicables:
Habilita la autocompletación de shell
Las autocompletaciones se generan bajo demanda y cubren subcomandos, flags y valores conocidos de enums.Ejecuta tu primera solicitud
Autentícate una vez y luego llama a cualquier endpoint. La forma más rápida es establecer tu clave en una variable de entorno y generar una respuesta:Explora de forma interactiva
mka1 explore inicia una interfaz de usuario en la terminal que te permite explorar cada grupo de comandos, inspeccionar los flags de cada comando y ejecutarlo sin salir de la shell:
Próximos pasos
- Autenticar la CLI — configura credenciales e identidad del usuario final.
- Comandos — un recorrido por los grupos de comandos con ejemplos prácticos.
- Enviar cuerpos de solicitud — combina flags individuales,
--bodyy stdin. - Formatear y filtrar la salida — alterna entre JSON, YAML, tabla y TOON, y transforma resultados con jq.
- Depurar e inspeccionar — previsualiza solicitudes con
--dry-run, trázalas con--debugy habilita el modo agente.