Primeiros passos

A API do MB Suite é REST sobre HTTPS, com JSON em snake_case. Cada pedido age como uma pessoa da sua organização —a que a API key representa ou a que autorizou o app—, com as permissões dela e nunca mais.

1. Crie uma API key

1. 1Entre no MB Suite como owner ou admin da organização e abra Configurações → API e MCP → API keys.
2. 2Escolha Criar API key: um nome, quem ela representa (você, por padrão), as permissões por módulo (Leitura ou Leitura e escrita) e, só se a integração exclui, Permitir exclusões.
3. 3Copie a API key: ela aparece uma única vez (mbs_live_ e 46 caracteres). Guarde-a como um segredo, nunca no código de uma página web nem num repositório.

2. Seu primeiro pedido: quem sou eu?

GET /v1/me devolve a ficha viva da credencial: a pessoa, o papel, a organização, os escopos, os limites do plano, uma lista curta das Contas que alcança (child_orgs_total diz quantas são; GET /v1/orgs as lista) e, para cada módulo que pode usar, quantas operações e grupos tem. As operações vêm de GET /v1/catalog: com module, as desse módulo com a descrição completa (um módulo grande, como crm, vem por grupos: peça um com group), e com ids_only=true, só os ids de todas.

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

Guarde a API key numa variável de ambiente (MB_API_KEY). A base de todos os pedidos é https://api.mb-suite.com/v1; a mesma API responde também em https://mb-suite.com/api/platform/v1.

3. Escreva no CRM

Criar um negócio pede o funil e a etapa: busque-os com GET /v1/crm/pipelines. Sem owner_id, o negócio fica no nome da pessoa da 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"
  }'

A resposta traz deal_id. A Idempotency-Key faz com que repetir o mesmo pedido não crie dois negócios durante 24 horas.

4. Receba as mudanças sem perguntar

Para saber quando entra um lead ou um negócio muda de etapa, crie um webhook em Configurações → API e MCP → Webhooks: o MB Suite envia um POST assinado ao seu servidor. Veja Webhooks.

5. Conecte um agente de IA

Claude, ChatGPT, Cursor, VS Code, Claude Code e qualquer app compatível com MCP se conectam ao servidor MCP (https://mcp.mb-suite.com) e trabalham com as mesmas operações e as mesmas permissões. Veja MCP.

Próximos passos