MCP

MCP

O servidor MCP do DesignerBox permite que um assistente de AI trabalhe diretamente com a tua conta DesignerBox. Pede ao Claude para gerar uma foto de produto, aplicar um modelo, consultar o teu saldo de créditos ou obter um recurso da tua biblioteca, e tudo acontece na tua conta e aparece na aplicação.

MCP (Model Context Protocol) é uma norma aberta para ligar assistentes de AI a ferramentas externas. O DesignerBox disponibiliza um servidor MCP alojado, por isso não há nada para instalar nem nada para alojares por ti.

URL do servidor

Liga o teu cliente a:

https://mcp.designerbox.ai/api

O caminho é /api, não /mcp. O servidor comunica em JSON-RPC 2.0 sobre HTTP streamable.

Liga o teu assistente

Os passos exatos variam consoante o cliente, mas o formato é sempre o mesmo: adiciona um conector personalizado, cola o URL do servidor e inicia sessão.

Claude (web, Desktop e Cowork)

1. Abre Settings, depois Connectors.
2. Escolhe adicionar um conector personalizado.
3. Cola https://mcp.designerbox.ai/api.
4. Conclui o início de sessão no DesignerBox quando o teu browser abrir.
5. Inicia uma conversa e pede algo, por exemplo "lista os meus designs do DesignerBox".

O conector regista-se automaticamente, por isso não há client ID nem secret para copiar. Depois de ligado no Claude, a mesma ligação fica disponível no Cowork.

Cursor e outros clientes MCP

Qualquer cliente que suporte servidores MCP remotos sobre HTTP streamable funciona. Aponta-o para o mesmo URL. Os clientes que suportam descoberta OAuth encontram o fluxo de início de sessão por si próprios.

Autenticação

O MCP do DesignerBox usa apenas OAuth. Inicias sessão através do teu browser e o teu cliente recebe um token limitado à tua conta. Não há nenhuma chave de API para colar, e as chaves de API de outras partes do DesignerBox não são aceites aqui.

O servidor suporta registo dinâmico de clientes, por isso os clientes bem comportados configuram-se apenas a partir do URL. Os tokens são emitidos com estes scopes:

• openid - identifica a tua conta.
• mcp:read - lê os teus designs, recursos, modelos e plano.
• mcp:write - gera conteúdo media e altera os teus dados.
• offline_access - renova a sessão para que não tenhas de iniciar sessão todos os dias.

A tua adesão à equipa é verificada em cada pedido, por isso remover alguém de uma equipa revoga o seu acesso imediatamente, sem esperar que um token expire.

Para rever ou revogar um assistente ligado, abre as ligações MCP nas definições da tua conta na aplicação. Revogar aí desliga esse cliente.

O que o teu assistente pode fazer

O servidor expõe 63 ferramentas, 37 de leitura e 26 de escrita. Não precisas de aprender os nomes. Pede o que queres em linguagem natural e o assistente escolhe a ferramenta.

As áreas principais:

• Gerar. Imagens, vídeos, fotos cinema studio e AI characters.
• Editar. Remoção de fundo, reiluminação e ângulos, retoque de pele, prova virtual, flat lays e anúncios de produto.
• Modelos e técnicas. Navega no catálogo curado e aplica um modelo às tuas próprias imagens de referência.
• Biblioteca. Lista e obtém os teus designs, recursos, pastas e galerias, ou carrega um novo recurso diretamente a partir da conversa.
• Marca. Lê e atualiza o teu perfil de marca e os recursos de marca.
• Fluxos de trabalho. Lista, cria e executa pipelines a partir da tela.
• Conta. Consulta o teu plano, saldo de créditos, limites e equipas.

As ferramentas de leitura e de escrita estão identificadas para que o teu assistente saiba quais as ações que alteram a tua conta. A maioria dos clientes pede-te confirmação antes de executar uma ferramenta de escrita pela primeira vez.

Experimenta estas

• "Gera uma foto de produto de uma garrafa de água preta mate sobre uma superfície de betão."
• "Que modelos tens para flat lays de moda?"
• "Quantos créditos me restam este mês?"
• "Remove o fundo da última imagem que criaste."
• "Lista os meus designs desta semana."

Planos e créditos

As gerações gastam créditos do mesmo conjunto mensal que a aplicação utiliza. Não há dotação MCP separada nem custo adicional por usar MCP. O plano Free inclui 112 créditos (cerca de quatro imagens no modelo predefinido), por isso podes experimentar a geração antes de fazer upgrade; quando os créditos acabam, as ferramentas de geração param até a tua dotação renovar ou fazeres upgrade, enquanto as ferramentas de leitura continuam a funcionar.

O custo de uma imagem depende do modelo:

Outras operações:

Pede ao teu assistente para listar os modelos de imagem ou vídeo se quiseres os custos e capacidades atuais sem sair da conversa. Consulta Planos, Créditos e Limites para o panorama completo.

Quanto tempo demoram as coisas

Algumas ferramentas terminam na conversa, outras executam em segundo plano:

• As imagens terminam na conversa. Uma geração demora cerca de 30 segundos, e o assistente devolve a imagem quando estiver pronta.
• Os vídeos e AI characters executam em segundo plano. Recebes de imediato uma referência da tarefa, e o assistente verifica o estado até estar pronto. Podes continuar a trabalhar, ou voltar mais tarde e perguntar se já terminou.

Tudo o que geras é guardado na tua biblioteca do DesignerBox, por isso está na aplicação quer a conversa continue aberta ou não.

Limites

Os pedidos têm limite de taxa por conta. A utilização conversacional normal fica bem dentro dos limites. Se um assistente entrar em ciclo ou disparar um lote grande, pode ser limitado brevemente e deve tentar novamente.

Resolução de problemas

O assistente diz que não consegue encontrar o servidor. Verifica se o URL termina em /api. https://mcp.designerbox.ai/mcp não é válido e devolve não encontrado.

O início de sessão funciona mas as ferramentas falham com um erro de autorização. O teu token pode ter sido revogado, ou foste removido da equipa. Volta a ligar o conector.

Uma geração para e menciona créditos. Os teus créditos mensais foram gastos (o plano Free começa com 112). As ferramentas de leitura continuam a funcionar; para voltares a gerar, espera que a tua dotação renove, compra um pacote de créditos ou faz upgrade. Verifica o teu saldo na aplicação, ou pergunta ao assistente qual é o teu plano.

O assistente escolhe a ferramenta errada. Especifica bem o resultado que queres. "Aplica o modelo de flat lay de linho a esta foto" funciona melhor do que "torna isto mais bonito".

Relacionados

• API - a API REST, para código em vez de conversa.
• Planos, Créditos e Limites - como as gerações consomem créditos.
• Fluxos de Trabalho e a Tela - os pipelines que o MCP pode executar.
• Técnicas e Modelos - o catálogo que o teu assistente pode aplicar.