Sáltate la instalación. Funcionando en menos de 2 minutos.
Inicia una prueba gratuita en cloud.anythingmcp.com, añade HubSpot con un clic y apunta tu cliente de IA (Claude, ChatGPT, Copilot o Cursor) al endpoint MCP generado. Sin Docker, sin git clone, sin experiencia de desarrollo.
AnythingMCP está en el directorio de conectores de Claude: añádelo a Claude con un clic (se abre en una pestaña nueva), inicia sesión y elige qué servidores MCP puede usar Claude.
Resumen
Deja que tu IA trabaje en HubSpot CRM: busca y actualiza contactos, empresas, negocios y tickets, consulta qué está asociado con qué, revisa pipelines y propietarios, y registra notas y tareas. Una cuenta, con una clave de servicio que creas tú mismo.
Prueba a pedir
Prompts de ejemplo para HubSpot
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → HubSpot, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin
git clone, sin servidor local.
HubSpot + Claude
Deja que tu IA trabaje en HubSpot CRM: busca y actualiza contactos, empresas, negocios y tickets, consulta qué está asociado con qué, revisa pipelines y propietarios, y registra notas y tareas. Una cuenta, con una clave de servicio que creas tú mismo.
Requisitos previos
Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:
HUBSPOT_ACCESS_TOKEN
Paso 1 — Obtener credenciales
- En HubSpot, abre Development en la barra lateral izquierda, luego Keys → Service keys, y haz clic en Create service key. Necesitas ser superadministrador o un usuario con acceso a las herramientas de desarrollo.
- Ponle un nombre a la clave (por ejemplo "AnythingMCP"), haz clic en Add new scope, marca los scopes que se indican más abajo y luego haz clic en Update y Create.
- Abre la clave, haz clic en Show y luego en Copy. Las claves de servicio empiezan por
pat-(por ejemplopat-eu1-...). - Pega la clave en
HUBSPOT_ACCESS_TOKEN, sin la palabra Bearer, e instala el conector. - Empieza con
hubspot_get_account: muestra a qué cuenta de HubSpot (Hub ID) pertenece la clave, su zona horaria y su moneda.
Apps privadas heredadas: las cuentas más antiguas pueden tener todavía una app privada (Development → Legacy apps, antes Settings → Integrations → Private Apps). Su token de acceso funciona igual: pégalo en HUBSPOT_ACCESS_TOKEN.
Scopes:
- Lectura:
crm.objects.contacts.read(cubre también notas y tareas),crm.objects.companies.read,crm.objects.deals.read,crm.objects.tickets.read,crm.objects.owners.read. - Escritura:
crm.objects.contacts.write(necesario también para notas y tareas),crm.objects.companies.write,crm.objects.deals.write,crm.objects.tickets.write.
Solo lectura: da a la clave solo los scopes de lectura y desactiva hubspot_create_object, hubspot_update_object, hubspot_associate_records, hubspot_create_note y hubspot_create_task.
Desactivadas al instalar: hubspot_archive_object. Actívala solo si la IA debe eliminar registros. Los registros archivados van a la papelera de reciclaje de HubSpot y se pueden restaurar desde ahí durante 90 días.
Ajustes de privacidad de datos: si la privacidad de datos (RGPD) está activada en tu cuenta de HubSpot, HubSpot exige una base jurídica para el tratamiento, la propiedad hs_legal_basis, en cada contacto nuevo. Indica a la IA qué base jurídica debe usar cuando cree contactos; sin ella, HubSpot responde "The following required properties were missing".
Límites: HubSpot permite 100 solicitudes cada 10 segundos por clave en Free y Starter (más en Professional y Enterprise), 250.000 solicitudes al día por cuenta y 5 búsquedas por segundo. Si se supera un límite, HubSpot responde 429: espera unos segundos y vuelve a intentarlo.
Errores frecuentes: 401 significa que la clave es incorrecta, caducó o se rotó: vuelve a copiarla. 403 indica el scope que falta: añádelo a la clave en Edit. 404 significa que el id o el tipo de objeto es incorrecto. 400 VALIDATION_ERROR indica la propiedad o el filtro erróneo, por ejemplo un nombre de propiedad desconocido o un valor de lista desplegable que no es una de sus opciones.
El conector no gestiona correos de marketing, formularios, listas, workflows, archivos, presupuestos ni precios de partidas, fusiones ni escrituras por lotes.
Paso 2 — Instalar el adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Paso 3 — Añadir el conector en Claude
La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (
https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestraYOUR_SERVER_ID.
Ruta recomendada: funciona en claude.ai web sin tocar ningún archivo de configuración.
- En Claude, abre Customize → Connectors.
- Pulsa + y después Add custom connector.
- Escribe un nombre, por ejemplo
HubSpot, y la URL del servidor MCP remotohttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, y pulsa Add. - Pulsa Connect e inicia sesión en AnythingMCP (OAuth) para permitir el acceso.
Todas las herramientas debajo aparecen en tu chat: empieza a escribir prompts.
Herramientas disponibles
| Tool | What it does |
|---|---|
hubspot_list_owners | List the HubSpot users who can own records (owners): owner id, user id, email, first and last name, teams and whether archived |
hubspot_get_account | Get the HubSpot account the token belongs to: portal id (Hub ID), account type, time zone and UTC offset, company currency and additional… |
hubspot_search_objects | Search CRM records of one object type (contacts, companies, deals, tickets, notes, tasks, ...) by free text and/or property filters, with… |
hubspot_list_objects | List CRM records of one object type page by page, oldest id first, with the chosen properties and optionally the ids of associated records |
hubspot_get_object | Get one CRM record by id (or by a unique property such as a contact's email with id_property), with the chosen properties, optional… |
hubspot_create_object | Create a CRM record (contact, company, deal, ticket, ...) with property values, optionally associated with existing records |
hubspot_update_object | Change property values of one CRM record; only the given properties change, and an empty string clears a value |
hubspot_archive_object | Archive (delete) one CRM record: it moves to the recycling bin, where it can be restored for 90 days |
hubspot_get_associations | List the records of one type associated with a record, with their association types and labels, e.g. all deals of a company or all contacts… |
hubspot_associate_records | Link two existing records with HubSpot's default (unlabeled) association, e.g. a contact to a company or a deal to a contact |
hubspot_list_pipelines | List the pipelines of deals or tickets with their stages: pipeline id and label, and per stage its id, label, display order and metadata… |
hubspot_list_properties | List the properties of an object type, default and custom: internal name, label, type, field type, group, description, whether read-only… |
hubspot_create_note | Add a note to the CRM timeline, associated with contacts, companies, deals or tickets |
hubspot_create_task | Create a task (to-do, call or email reminder) with a due date, optionally assigned to an owner and associated with records |
Ejemplos de prompts
- "¿Qué negocios del pipeline de ventas está previsto cerrar este mes y quién es su propietario?"
- "Busca el contacto [email protected] y muéstrame su empresa y sus negocios abiertos."
- "Pasa el negocio de Acme Corp a la siguiente etapa y añade una nota con un resumen de la llamada de hoy."
- "Crea una tarea de seguimiento para mí en el negocio de Globex, con vencimiento el próximo viernes."
FAQ
¿Funciona con Claude Code igual que con Claude Desktop? Sí, apunta ambos a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
Siguientes pasos
¿Te ha sido útil esta guía?