En dos líneas: el MCP es la puerta por la que un asistente de IA trabaja dentro de MB Suite. Pegas la URL del servidor en Claude, ChatGPT, Cursor u otra app, autorizas en MB Suite qué puede hacer y, desde ahí, le pides cosas en lenguaje natural: las hace como tú, con tus permisos, y todo queda registrado a tu nombre.

¿Qué es el MCP y qué puedo hacer con él?

MCP (Model Context Protocol) es un estándar abierto para que los asistentes de IA usen otras aplicaciones. Con MB Suite conectado, puedes pedirle a Claude, por ejemplo, «¿qué tratos abiertos tengo en el pipeline de ventas?», «busca a Laura Gómez y dime en qué etapa está su trato», «crea un trato para Acme y registra una nota con lo que hablamos» o «¿cuánto invertí en Meta este mes contra el anterior?», y el asistente lo hace en tu MB Suite sin que copies nada a mano.

El asistente trabaja como la persona que lo autorizó: ve lo que ella ve y hace lo que ella puede hacer, dentro de los permisos que le dio, nunca más. Cada acción queda registrada a su nombre. Por defecto, toda app solo lee, aunque pida escribir: si quieres que también cree o cambie registros, lo activas al autorizarla (más abajo, cómo).

¿Qué necesito para conectarlo?

Ser miembro de una organización con la API y el MCP habilitados: los habilita un owner o un admin del workspace (ver API, MCP y webhooks). Claude, ChatGPT, VS Code y Claude Code se conectan con OAuth: te piden permiso en una pantalla de MB Suite y tú decides qué les das, sin crear nada antes. Cursor, un agente propio o un script se conectan con una API key, que crea un owner o un admin. Los conectores personalizados dependen del plan que tengas en Claude o en ChatGPT: si no ves la opción, revísalo con ellos.

¿Cuál es la URL del servidor?

Está en Configuración > API y MCP, pestaña MCP, en Servidor MCP, con su botón Copiar: https://mcp.mb-suite.com. Es la misma para todos: la organización y los permisos se eligen al autorizar o, con una API key, los define la API key. Si ya conectaste una app con la dirección anterior, https://mb-suite.com/api/platform/mcp, no hace falta cambiarla.

En Conectar, la misma pestaña tiene el paso a paso de cada app —Claude, ChatGPT, Cursor, VS Code, Claude Code y Otra app—, con la configuración o el comando listos para copiar (Copiar configuración, Copiar comando). Son los mismos pasos de abajo.

¿Cómo conecto Claude?

En Claude, abre Configuración → Conectores → Agregar conector personalizado.
Pega la URL del servidor (si te pide un nombre, ponle MB Suite) y guarda.
Claude te lleva a MB Suite para que elijas la organización y revises los permisos (más abajo, qué hay en esa pantalla). Al presionar Permitir, vuelves a Claude ya conectado.
En una conversación, prueba con «¿Qué puedo hacer en MB Suite?». Lo primero que usa el asistente es mb_context, que le dice quién eres, en qué organización está y qué puede hacer. Si no lo ves activo, actívalo desde el menú de herramientas del chat.

En los planes Team y Enterprise de Claude, primero un owner de la cuenta de Claude agrega el conector desde la configuración de administración; después cada persona lo conecta y lo autoriza con su propio usuario de MB Suite.

¿Cómo conecto ChatGPT?

En ChatGPT, abre Configuración → Apps y conectores → Ajustes avanzados y activa el modo desarrollador. En los planes de empresa lo habilita el administrador.
Vuelve a Apps y conectores, elige Crear, pega la URL del servidor como servidor MCP y, si te lo pregunta, elige OAuth como autenticación.
ChatGPT te lleva a MB Suite para autorizar: revisa la organización y los permisos y presiona Permitir.
En una conversación, activa la app de MB Suite y pídele algo de tu CRM.

OpenAI cambia seguido estos menús: los conectores ahora se llaman apps, y el modo desarrollador cambió de lugar más de una vez. Si no lo encuentras, búscalo como «developer mode» en la ayuda de ChatGPT.

¿Cómo conecto Cursor?

Crea una API key en la pestaña API keys. Si prefieres que el agente vea una herramienta tipada por cada operación, en Avanzado elige Una herramienta por operación.
En la pestaña MCP, en Conectar, elige Cursor y copia la configuración con Copiar configuración.
En Cursor, abre Cursor Settings → Tools & MCP → New MCP Server, pega la configuración, reemplaza mbs_live_TU_API_KEY por tu API key entera y guarda.
Las herramientas de MB Suite aparecen en el agente de Cursor.

La configuración tiene esta forma: {"mcpServers": {"mb-suite": {"url": "https://mcp.mb-suite.com", "headers": {"Authorization": "Bearer mbs_live_TU_API_KEY"}}}}.

Guarda la configuración con tu API key en el archivo global de Cursor (~/.cursor/mcp.json), no en el .cursor/mcp.json de un proyecto: ese archivo vive dentro del repositorio y puede terminar subido junto con el código.

¿Cómo conecto VS Code?

En VS Code, abre la paleta de comandos y elige «MCP: Add Server». Necesitas GitHub Copilot.
Elige HTTP, pega la URL del servidor y guárdalo para tu usuario o para el proyecto. Si prefieres editar el archivo, Copiar configuración en la pestaña MCP te da la configuración de .vscode/mcp.json.
La primera vez, VS Code te pide permiso para iniciar sesión y te lleva a MB Suite para que elijas la organización y revises los permisos. VS Code no es una de las apps que MB Suite reconoce, así que la pantalla te pide marcar «Entiendo que MB Suite no verificó esta app…» antes de poder presionar Permitir.
En el chat de Copilot, en modo Agente, prueba con «¿Qué puedo hacer en MB Suite?».

¿Cómo conecto Claude Code?

En la terminal, agrega el servidor con el comando de la pestaña MCP (Copiar comando): claude mcp add --transport http mb-suite https://mcp.mb-suite.com. Si le sumas --scope user, queda para todos tus proyectos.
Abre Claude Code, escribe /mcp y elige mb-suite para autenticarte.
Claude Code abre MB Suite en el navegador para que elijas la organización y revises los permisos; al presionar Permitir, vuelves a Claude Code ya conectado.
Prueba con «¿Qué puedo hacer en MB Suite?».

¿Cómo conecto otra app, un agente propio o un script?

En la pestaña MCP, en Conectar, Otra app explica las tres formas, con la configuración lista para copiar: si la app acepta servidores MCP remotos con OAuth, pegas la URL del servidor y te trae a MB Suite para autorizarla, como Claude; si en cambio pide una API key, la creas en la pestaña API keys y la usas como Bearer en el encabezado Authorization; y si la app solo acepta servidores locales, la conectas con el puente mcp-remote, que necesita Node.js. Un agente propio o un script hace lo mismo con cualquier cliente MCP: se conecta por HTTP a la URL del servidor y manda la API key en el encabezado Authorization de cada solicitud.

En una Cuenta a la que su agencia todavía no le permitió API keys propias, la pestaña MCP te lo avisa al elegir Cursor u Otra app: las apps que se conectan con OAuth —Claude, ChatGPT, VS Code o Claude Code— sí se pueden conectar.

¿Qué veo al autorizar una app?

Cuando Claude, ChatGPT u otra app pide acceso, MB Suite abre la pantalla «… quiere acceder a tu MB Suite», con el nombre de la app (si no tienes la sesión iniciada, primero te pide entrar). Antes de presionar Permitir:

Revisa quién pide acceso, debajo del título. MB Suite reconoce a Claude, Claude Code y ChatGPT por su dominio, no por el nombre que declaran: muestran su propio logo junto al de MB Suite y la leyenda Identificada por su dominio, seguida de su dominio (como claude.ai o chatgpt.com). Una app que se registra sola al conectarse —VS Code, por ejemplo— muestra su inicial en lugar del logo y, en ámbar, Sin identidad verificada (el nombre, el logo y los enlaces los declaró la propia app) o, si se identifica por su propio dominio, Identificada por su dominio con ese dominio. Si una app que MB Suite no reconoce te va a enviar a un sitio web al terminar, la dirección aparece arriba, en ámbar: «Al terminar te va a enviar a…». App verificada aparece solo en las apps que publicó o verificó MB Suite.
En Organización, elige dónde va a trabajar: una organización de la que eres miembro y con la API y el MCP habilitados. Si ninguna de las tuyas los tiene, la pantalla te lo dice: los habilita un owner o un admin en Configuración > API y MCP, con una suscripción paga activa.
En Permisos que pide, la fila Ver tu información resume lo que la app va a poder leer: «Lectura en … módulos, con tus mismos permisos». Justo debajo ves siempre el detalle de los módulos con datos sensibles —por ejemplo, qué datos del CRM, los SMS de Phones, los mensajes directos del Inbox, las respuestas de Web Forms o las audiencias de Email Marketing—, y Ver cuáles despliega la lista entera.
Escribir viene apagado, aunque la app lo pida. Si quieres que también cree y modifique registros, activa la fila Lectura y escritura: si la app pidió permisos puntuales, cubre solo los módulos en los que pidió escribir, y si pidió solo leer, la fila no aparece. Eliminar es aparte.
Escribir en un módulo sensible —Miembros, Branding, Cuentas, Client Portal, Email Marketing o Integraciones— va aparte, en Escritura en módulos sensibles: un interruptor por módulo, todos apagados, aunque la app lo pida. Activa solo los que de verdad necesita: escribir ahí puede cambiar quién entra, tu marca, lo que reciben tus clientes o tus conexiones. Cada módulo que activas se pone en ámbar.
Si la app pide eliminar, al activar la escritura en algún módulo aparece aparte una fila apagada: Eliminar registros de…, con los módulos en los que va a poder escribir. Actívala solo si quieres que pueda eliminar; al activarla, se pone en ámbar.
Si la app lo pide, o no detalla qué permisos quiere, aparece aparte la fila Correo y calendario conectados, apagada. Actívala solo si quieres que la app lea los correos de tu propio buzón y los eventos de tu propio calendario vinculados a personas, empresas o tratos del CRM (nunca el buzón entero); al activarla, la fila se pone en ámbar. Si la organización que elegiste no lo permite, la fila queda deshabilitada con el aviso «Tu organización no lo permite: lo activa un owner en Configuración → API y MCP → API keys».
Si elegiste el workspace de una agencia, puedes activar Acceder también a las Cuentas y elegir Todas las Cuentas o Elegir Cuentas: la app trabajará también en ellas, solo en las que tú ves.
En Avanzado puedes cambiar el Modo de herramientas del MCP (más abajo, qué cambia).
Al pie, junto a Cancelar y Permitir, Claude, Claude Code y ChatGPT muestran a dónde vuelves al terminar y un recordatorio. Con Claude: «Al terminar vuelves a Claude en claude.ai. Permite solo si acabas de iniciar tú esta conexión desde Claude». Claude Code vuelve a esta computadora, así que dice «Al terminar vuelves a Claude Code en esta computadora (localhost:…)», seguido del mismo recordatorio. Ahí también están el aviso de que es una app externa y los enlaces a los Términos y la Política de privacidad de MB Suite y a la política de privacidad de la empresa de la app. Si no iniciaste tú la conexión, presiona Cancelar: alguien puede iniciarla desde su propia cuenta y mandarte el enlace.
Si MB Suite no reconoce la app ni la verificó, el pie muestra, junto a Permitir, la casilla «Entiendo que MB Suite no verificó esta app…»: márcala solo si acabas de iniciar tú la conexión, desde esa app; sin ella, Permitir no se habilita.
Presiona Permitir para volver a la app ya conectada, o Cancelar para no darle acceso.

En esa pantalla eliges la organización, si la app también escribe, la escritura en cada módulo sensible, si puede eliminar, si puede leer el correo y calendario conectados, las Cuentas y el modo de herramientas. Lo que no eliges es, módulo por módulo, qué lee: la lectura se concede junta, en todos los módulos que pide, y la escritura de los módulos comunes también, solo si activas Lectura y escritura, pida lo que pida la app. Si la app pide leer más de lo que quieres darle, presiona Cancelar.

Si ya conectaste la app sin ese permiso —porque tu organización todavía no lo permitía o porque no lo activaste— y ahora quieres dárselo, desconéctala en Conexiones autorizadas y vuelve a conectarla desde la app, esta vez con la fila activada. Y si después un owner lo desactiva para la organización, la app deja de leer correo y calendario al instante, sin que tengas que desconectarla, y vuelve a leer en cuanto se active de nuevo. Quién lo activa y qué pasa al desactivarlo está en API keys.

Lo que la app lea de tu correo y tu calendario sale de MB Suite: la app recibe ese contenido y lo guarda bajo sus propias condiciones, y en los planes personales de algunos asistentes de IA puede usarse para entrenar modelos, salvo que lo desactives en la app. Los correos incluyen datos de tus clientes: tu organización responde por esa entrega, y la app no puede usarlos para publicidad ni revenderlos. Activa Correo y calendario conectados solo en apps en las que confíes y que de verdad lo necesiten.

Si en vez de esa pantalla ves No se puede autorizar esta solicitud, la app envió una solicitud que no coincide con su registro y, por seguridad, MB Suite no te redirige a ninguna parte: cierra la pestaña y vuelve a intentarlo desde la app.

¿Qué puede hacer el asistente una vez conectado?

En el modo Compacto (recomendado), el asistente ve cinco herramientas generales y, si tiene acceso al CRM, mb_search:

Herramienta	Para qué sirve
`mb_context`	Le dice en nombre de quién actúa, en qué organización, con qué rol, plan y límites diarios, qué Cuentas alcanza (una lista corta y cuántas son en total), qué integraciones hay conectadas, qué pasó hace poco en el CRM y en qué módulos puede trabajar, con la cantidad de operaciones de cada uno. Es lo primero que usa.
`mb_catalog`	El catálogo de operaciones de un módulo, con su descripción completa. Un módulo grande, como el CRM, llega de a un grupo.
`mb_search_operations`	Encuentra una operación por palabras, en español, inglés o portugués. Si el cambio que pediste necesita un permiso que la conexión no tiene —escribir, con una conexión que solo lee—, o solo se hace en las pantallas de MB Suite, como crear API keys, se lo dice.
`mb_describe_operation`	La ficha de una operación: qué datos pide y qué devuelve.
`mb_execute_operation`	Ejecuta una operación.
`mb_search`	Busca en el CRM tratos, personas, empresas y prospectos por texto.

Con Una herramienta por operación, además ve una herramienta por cada operación que puede hacer (por ejemplo, crm_deals_create), algo que algunos modelos aprovechan mejor. En los dos casos, el asistente solo ve lo que la persona puede hacer con esos permisos.

Si le pides algo que la conexión no puede hacer —cambiar registros con una conexión que solo lee, o eliminar sin ese permiso—, MB Suite le dice al asistente exactamente qué falta, para que te lo cuente. Para dárselo, desconecta la app en Conexiones autorizadas y vuelve a conectarla con ese permiso activado; con una API key, un owner o un admin lo cambia con Editar. Y si una respuesta es demasiado larga para un solo mensaje —una lista muy larga, por ejemplo—, llega recortada y le dice al asistente cómo pedir el resto, para que la recorra por partes.

Por el MCP no hay nada disponible de Google Ads, Business Profile, LinkedIn, TikTok ni YouTube, porque sus términos no lo permiten: el asistente no ve sus operaciones, o recibe un error que lo explica, y donde se mezclan varias plataformas —un dashboard o la atribución del CRM, por ejemplo— recibe el resto sin ellas. En el CRM no ve los tratos, prospectos, personas ni empresas que entraron o se completaron por TikTok o por LinkedIn Lead Gen, y no recibe los PDF de dashboards, informes ni envíos con datos de esas plataformas. En las pantallas de MB Suite todo funciona como siempre (qué plataformas y por qué, en API, MCP y webhooks).

¿Qué pasa con lo masivo, los envíos y lo que no se puede deshacer?

Algunas cosas no se ejecutan de una: lo que cambia muchos registros a la vez (mover o eliminar tratos en lote, por ejemplo), lo irreversible, como eliminar, lo que manda algo fuera de MB Suite —un WhatsApp, un correo, un SMS, una publicación en tus redes, una invitación a una reunión— o cambia algo en otra plataforma, y lo que tiene un costo aparte, como generar con IA o auditar un sitio. Primero el asistente pide una vista previa (dry_run) que dice qué va a pasar —qué y cuántos registros van a cambiar, qué va a salir o si tiene un costo aparte— y le devuelve un confirm_token; solo con ese código, que vale 10 minutos, puede ejecutarlo. Pídele que te muestre la vista previa antes de confirmar.

Unas pocas lo piden solo cuando de verdad mandarían algo: invitar a un miembro sin el correo de invitación, por ejemplo, se ejecuta directo. La misma vista previa le dice al asistente si necesita el código.

Borrar necesita, además, que lo hayas permitido al autorizar la app o al crear la API key. La mayoría de los borrados deja una copia 30 días en la Papelera —lo que se elimina del CRM, en la Papelera del CRM—, desde donde el owner o un admin restaura lo borrado. Si eres owner o admin, también puedes pedirle al asistente que lo restaure: cada borrado le dice qué copia quedó en la Papelera. Lo que vive fuera de MB Suite no vuelve, como una plantilla de WhatsApp en Meta o un evento de tu calendario: el asistente ve en cada operación si se puede deshacer.

Si el asistente hace muchísimas llamadas seguidas o en un mismo día, MB Suite le pide que espere y vuelva a intentar: hay un límite por minuto y uno por día que dependen de tu plan. El asistente los ve en mb_context, y los owners y admins, en la pestaña Uso.

Si el asistente no logra conectarse o MB Suite deja de responderle, revisa developers.mb-suite.com/status: ahí ves el estado de la API, el servidor MCP y los webhooks, con los incidentes en curso y los mantenimientos programados; revisa también que la API y el MCP sigan habilitados y la suscripción activa. Si lo que falla es una operación, el asistente recibe el motivo, el campo que estaba mal y un request_id: muchas veces corrige la llamada solo, y si nos escribes por eso, incluye ese código.

¿Cómo veo y desconecto las apps autorizadas?

Ve a Configuración > API y MCP y abre la pestaña MCP.
En Conexiones autorizadas ves cada app conectada por OAuth: la App, en nombre de quién actúa (Actúa como, que es quien la autorizó), un resumen de sus Permisos, las Cuentas que alcanza, cuándo quedó Conectada y su Último uso. Haz clic en la fila para ver, debajo, todos sus permisos agrupados por área. Si una app puede leer el correo y calendario conectados, sus permisos muestran Correo y calendario conectados (si la organización lo desactivó después, sale del resumen y el detalle muestra Correo y calendario conectados · pausado).
En el menú Acciones de la fila de la app (los tres puntos), elige Desconectar y confirma. La app pierde el acceso al instante; para volver a usarla, tendrá que pedir permiso de nuevo.

Las API keys no aparecen ahí: se suspenden o se revocan desde la pestaña API keys. Si no eres owner ni admin, en API y MCP ves solo las pestañas MCP y Documentación; en MCP, las apps que autorizaste tú, que puedes desconectar por tu cuenta; el owner y los admins ven las de toda la organización y pueden desconectar cualquiera. En el menú Acciones de cada app, el owner y los admins tienen además Ver en el registro, que abre la pestaña Registro filtrada por esa app. Si quien autorizó una app deja la organización, la app deja de funcionar.

Una app conectada por el MCP lee y modifica datos de tu MB Suite —contactos, empresas, tratos y actividades del CRM, las métricas de las plataformas que conectaste cuyos términos lo dejan (Meta, Google Analytics, Search Console, Facebook e Instagram; los de Google Ads, Business Profile, LinkedIn, TikTok y YouTube no dejan usarlas por el MCP) y, si se lo permites, los correos y eventos vinculados al CRM— y los procesa con su propia IA, bajo sus propios términos. Autoriza solo apps en las que confíes, con los permisos que necesitan, y desconecta las que ya no uses. El uso del MCP y el tratamiento de esos datos se rigen por nuestros Términos y Condiciones, nuestra Política de privacidad y nuestro Acuerdo de Tratamiento de Datos (DPA).

¿Te quedan más dudas?

Pregúntale a MIA, el asistente de IA de MB Suite: lo abres con el botón MB AI (⌘J) en la barra superior. MIA conoce la sección en la que estás, así que puedes consultarle sobre lo que ves en pantalla, y también responde preguntas de cómo usar MB Suite.

Conectar Claude, ChatGPT o Cursor a MB Suite con el MCP