El Fin CLI (@intercom/cli) es una herramienta de línea de comandos creada para desarrolladores y agentes de codificación AI, como Claude Code, Cursor o Codex, para configurar, gestionar y administrar Intercom y Fin programáticamente. Puedes dirigir tu agente de codificación al CLI y pedirle en lenguaje natural que configure Fin, importe contenido o cambie tu configuración de Fin y Messenger, sin salir de tu entorno de codificación. Cada comando está diseñado para funcionar sin indicaciones interactivas, con salida JSON estructurada y mensajes de error claros para usar en workflows automatizados. Aprende más en fin.ai/cli.
Requisitos
Node.js 18 o superior (se recomienda v20.6.0+)
Un espacio de trabajo Intercom en la región US (otras regiones no están soportadas actualmente)
¿Fin CLI o Fin Agent API MCP server? Usa el Fin CLI cuando quieras que un agente de codificación configure o cambie tu espacio de trabajo, como configurar procedimientos, guidance, audiencias, conectores de datos, workflows, el Messenger o artículos. Usa el Fin Agent API MCP server cuando quieras que un agente use Fin, como hacerle preguntas o ejecutar procedimientos en nombre de un usuario.
Instalación
Instala el CLI globalmente vía npm:
npm install -g @intercom/cli
O ejecútalo directamente sin una instalación global:
npx @intercom/cli
Autenticación
El CLI ofrece tres rutas de autenticación dependiendo de tu configuración:
auth login — Ingresa un token existente directamente.
auth bootstrap — Crea automáticamente una app y obtiene un token usando tu correo electrónico y contraseña.
auth signup — Crea un espacio de trabajo Intercom completamente nuevo desde cero.
Las credenciales se almacenan de forma segura en el llavero de tu sistema (macOS Keychain, Windows Credential Manager o Linux libsecret), con un archivo cifrado como respaldo. Los tokens expiran aproximadamente cada 14 días. Actualmente no hay renovación automática de tokens — necesitarás reautenticarte cuando tu token expire.
Comandos clave
Configuración del espacio de trabajo con un solo comando
El comando intercom setup automatiza la creación del espacio de trabajo, la instalación del Messenger y la población del help center en un solo paso — no se requiere interfaz gráfica.
intercom setup
Ingesta de contenido desde Markdown
Llena tu help center apuntando el CLI a un directorio local de archivos Markdown:
intercom setup --content-dir ./docs
Acceso directo a API
El comando intercom api proporciona acceso directo a cualquier endpoint de Intercom API, similar a cómo funciona el GitHub CLI con gh api:
intercom api
Configuración de Fin
Gestiona procedimientos, guidance, audiencias, conectores de datos, simulaciones y workflows de Fin directamente desde la terminal — no es necesario visitar la interfaz de Intercom.
Usa el CLI con Claude Code u otro agente de codificación
Instala y autentica el CLI, luego pide a tu agente de codificación lo que quieres hacer en lenguaje natural. Por ejemplo, "Configura Fin en nuestro sitio e importa ./docs/help como artículos", o "Solo muestra el lanzador del Messenger a usuarios que hayan iniciado sesión". El agente ejecuta los comandos CLI correspondientes por ti. Para revisar qué cambiará antes de aplicar algo, pídele que use las banderas --plan o --dry-run primero.
Gestión de recursos
El CLI incluye comandos dedicados para gestionar recursos comunes de Intercom:
Comando | Operaciones |
intercom articles | listar, obtener, crear, actualizar, eliminar |
intercom contacts | listar, obtener, crear, actualizar, eliminar |
intercom conversations | listar, obtener, responder |
intercom help-center | listar, obtener, crear |
intercom messenger | obtener, actualizar, snippet |
intercom fin | procedimientos, guidance, audiencias, conectores de datos, simulaciones, workflows |
intercom me | mostrar información actual del espacio de trabajo |
Modos de planificación y simulación
Dos banderas están disponibles para validar comandos antes de ejecutarlos:
--plan: Lista los pasos que el CLI tomaría sin ejecutarlos. Útil para agentes AI que revisan un workflow antes de comprometerse.
--dry-run: Valida el comando y sus entradas sin hacer cambios.
Modos de salida
Todos los comandos soportan --json para salida estructurada adecuada para canalizar a otras herramientas. También puedes filtrar la salida en línea usando --jq — no se requiere instalación del sistema jq.
Limitaciones conocidas
Solo región US — otras regiones no están soportadas actualmente.
Los tokens expiran aproximadamente cada 14 días sin renovación automática.
Los comandos auth signup y auth bootstrap usan endpoints internos que pueden requerir excepciones de Web Application Firewall (WAF) en algunos entornos de producción.
Se requiere Node.js 18 o superior. El flujo OAuth en navegador aún no está soportado — la autenticación basada en token (auth login --token) es la ruta principal soportada.