# MKA1: Spanish Referencia API Tools and sandbox

## Tools and sandbox

### MCP Vault

- [Crear servidor MCP](https://docs.mka1.com/api-reference/mcp-vault/crear-servidor-mcp.md): Crea una configuración de servidor MCP de propiedad del usuario. Las credenciales secretas se almacenan por separado.
- [Listar servidores MCP](https://docs.mka1.com/api-reference/mcp-vault/listar-servidores-mcp.md): Listas as configurações do servidor MCP pertencentes ao contexto do usuário autenticado.
- [Recuperar servidor MCP](https://docs.mka1.com/api-reference/mcp-vault/recuperar-servidor-mcp.md): Retorna uma configuração de servidor MCP de propriedade do usuário.
- [Actualizar servidor MCP](https://docs.mka1.com/api-reference/mcp-vault/actualizar-servidor-mcp.md): Actualiza parcialmente la configuración del servidor MCP propiedad del usuario.
- [Eliminar servidor MCP](https://docs.mka1.com/api-reference/mcp-vault/eliminar-servidor-mcp.md): Elimina suavemente un servidor MCP propiedad del usuario y revoca sus credenciales.
- [Crear credencial MCP](https://docs.mka1.com/api-reference/mcp-vault/crear-credencial-mcp.md): Almacena credenciales encriptadas para un servidor MCP de propiedad del usuario. Los valores secretos nunca se devuelven.
- [Lista de credenciales MCP](https://docs.mka1.com/api-reference/mcp-vault/lista-de-credenciales-mcp.md): Lista de metadatos de credenciales encriptadas para un servidor MCP de propiedad del usuario.
- [Eliminar credencial MCP](https://docs.mka1.com/api-reference/mcp-vault/eliminar-credencial-mcp.md): Revoca una credencial MCP propiedad del usuario.
- [Servidor de prueba MCP](https://docs.mka1.com/api-reference/mcp-vault/servidor-de-prueba-mcp.md): Se conecta a un servidor MCP utilizando la credencial almacenada del usuario autenticado y devuelve los nombres de las herramientas descubiertas. Las conexiones fallidas devuelven un error 502; los detalles de la conexión se conservan en registros del servidor redactados.

### Skills

- [Crear habilidad](https://docs.mka1.com/api-reference/skills/crear-habilidad.md): Crea una nueva habilidad subiendo archivos. Los archivos subidos deben incluir un manifiesto SKILL.md. Acepta datos de formulario multipart con archivos individuales o un único archivo zip.
- [Lista de habilidades](https://docs.mka1.com/api-reference/skills/lista-de-habilidades.md): Devuelve una lista paginada de habilidades.
- [Recuperar habilidad](https://docs.mka1.com/api-reference/skills/recuperar-habilidad.md): Devuelve información sobre una habilidad específica.
- [Actualizar habilidad](https://docs.mka1.com/api-reference/skills/actualizar-habilidad.md): Actualiza el puntero de versión predeterminado para una habilidad.
- [Eliminar habilidad](https://docs.mka1.com/api-reference/skills/eliminar-habilidad.md): Eliminar una habilidad y todas sus versiones.
- [Descargar contenido de habilidades](https://docs.mka1.com/api-reference/skills/descargar-contenido-de-habilidades.md): Descarga el paquete zip para la versión predeterminada de una habilidad.
- [Crear versión de habilidad](https://docs.mka1.com/api-reference/skills/crear-versión-de-habilidad.md): Crea una nueva versión inmutable de una habilidad subiendo archivos. Los archivos subidos deben incluir un manifiesto SKILL.md.
- [Listar versiones de habilidades](https://docs.mka1.com/api-reference/skills/listar-versiones-de-habilidades.md): Devuelve una lista paginada de versiones para una habilidad.
- [Recuperar versión de habilidad](https://docs.mka1.com/api-reference/skills/recuperar-versión-de-habilidad.md): Devuelve información sobre una versión específica de la habilidad.
- [Eliminar versión de habilidad](https://docs.mka1.com/api-reference/skills/eliminar-versión-de-habilidad.md): Eliminar una versión específica de una habilidad.
- [Descargar contenido de la versión de habilidad](https://docs.mka1.com/api-reference/skills/descargar-contenido-de-la-versión-de-habilidad.md): Descarga el paquete zip para una versión específica de la habilidad.
- [Lista de habilidades preconfiguradas](https://docs.mka1.com/api-reference/skills/lista-de-habilidades-preconfiguradas.md): Devuelve la lista de habilidades preconfiguradas que vienen con la puerta de enlace. Estas se pueden referenciar en las definiciones de herramientas de shell como { tipo: 'preconfigurado', nombre: '...' }.

### Sessions

- [Crear sesión](https://docs.mka1.com/api-reference/sessions/crear-sesión.md): Crea una sesión de sandbox y devuelve sus metadatos públicos de sesión, el token de sesión y el proveedor. Establece `session_kind` en `browser` para iniciar una sesión respaldada por navegador en lugar de un sandbox estándar de comandos/código. Establece `queue_if_full` en `true` para poner la soli…
- [Lista de sesiones](https://docs.mka1.com/api-reference/sessions/lista-de-sesiones.md): Lista de sesiones de sandbox visibles para el llamador autenticado.
- [Obtener Sesión](https://docs.mka1.com/api-reference/sessions/obtener-sesión.md): Devuelve el estado actual, la configuración y la asignación de recursos para una sesión de sandbox.
- [Finalizar sesión](https://docs.mka1.com/api-reference/sessions/finalizar-sesión.md): Detener una sesión de sandbox y liberar los recursos de sandbox de respaldo.

### Execution

- [Ejecutar comando](https://docs.mka1.com/api-reference/execution/ejecutar-comando.md): Ejecuta un comando en el espacio de trabajo de la sesión y devuelve stdout, stderr, código de salida y archivos cambiados.
- [Ejecutar Código](https://docs.mka1.com/api-reference/execution/ejecutar-código.md): Ejecuta el código fuente en el espacio de trabajo de la sesión utilizando un tiempo de ejecución compatible y devuelve el resultado de la ejecución.

### Workspace

- [Obtener el manifiesto del espacio de trabajo](https://docs.mka1.com/api-reference/workspace/obtener-el-manifiesto-del-espacio-de-trabajo.md): Lista los archivos actualmente almacenados en el espacio de trabajo de la sesión, incluidos caminos, tamaños y etags.
- [Descargar archivo de espacio de trabajo](https://docs.mka1.com/api-reference/workspace/descargar-archivo-de-espacio-de-trabajo.md): Descargar bytes en bruto de un archivo en el espacio de trabajo de la sesión.
- [Subir archivo de espacio de trabajo](https://docs.mka1.com/api-reference/workspace/subir-archivo-de-espacio-de-trabajo.md): Cargue bytes en bruto en el espacio de trabajo de la sesión en la ruta dada.
- [Descargar archivo del espacio de trabajo](https://docs.mka1.com/api-reference/workspace/descargar-archivo-del-espacio-de-trabajo.md): Descarga un archivo zip que contiene las rutas del espacio de trabajo seleccionadas.
- [Cargar Archivo del Espacio de Trabajo](https://docs.mka1.com/api-reference/workspace/cargar-archivo-del-espacio-de-trabajo.md): Sube un archivo zip y extrae sus archivos en el espacio de trabajo de la sesión.

### Sandbox Usage

- [Obtener uso del sandbox](https://docs.mka1.com/api-reference/sandbox-usage/obtener-uso-del-sandbox.md): Agregue el uso del sandbox (ciclo de vida de la sesión, ejecución y operaciones del espacio de trabajo) en un rango de tiempo, agrupado en intervalos y opcionalmente por grupos. Los intervalos están alineados con el calendario en UTC: `start_time` se ajusta hacia abajo y `end_time` se ajusta hacia a…

### Sandbox Pricing

- [Obtén precios de Sandbox](https://docs.mka1.com/api-reference/sandbox-pricing/obtén-precios-de-sandbox.md): Tarjeta de tarifas de precios actual del entorno aislado, asociada por SKU (`standard`, `browser`, `eval-python`). El uso medido del entorno aislado se factura como `horas × (por_hora + memoria_reservada_GiB × por_gib_hora)`; los SKU sin una tarifa configurada no generan gasto. Solo administradores…
- [Establecer precios del entorno de pruebas](https://docs.mka1.com/api-reference/sandbox-pricing/establecer-precios-del-entorno-de-pruebas.md): Reemplaza la tarjeta de tarifas de precios del sandbox. Semántica de reemplazo completo. Omitir un SKU que actualmente tiene un precio se rechaza con 422 a menos que `allow_unpriced` sea verdadero: un SKU sin precio no acumula gasto y su uso no puede facturarse. Una `currency` que difiere de la alma…

### Browser

- [Obtener URL de la sesión del navegador](https://docs.mka1.com/api-reference/browser/obtener-url-de-la-sesión-del-navegador.md): Devuelve la URL pública de la puerta de enlace para el punto final del Protocolo Chrome DevTools de una sesión de navegador. Playwright puede usar directamente este punto final HTTP. Para clientes que requieren un punto final WebSocket, solicita `json/version` y usa su `webSocketDebuggerUrl` reescri…
- [Obtener URL de sesión del navegador (Obsoleto)](https://docs.mka1.com/api-reference/browser/obtener-url-de-sesión-del-navegador-obsoleto.md): Alias de compatibilidad obsoleto para `getBrowserUrl`. Devuelve la URL pública de la puerta de enlace para el punto de conexión del Protocolo de Chrome DevTools de una sesión del navegador. Las sesiones estándar no exponen una URL pública; utiliza en su lugar el comando, el código y las operaciones…
- [Solicitud de puerto del navegador proxy](https://docs.mka1.com/api-reference/browser/solicitud-de-puerto-del-navegador-proxy.md): Proxy una solicitud HTTP a un puerto de sesión del navegador expuesto a través de la pasarela. Use la URL devuelta por `GET /sessions/{session_id}/browser-url` como base. Inserte subrutas de CDP como `json/version` o `json/list` antes de su cadena de consulta, preservando el parámetro `session_token…

### Sandbox GitHub

- [Iniciar autorización de GitHub](https://docs.mka1.com/api-reference/sandbox-github/iniciar-autorización-de-github.md): Comience a conectar la cuenta de GitHub del llamante. Envíe al usuario a la `authorize_url` devuelta. GitHub redirige de vuelta con un `code` y el mismo `state`; pase ambos a `POST /github/oauth/connections` antes de que transcurran `expires_in_seconds`. Cada `state` solo funciona una vez.
- [Conectar cuenta de GitHub](https://docs.mka1.com/api-reference/sandbox-github/conectar-cuenta-de-github.md): Finalizar la autorización de GitHub intercambiando el `code` y el `state` de la redirección de GitHub por una conexión almacenada. El servicio sandbox mantiene el token de acceso cifrado y nunca lo devuelve. La respuesta enumera los repositorios a los que la conexión puede acceder.
- [Obtener conexión de GitHub](https://docs.mka1.com/api-reference/sandbox-github/obtener-conexión-de-github.md): Devuelve la conexión de GitHub del llamador, o `null` cuando no haya ninguna. `token_invalid_at` se establece una vez que GitHub ha rechazado el token almacenado; vuelve a conectar para arreglarlo. Establece `verify` en `true` para comprobar el token con GitHub ahora en lugar de en su próximo uso.
- [Desconectar cuenta de GitHub](https://docs.mka1.com/api-reference/sandbox-github/desconectar-cuenta-de-github.md): Elimina la conexión de GitHub del autor de la llamada y revoca su token en GitHub. La conexión se elimina incluso si GitHub no confirma la revocación.
- [Lista de repositorios de GitHub](https://docs.mka1.com/api-reference/sandbox-github/lista-de-repositorios-de-github.md): Enumera los repositorios registrados para la conexión de GitHub del llamador, o una lista vacía cuando no haya ninguna conexión. La lista se captura cuando te conectas; llama a `POST /github/repositories/refresh` para actualizarla.
- [Actualizar repositorios de GitHub](https://docs.mka1.com/api-reference/sandbox-github/actualizar-repositorios-de-github.md): Vuelve a leer los repositorios a los que la conexión de GitHub del llamante puede acceder, guárdalos como la lista de repositorios de la conexión y devuélvela.
- [Resolver la referencia de GitHub](https://docs.mka1.com/api-reference/sandbox-github/resolver-la-referencia-de-github.md): Resuelve una referencia de Git en un repositorio conectado a un SHA de commit. Omite `ref` para resolver la rama predeterminada del repositorio.
- [Clonar repositorio de GitHub en la sesión](https://docs.mka1.com/api-reference/sandbox-github/clonar-repositorio-de-github-en-la-sesión.md): Clona un repositorio conectado en `base_sha` en el espacio de trabajo de la sesión usando la conexión de GitHub del llamador. El host del sandbox ejecuta la clonación, por lo que el token nunca entra en la sesión.
- [Listar repositorios de sesión](https://docs.mka1.com/api-reference/sandbox-github/listar-repositorios-de-sesión.md): Devuelve los repositorios añadidos a la sesión con la referencia de cada uno, la ruta de checkout, el estado del clon, el último push y la solicitud de extracción, además del límite de repositorios por sesión.
- [Agregar repositorio de sesión](https://docs.mka1.com/api-reference/sandbox-github/agregar-repositorio-de-sesión.md): Agrega un repositorio conectado a la sesión y clónalo en `ref`, o en la rama predeterminada cuando se omite `ref`. Repetir la misma solicitud es seguro. Después de una clonación exitosa, la ref del repositorio no puede cambiar.
- [Descartar repositorio de sesión fallida](https://docs.mka1.com/api-reference/sandbox-github/descartar-repositorio-de-sesión-fallida.md): Elimine de la sesión un repositorio cuya clonación haya fallado. No se puede eliminar un repositorio que se clonó correctamente o cuya clonación aún está en curso.
- [Enviar la sesión a GitHub](https://docs.mka1.com/api-reference/sandbox-github/enviar-la-sesión-a-github.md): Empuja el checkout de la sesión a `branch` en el repositorio del que se clonó, usando la conexión de GitHub del llamante. El repositorio siempre proviene de la sesión, nunca de la solicitud. Establece `checkout_path` cuando el repositorio no esté en la raíz del espacio de trabajo.
- [Crear o actualizar solicitud de extracción](https://docs.mka1.com/api-reference/sandbox-github/crear-o-actualizar-solicitud-de-extracción.md): Abra una solicitud de extracción desde `branch` en el repositorio de la sesión, o actualice la que ya esté registrada para esa rama, volviéndola a abrir si se había cerrado. La base, de forma predeterminada, es la rama predeterminada del repositorio. Una solicitud de extracción fusionada nunca se vu…

### Sandbox Environments

- [Lista de entornos](https://docs.mka1.com/api-reference/sandbox-environments/lista-de-entornos.md): Enumere los entornos guardados del llamante, además del límite de repositorios por entorno.
- [Crear entorno](https://docs.mka1.com/api-reference/sandbox-environments/crear-entorno.md): Guardar un entorno con nombre: repositorios para clonar, variables de entorno, acceso a la red y un script de configuración de bash opcional. Las sesiones creadas a partir de él copian esta configuración. No pongas secretos en `environment_variables`.
- [Obtener entorno](https://docs.mka1.com/api-reference/sandbox-environments/obtener-entorno.md): Devuelve uno de los entornos guardados del llamante.
- [Actualizar entorno](https://docs.mka1.com/api-reference/sandbox-environments/actualizar-entorno.md): Reemplace la configuración de un entorno guardado. Omita `network_access` para mantener el valor almacenado. Las sesiones ya creadas a partir del entorno conservan la configuración con la que comenzaron.
- [Eliminar entorno](https://docs.mka1.com/api-reference/sandbox-environments/eliminar-entorno.md): Eliminar un entorno guardado. Las sesiones ya creadas a partir de él no se ven afectadas.
- [Configuración del entorno de ejecución](https://docs.mka1.com/api-reference/sandbox-environments/configuración-del-entorno-de-ejecución.md): Ejecute el script de configuración del entorno desde el que se creó la sesión. Llámelo una vez que se hayan clonado los repositorios de la sesión. Un estado `running` significa que la configuración aún no ha finalizado y volver a llamarlo es seguro; una vez que la configuración se haya completado co…

## OpenAPI Specs

- [speakeasy](https://apigw.mka1.com/speakeasy.json?language=es)
- [speakeasy](https://apigw.mka1.com/speakeasy.json?language=pt-BR)