Cómo integrar Cord en tu sitio con un solo comando
El asistente del CLI de Cord deja tu sitio integrado en minutos: cotizador, webhooks, tus apps y tus agentes de IA, sin copiar llaves y en modo de prueba.
E
Equipo CordIngeniería de producto
Poner Cord en tu sitio significa varias cosas a la vez: mostrar el cotizador para que tus clientes armen su propuesta, recibir un aviso en tus sistemas cuando alguien aprueba o paga, y que tu CRM y tu equipo se enteren sin que nadie copie datos a mano. Hasta ahora eso pedía una tarde de documentación, llaves copiadas de un panel y pruebas a ciegas.
Desde hoy, quien mantiene tu sitio corre un comando y el asistente de Cord hace ese trabajo en unos minutos.
A mano
01Entrar al panel, crear una llave y copiarla02Pegarla en un .env sin subirla al repositorio03Instalar el SDK y escribir la ruta de webhooks04Verificar la firma de cada webhook05Montar el proxy de Cord Elements06Abrir un túnel para recibir webhooks en localhost07Conectar HubSpot, Shopify o Slack en otra pestaña08Configurar el MCP de Cord en cada agente
Con el CLI$ npx @flouviahq/cli
✓Entras desde el navegador, sin copiar llaves✓SDK, ruta de webhooks y proxy de Elements✓Llave de prueba en un .env que git ignora✓Webhooks firmados llegando a tu localhost✓Tus apps, conectadas desde el navegador✓El MCP de Cord en tus agentes de IA
Lo que antes eran ocho pasos a mano, el asistente lo resuelve en una sola sesión.
Qué es el CLI de Cord
Es la herramienta de línea de comandos de Cord. Se instala desde npm y, sin argumentos, abre un asistente que ocupa la terminal y guía la integración de principio a fin. Antes de tocar nada, lee el proyecto: reconoce la tecnología con que está hecho tu sitio, ve qué apps usa y te explica lo que va a hacer.
mi-tienda — npx @flouviahq/cli
Asistente de Cord cli 2.2.0Ayuda: docs.cordhq.app/cli
Conectamos tu cuenta, integramos Cord en tu proyecto y dejamos tus webhooks escuchando.Revisa qué se comparte en «Privacidad y datos». Los valores de tus .env* se quedan en tu equipo.
Tu cuenta, tu proyecto y tus webhooks listos en unos minutos.
Directorio✓ ~/mi-tiendaFramework ✓ Next.js (App Router) detectadoPlan ✓ SDK · ruta de webhooks · proxy de Elements · tu configuraciónApps ✓ HubSpot, Shopify, Slack te ofrecemos conectarlasCuenta ○ sin conectar se abre tu navegador
▸ Continuar Cambiar framework Qué va a hacer Privacidad y datos Cancelar
↑↓ moverteenter elegiresc salir
La bienvenida del asistente: tu carpeta, tu framework, tus apps y lo que va a integrar.
Entras con tu cuenta, no con una llave
El primer paso es conectar tu cuenta. En lugar de pedirte que busques y pegues una llave, el asistente abre tu navegador en Cord. Ahí eliges la organización y decides qué puede hacer la llave del proyecto: leer tu catálogo, crear cotizaciones, administrar webhooks. La opción sugerida es la mínima que usa la integración.
Autorizas, Cord confirma que eres tú y la terminal queda conectada sola. Todo en modo de prueba: nada de lo que haga el asistente toca tus ventas reales.
WebhooksTu código crea y administra endpoints de webhooks.Sin accesoLecturaEscritura
ElementsLa configuración del cotizador y el borrador con IA.Sin accesoLecturaEscritura
Al autorizar vuelves a tu terminal en localhost:52814. Si no abriste el asistente, cancela.CancelarAutorizar asistente
mi-tienda — npx @flouviahq/cli
Asistente de Cord cli 2.2.0Ayuda: docs.cordhq.app/cli
Autoriza en tu navegadorElige la organización y los permisos y pulsa Autorizar. La terminal se conecta sola, sin copiar ningún código.
https://cordhq.app/app/cli/autorizar?codigo=KXTW-4829&proyecto=1Pulsa o para abrirlo en tu navegador o c para copiar el enlace.
⠹Esperando que autorices en el navegador
o abrir en el navegadorc copiar enlaceesc salir
Mientras la terminal espera, tú decides en el navegador a qué organización entra y con qué permisos.
Tu sitio, integrado
Con la cuenta conectada, el asistente deja tu proyecto listo:
El SDK de Cord, instalado con el gestor de paquetes que ya usa tu proyecto.
La ruta que recibe los avisos de Cord (los webhooks), que verifica la firma de cada uno para que nadie pueda hacerse pasar por Cord.
El puente para el cotizador (el proxy de Cord Elements), para que tus clientes coticen en tu sitio sin exponer tu llave.
Tu llave de prueba, guardada en un archivo que no se sube al repositorio.
Tu configuración, si le das tu sitio y a qué te dedicas: Cord propone tus productos, impuestos y plantillas, y tú los apruebas antes de que se apliquen.
Al terminar, deja un informe con cada archivo que creó. Y nunca sobrescribe uno que ya existía.
Transparente con tus datos
Antes de empezar, el asistente te dice qué sale de tu equipo y qué no sale nunca. Las contraseñas y llaves de tus archivos de entorno se quedan en tu computadora.
mi-tienda — npx @flouviahq/cli
Asistente de Cord cli 2.2.0Ayuda: docs.cordhq.app/cli
Privacidad y datos
Lo que sale de tu equipo+ Tu sitio, la descripción y la lista de precios que le des, para proponer la configuración de tu cuenta.+ El nombre de este equipo, para nombrar la llave que crea. Si integras con IA, las rutas de tus archivos y los que la IA abre.
Lo que no sale nunca− Los valores de tus .env* y cualquier secreto.− Tu carpeta .git, node_modules y todo lo que está fuera de este proyecto.
Lo que hace sin preguntarteInstalar los paquetes de Cord, crear o ajustar los archivos de la integración y guardar tu llave de prueba en un .env que git ignora.
Lo que nunca haceCorrer un comando fuera de su lista: solo instala paquetes de Cord y corre tus scripts de build, lint y pruebas.
Tu cuenta real no cambia: la configuración queda como propuesta hasta que la apruebes en cordhq.app.
▸ Volver Leer la guía completa docs.cordhq.app/cli
↑↓ moverteenter elegiresc volver
La pantalla Privacidad y datos, siempre a un paso del menú.
La versión 2.1 trae además una IA que adapta la integración a cómo está hecho tu proyecto, con herramientas que no salen de su carpeta y una lista cerrada de comandos. Todavía no la encendemos: lo haremos cuando nuestra Divulgación sobre inteligencia artificial cubra que la IA lea el código de quien integra. Mientras, el asistente integra con plantillas probadas, sin que tengas que hacer nada distinto.
Conecta las apps que ya usas
Si tu proyecto ya trabaja con HubSpot, Shopify o Slack, el asistente lo nota en sus dependencias y te ofrece conectarlas con Cord. Cada una se conecta en tu navegador, con su propia autorización, y la pantalla se marca sola al terminar. También reconoce QuickBooks Online, Xero, Google Sheets y Microsoft Teams.
mi-tienda — npx @flouviahq/cli
Asistente de Cord cli 2.2.0Materiales del Valle · prueba
Conecta las apps que ya usasTu proyecto usa estas apps. Conéctalas con Cord desde tu navegador, o después en Ajustes › Integraciones.
HubSpot ✓ Conectada Clientes y cotizaciones como Deals▸ Shopify ○ Sin conectar Catálogo, clientes y pedidosSlack ○ Sin conectar Avisos de cotizaciones y pagos
Las apps de tu proyecto, con su estado en Cord y lo que hace cada conexión.
Qué ganas con cada una: con HubSpot, tus clientes y cotizaciones viven también como Deals; con Shopify, tu catálogo, tus clientes y tus pedidos; con Slack, un aviso en tu canal cuando te aprueban o te pagan.
Tus agentes de IA, conectados a Cord
Al final, el asistente ofrece dejar Cord en los agentes de IA de tu equipo: Claude Code, Cursor y VS Code. Con eso, tu agente puede consultar cotizaciones, clientes y cobros y preparar borradores. Lo que envía, cobra o cambia un cliente lo apruebas tú en Cord, nunca el agente.
mi-tienda — npx @flouviahq/cli
Asistente de Cord cli 2.2.0Materiales del Valle · prueba
Deja a Cord en tus agentes de IACon el MCP de Cord, tu agente consulta cotizaciones, clientes y cobros y prepara borradores. Lo que envía, cobra o cambia un cliente lo apruebas tú en Cord.
▸ [x] Claude Code .mcp.json[x] Cursor .cursor/mcp.json[ ] VS Code .vscode/mcp.json
En Claude o ChatGPT, agrega un conector personalizado con https://cordhq.app/api/mcpSolo se escribe la dirección: la primera vez, el agente te pide autorizar en Cord.
Marcas los agentes de tu equipo y el asistente deja Cord en cada uno, sin guardar ninguna llave.
Si prefieres Claude o ChatGPT, se agrega como conector personalizado. Contamos por qué conectamos Cord a los agentes en este artículo sobre MCP.
Probar sin esperar a un cliente
Para ver la integración funcionando no hace falta que un cliente apruebe una cotización. El asistente deja tu servidor recibiendo avisos de prueba, y con un comando disparas el mismo aviso que mandaría Cord cuando te aprueban o te pagan.
mi-tienda — npx @flouviahq/cli
Asistente de Cord cli 2.2.0Materiales del Valle · prueba · 2:18
Cord quedó integrado
✓ Conectado a Materiales del Valle · modo de prueba
El resumen final: qué quedó listo, qué falta y los avisos de prueba ya llegando a tu servidor.
Empieza hoy
Pásale esto a quien mantiene tu sitio:
npx @flouviahq/cli
Si quieres el detalle técnico, cómo funciona el inicio de sesión por navegador, qué puede y qué no puede hacer la IA y todos los comandos, está en el artículo del dev blog y en la guía del CLI.
Preguntas frecuentes
¿Quién corre el asistente?
Quien mantiene tu sitio, sea tu equipo o tu agencia: lo corre en la carpeta del proyecto con Node 22 o posterior. El asistente instala lo necesario, crea los archivos y deja un informe con lo que cambió.
¿Puede cambiar mi cuenta real?
No. La terminal trabaja con llaves de prueba. Si le das tu sitio y a qué te dedicas, Cord propone tu configuración, y esa propuesta no se aplica hasta que la apruebas en cordhq.app.
¿Con qué tecnologías funciona?
Next.js (App Router y Pages Router), Astro, Express, Laravel, Django, Flask y FastAPI. Si no reconoce el framework de la carpeta, te deja elegirlo.
¿Qué pasa con mis contraseñas y llaves?
Los valores de tus archivos .env nunca salen de tu equipo. El asistente solo escribe la llave de prueba del proyecto en un archivo de entorno que git ignora, y no toca las demás líneas.
¿Tiene costo?
El CLI es gratuito y se instala desde npm. La llave del proyecto que crea cuenta como una llave de tu plan.
Suscríbete al Blog de Cord
Estrategias financieras, análisis de mercado y novedades de producto directamente en tu bandeja de entrada.
Usamos cookies esenciales para que Cord funcione. Solo si aceptas, medimos el uso del sitio con PostHog y las visitas y el rendimiento con Vercel. Puedes cambiar tu elección cuando quieras. Política de cookies