API, MCP y webhooks: conecta MB Suite con tus sistemas y asistentes de IA

¿Qué son la API, el MCP y los webhooks?

Son tres formas de conectar MB Suite con otras herramientas, para que nadie tenga que copiar datos a mano ni consultar a cada rato:

¿Quién los habilita y con qué plan?

Los habilita un owner o un admin del workspace, una sola vez para todo el workspace. Están incluidos en las suscripciones pagas activas: la prueba gratis no los incluye. Si tu workspace está en la prueba, Configuración > API y MCP te lo indica y te ofrece Ir a Suscripción; cuando la suscripción esté paga, vuelves y los habilitas con un clic. Si el cobro está pausado por falta de pago, se pueden habilitar cuando se regularice.

Mientras tanto, el resto del equipo ve el aviso de que todavía no están habilitados, para que se lo pida a un owner o a un admin. Una vez habilitados, cualquier miembro puede conectar Claude, ChatGPT, VS Code o Claude Code con sus propios permisos (la pestaña MCP tiene la URL y los pasos); las API keys, los webhooks, el Uso y el Registro son de los owners y los admins.

¿Cómo los habilito?

• En el workspace, ve a Configuración > API y MCP.
• Revisa lo que incluye tu plan: cuántas llamadas por día y cuántas API keys activas. Si quieres leer antes cómo funciona, Ver la documentación la abre en otra pestaña.
• Presiona Habilitar API y MCP. Aparecen las pestañas API keys, MCP, Webhooks, Uso, Registro y Documentación, y en el encabezado, el estado Habilitados.
• Sigue con lo que necesitas: crear tu primera API key, conectar Claude, ChatGPT o Cursor o crear un webhook.

¿Qué pasa en las Cuentas?

La API y el MCP se habilitan en el workspace y valen para todas sus Cuentas: una Cuenta usa los de su workspace, y no se habilitan ni se apagan desde una Cuenta. Si entras a API y MCP dentro de una Cuenta y todavía no están habilitados, la pantalla lo dice: a la gente de la agencia le ofrece Ir al workspace, y a la del cliente le indica que se lo pida a la agencia.

Las API keys y las apps del workspace pueden trabajar también en sus Cuentas, si lo permites al crearlas o al autorizarlas. Para que una Cuenta tenga sus propias API keys: si su suscripción la paga la agencia, la agencia lo permite desde Partners (ver API keys); si la Cuenta paga su propia suscripción, no necesita ese permiso, pero solo puede crear y usar sus propias API keys cuando esa suscripción esté paga y activa (en la prueba gratis, la pantalla de la Cuenta lo avisa).

¿Cómo los apago y qué pasa con lo que ya creé?

• En Configuración > API y MCP del workspace, abre el estado Habilitados, en el encabezado.
• Elige Apagar API y MCP, lee lo que pasa y confirma con Apagar.

En menos de un minuto, las API keys y las apps conectadas (Claude, ChatGPT, Cursor y otras) dejan de responder y los webhooks dejan de enviar eventos nuevos, también en todas las Cuentas del workspace. No se borra nada: las API keys, las apps autorizadas y los webhooks quedan como estaban, y la pantalla muestra un aviso ámbar con quién los apagó y cuándo. Mientras están apagados no se pueden crear API keys ni webhooks, pero sí editar, rotar, suspender, revocar o eliminar los que ya tienes: es lo que necesitas si los apagaste por una filtración. Para volver, un owner o un admin presiona Volver a habilitar y todo sigue como estaba.

¿Qué pasa si la suscripción deja de estar paga?

La API y el MCP se pausan, igual que si los apagaras: las API keys y las apps conectadas responden con un error 402 payment_required y los webhooks dejan de enviar eventos. Pasa cuando el cobro queda pausado por falta de pago o cuando termina el período de una suscripción cancelada. No se borra nada: en Configuración > API y MCP del workspace, un aviso lo explica y, a los owners y los admins, les ofrece Ir a Suscripción; cuando la suscripción vuelve a estar paga, todo se reanuda solo, sin habilitar nada de nuevo.

Cada pedido rechazado dice por qué en su código de error, para que tu integración sepa qué pasó: payment_required (402), el cobro está pausado; platform_requires_paid_plan (403), la suscripción está en la prueba gratis o no hay una; platform_not_enabled (403), la API y el MCP están apagados en el workspace o todavía no se habilitaron. Y si MB Suite suspende el workspace, la API y el MCP responden organization_suspended: ver Mi workspace aparece como suspendido.

¿Cuánto puedo usar?

Los cupos crecen con tu plan: llamadas por día y por minuto, y cuántas API keys y webhooks puedes tener activos a la vez. Ves los principales en la pantalla donde habilitas la API y el MCP y, después, todos en la pestaña Uso, en Cupos de tu plan; la comparación entre planes está en Precios. Los cupos diarios se reinician todos los días a las 00:00 UTC.

Cuando una llamada necesita un cupo diario que ya se completó, recibe un error 429 hasta el reinicio. Al llegar al 80 % y al 100 % de un cupo, los owners y admins reciben un aviso por correo y en las notificaciones; en una Cuenta, también los del workspace. Lo que se hace desde las pantallas de MB Suite no cuenta.

¿Dónde veo cuánto se usa y qué se hizo?

En la pestaña Uso: las llamadas, lecturas, escrituras y errores de hoy y del mes, cuánto tardan las respuestas, las llamadas de los últimos 30 días, las API keys o apps que más llamaron, las operaciones más usadas y los Cupos de tu plan, con cuánto llevas usado de cada uno.

En la pestaña Registro: cada pedido de la API y cada operación que corre el MCP en los últimos 30 días, con quién lo hizo, con qué API key o app, qué operación, cómo terminó y cuánto tardó. Puedes filtrar por día, API key o app, estado, operación o código de error, buscar un request_id y abrir un pedido para ver su detalle y, si falló, qué significa el error. Ver en el registro, en el menú de una API key o de una app conectada, lo abre ya filtrado. Lo que una API key o una app hace dentro de una Cuenta, aunque sea del workspace, queda en el Registro de esa Cuenta, no en el del workspace. El Registro no guarda lo que se envió ni lo que se respondió: nunca la API key, el token ni los datos del pedido.

¿Es seguro conectar otras herramientas?

Cada API key y cada app conectada actúa como una persona del workspace y nunca puede más que ella: si esa persona solo ve sus propios tratos, la API key o la app también; si es Viewer, solo lee. Además, eliges a qué módulos llegan y si pueden escribir; eliminar viene apagado; y lo masivo, la mayoría de los borrados y lo que manda algo fuera de MB Suite, cambia algo en otra plataforma o tiene un costo aparte pasan primero por una vista previa que la misma herramienta confirma. Todo queda registrado a nombre de esa persona, y cada pedido, en el Registro.

Si una API key se usa de forma sospechosa —muchos pedidos rechazados seguidos o intentos de entrar a organizaciones que no son la suya—, MB Suite la suspende sola y avisa en las notificaciones a los owners y admins; cuando la integración está revisada, se reactiva desde su menú (ver API keys).

¿Qué plataformas conectadas puedo usar por la API y el MCP?

Los términos de algunas plataformas limitan lo que se puede hacer con sus datos fuera de las pantallas de MB Suite, y la API y el MCP los respetan. De Google Ads, Business Profile, YouTube y TikTok no hay nada disponible por esta vía: ni sus datos ni cambios o publicaciones en ellas; por eso, los módulos que solo trabajan con ellas, como Local SEO o Auto-Budget, tampoco están disponibles. De LinkedIn, solo los informes de tus cuentas publicitarias y páginas y los leads de tus formularios de Lead Gen, y solo con una API key por la API REST, no por el MCP, por una app conectada ni con una API key de un agente de IA; los comentarios y las menciones de sus miembros no están disponibles, y no se puede publicar ni cambiar nada en LinkedIn. Tus otras plataformas conectadas, como Meta, Google Analytics o Search Console, funcionan por la API y el MCP como el resto de MB Suite.

En el CRM, los tratos, prospectos, personas y empresas que entraron o se completaron por TikTok no están disponibles; los de LinkedIn Lead Gen siguen la regla de LinkedIn, y los de un formulario de Google Ads llegan sin las respuestas del formulario. Tampoco salen por esta vía los PDF de un dashboard, un informe o un envío con datos de esas plataformas, ni se puede armar o programar un envío que incluya sus cuentas.

Un pedido que esos términos no permiten recibe un error 403 platform_terms_restricted, que dice de qué plataforma se trata, y el MCP ni siquiera le ofrece esas operaciones al asistente. Por lo mismo, los webhooks no envían algunos eventos, o los envían sin algunos datos: Webhooks dice cuáles. En las pantallas de MB Suite todo funciona como siempre, y la documentación para desarrolladores lista estas plataformas en la guía Permisos y alcances.

¿Qué significa «Beta»?

La pantalla de API y MCP lleva la marca Beta: la API, el MCP y los webhooks ya funcionan con tus datos reales, y siguen sumando operaciones, eventos y mejoras. Para que un cambio no rompa lo que ya conectaste, cada organización queda fijada en la versión de la API vigente cuando crea su primera API key, y cada API key y cada webhook conservan la suya hasta que los cambies. Lo que cambia en cada versión está en el registro de cambios de la documentación.

¿Dónde está la documentación técnica?

En la pestaña Documentación tienes las guías, la referencia de los módulos activos en tu organización y los eventos de webhooks, y Abrir el sitio de desarrolladores te lleva al sitio completo: developers.mb-suite.com, con la búsqueda, los códigos de error, el registro de cambios y el estado de la API, el MCP y los webhooks. Para el día a día, sigue con estos artículos: API keys, Conectar Claude, ChatGPT o Cursor a MB Suite con el MCP y Webhooks.

La API, el MCP y los webhooks llevan datos de tu organización —contactos, tratos, métricas y lo demás que permitas— a las herramientas que eliges, que los tratan bajo sus propias condiciones. Su uso se rige por nuestros Términos y Condiciones y nuestro Acuerdo de Tratamiento de Datos (DPA).