Primeros pasos

La API de MB Suite es REST sobre HTTPS, con JSON en snake_case. Cada pedido actúa como una persona de tu organización —la que representa la API key o la que autorizó la app—, con sus permisos y nunca con más.

1. Crea una API key

1. 1Entra a MB Suite como owner o admin de la organización y abre Configuración → API y MCP → API keys.
2. 2Elige Crear API key: un nombre, a quién representa (tú, por defecto), los permisos por módulo (Lectura o Lectura y escritura) y, solo si la integración borra, Permitir eliminar.
3. 3Copia la API key: se muestra una sola vez (mbs_live_ y 46 caracteres). Guárdala como un secreto, nunca en el código de una página web ni en un repositorio.

2. Tu primer pedido: ¿quién soy?

GET /v1/me devuelve la ficha viva de la credencial: la persona, el rol, la organización, los alcances, los límites del plan, una lista corta de las Cuentas que alcanza (child_orgs_total dice cuántas son; GET /v1/orgs las lista) y, por cada módulo que puede usar, cuántas operaciones y grupos tiene. Las operaciones las trae GET /v1/catalog: con module, las de ese módulo con su descripción completa (un módulo grande, como crm, viene por grupos: se pide con group), y con ids_only=true, solo los ids de todas.

curl https://api.mb-suite.com/v1/me \
  -H "Authorization: Bearer $MB_API_KEY"

Guarda la API key en una variable de entorno (MB_API_KEY). La base de todos los pedidos es https://api.mb-suite.com/v1; la misma API responde también en https://mb-suite.com/api/platform/v1.

3. Escribe en el CRM

Crear un trato pide el embudo y la etapa: búscalos con GET /v1/crm/pipelines. Sin owner_id, el trato queda a nombre de la persona de la API key.

curl -X POST https://api.mb-suite.com/v1/crm/deals \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 2f1c9a1e-7a52-4c8b-9d0e-acme-annual" \
  -d '{
    "title": "Plan anual — Acme",
    "value": 4800,
    "currency": "USD",
    "pipeline_id": "PIPELINE_ID",
    "stage_id": "STAGE_ID"
  }'

La respuesta trae deal_id. La Idempotency-Key hace que reintentar el mismo pedido no cree dos tratos durante 24 horas.

4. Recibe los cambios sin preguntar

Para enterarte cuando entra un lead o un trato cambia de etapa, crea un webhook en Configuración → API y MCP → Webhooks: MB Suite manda un POST firmado a tu servidor. Ver Webhooks.

5. Conecta un agente de IA

Claude, ChatGPT, Cursor, VS Code, Claude Code y cualquier app compatible con MCP se conectan al servidor MCP (https://mcp.mb-suite.com) y trabajan con las mismas operaciones y los mismos permisos. Ver MCP.

Qué sigue