alt
Documentación para desarrolladores

Documentación para desarrolladores

CLI

Configura integraciones de Alt desde la terminal con un asistente de configuración interactivo.

La CLI altalt te guía por la configuración de MCP, la API REST y webhooks sin reemplazar configuraciones existentes. Ejecútala desde el directorio del proyecto que quieres conectar:

npx
npx altalt

Requiere Node.js 18 o posterior. npx descarga el paquete CLI actual para esta ejecución; no hace falta instalarlo globalmente.

Qué hace el asistente de configuración

  1. 1

    Conectar MCP

    Detecta Claude Code y Codex, ofrece la configuración de Cursor y conecta el servidor MCP alojado de Alt mediante OAuth en el navegador. Consulta MCP para configurarlo manualmente.

  2. 2

    Verificar API y webhooks

    Abre la consola de la cuenta, valida la clave API pegada, la guarda en el proyecto actual y puede enviar, tras confirmación, un evento de prueba al endpoint webhook elegido.

  3. 3

    Entregar la implementación

    Tras confirmarlo, entrega a tu agente de código un prompt basado en la documentación para desarrolladores legible por máquinas. Si no hay un agente compatible, imprime el prompt para pegarlo.

Modos y opciones

--mcp-onlyLimita la configuración a MCP con OAuth en el navegador y después ofrece la entrega al agente.
--api-onlyLimita la configuración a verificar la API REST y webhooks y después ofrece la entrega al agente.
--print-promptImprime el prompt para el agente de código y sale.
--devUsa el entorno de desarrollo. Solo para QA previa a lanzamientos.
--versionImprime la versión instalada de la CLI.
--helpImprime el uso del comando y las opciones disponibles.

Seguridad de configuración y claves

  • La CLI verifica la clave antes de cambiar un archivo de entorno y la guarda como ALT_API_KEY en el directorio del proyecto actual.
  • Las configuraciones MCP de Alt existentes no se eliminan ni sobrescriben. Cuando es necesario, OAuth se añade en paralelo como alt-oauth.
  • La entrega al agente y el envío de una prueba webhook requieren confirmación explícita. Revisa la gestión de claves en Seguridad antes del despliegue.

Disponibilidad actual

El paquete CLI es público, pero OAuth en producción y la emisión de claves API están limitados a administradores de Alt durante el dogfooding. Las conexiones MCP existentes con clave API siguen siendo compatibles. Si la consola devuelve 404 o no puedes aprobar OAuth, tu cuenta aún no está habilitada.