CRMHubSpot
Historial de cambios de la CLI de HubSpot
Lee las notas de versión de la CLI de HubSpot: novedades, cambios y correcciones.
Cambios destacados en @wirecat/hubspot-cli. Una sección por versión, la más nueva primero.
0.4.0 — 19.11.2026
Cambiado: puede romper a quien lo usa
deals.write,people.writeyorganizations.writeya no existen. Solo detenían el camino deapi, así quedeals.write: denyseguía dejando pasardeals update. Una escritura conapien negociaciones, contactos o empresas comprueba ahora la clave del comando que hace lo mismo (deals.update,people.create), como en amoCRM y b24, y una fusión comprueba<group>.update. Así una escritura directa en una negociación, un contacto o una empresa avanza igual que su comando, y los borrados siguen preguntando. Atención: un ajuste que nombra una de las tres claves antiguas ya no coincide con nada. Pon en su lugardeals.update,deals.createo la clave de grupodeals.
Corregido
- Una lectura denegada en un comando del CRM también se deniega con
api.config set permissions.people denydeteníapeople listpero noapi contacts-list, que leía los mismos contactos. Ahora cada lectura directa comprueba la clave del comando que lee los mismos registros:people,organizations,deals,leads,activities,users,pipelines,stagesyfields. Mira permisos.
0.3.2 — 19.11.2026
0.3.1 — 19.11.2026
Corregido
- Las notas, reuniones y tareas se leen como texto limpio. Los códigos HTML como
’y—se convierten en los caracteres que representan y los bloques de estilo se descartan, así la búsqueda encuentra las palabras. Antes solo se decodificaban seis códigos. - El límite diario de HubSpot dice «no reintentar» en todos los caminos. Los comandos del CRM lo daban por
reintentable y
apino, así que un agente podía reintentar durante horas. session start --helpya no dice que hubspot no cambia nada. La escritura llegó en 0.2.0.
0.3.0 — 18.11.2026
Cambiado: puede romper a quien lo usa
- La entrada del MCP Registry pregunta qué perfiles servir. Antes arrancaba
mcp serve --profiles all, así que un cliente que instalaba el servidor desde el registro llegaba a todas las cuentas del ordenador sin que el dueño eligiera. Ahora--profileses un argumento obligatorio con el ejemplopersonal: el cliente pide un perfil, una lista separada por comas oall. Por qué: una CLI nunca elige una cuenta por el dueño (WC-MCP-9). A tener en cuenta: un cliente configurado con la entrada antigua conserva--profiles allhasta que se configure de nuevo. Un servidor añadido a mano o conmcp configno cambia.
Corregido
mcp servearranca en un ordenador que aún no tiene perfil. Muestra sus herramientas, y cada llamada responde con el comando que configura un perfil. Antes el servidor se detenía al arrancar, así que un directorio que revisa servidores no podía listarlas. Desde cli-core 0.699.0.
0.2.0 — 17.11.2026
Añadido
deals create,update,move,closeydeletecambian negociaciones en HubSpot, y la copia toma cada respuesta.closemueve una negociación a la etapa de ganada o perdida de su embudo y guarda--reasoncomo el motivo de cierre de HubSpot.deletearchiva la negociación y pregunta antes. Consulta el uso.people create|updateyorganizations create|updatecambian contactos y empresas. Un contacto guarda un correo y dos números, una empresa un número y ningún correo. Una lista más larga se rechaza antes de enviar nada.apiofrece también las escrituras y los borrados de HubSpot: 66 escrituras y 33 borrados de la API del CRM, versión 2026-03. Cada escritura compruebaapi.<command>y la clave<group>.writede su grupo, cada borrado su<group>.delete, y ambos preguntan por defecto. Una escritura que hace lo mismo que un comando comprueba también la clave de ese comando (deals.update), un cuerpo que cambia la etapa de una negociación compruebadeals.moveydeals.close, y uno que asigna un propietario compruebacrm.assign-others, que por defecto esdeny.api contacts-gdpr-deletecomprueba ademáspeople.erase, para negar solo el borrado definitivo.--dry-runnombra cada clave. Consulta los ajustes.- Los scopes de escritura son opcionales. La configuración y la instalación
enumeran
crm.objects.{deals,contacts,companies}.write. Sin ellos la clave solo lee.
Corregido
apienvía la clave con cada operación. Las especificaciones de objetos de HubSpot marcan 115 operaciones como si no necesitaran inicio de sesión, así que en 0.1.0api deals-get,api contacts-listy las demás operaciones de registros salían sin la clave y HubSpot respondía 401. Las operaciones de embudos, propiedades, propietarios y cuenta no estaban afectadas.
0.1.0 — 17.11.2026
Añadido
- Partió de
@wirecat/cli-template0.25.0. session startinicia la sesión de un perfil con una clave de servicio de HubSpot o un token de app privada. La clave se lee oculta o desde stdin, nunca como argumento, se comprueba contra la cuenta y se guarda en el llavero con el id de la cuenta. Se rechaza un segundo perfil en la misma cuenta.WCHUBSPOT_TOKENfunciona en CI junto aWCHUBSPOT_ACCOUNT, el id de la cuenta. Consulta la instalación.synccopia el CRM de la cuenta en el almacén compartido de WireCat. Negociaciones, contactos, empresas, leads (Sales Hub Professional o Enterprise), propietarios, embudos y propiedades, y las notas, llamadas, correos, reuniones y tareas cuando el ajuste de actividades está activado.deals list,pipelines,changes listysearch allresponden después sin conexión. Una clave no nombra a ningún usuario, así que cada perfil lee toda la copia: filtra porowner:<owner id>, no porowner:me.people,organizationsyusersleen contactos, empresas y propietarios en directo desde la cuenta.apiofrece todas las operaciones de lectura de la API del CRM de HubSpot, versión 2026-03, a partir de sus 15 especificaciones. Un comando por operación, cada uno con su propia clave de permiso. Esta versión solo lee: las escrituras de la API no se ofrecen, yapi showsobre una de ellas lo dice.- Un límite diario agotado termina la petición enseguida y dice cuándo vuelve. HubSpot reparte un límite diario
entre todas las apps de la cuenta.
hubspotinformahubspot.daily-limitcon la espera hasta la medianoche de la cuenta, y evita que cualquier proceso de la cuenta vuelva a preguntar antes. El límite de diez segundos se espera. WCHUBSPOT_ACCOUNTse comprueba contraWCHUBSPOT_TOKENantes de escribir nada. Unsynccon el id de otra cuenta se detiene conaccount.mismatchy nombra ambos ids, así el CRM de una cuenta nunca se archiva bajo otra.session status --checksolo con el token imprime el id que hay que poner. Consulta la resolución de problemas.