{"componentChunkName":"component---src-templates-docs-js","path":"/pt-pt/integrations/mcp","result":{"data":{"site":{"siteMetadata":{"title":"Documentation | DesignerBox","docsLocation":""}},"mdx":{"fields":{"id":"1cbbdc5b-9fc3-55f0-9fd2-b103d652dd18","title":"MCP","slug":"/pt-pt/integrations/mcp","locale":"pt-PT"},"body":"var _excluded = [\"components\"];\nfunction _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }\nfunction _objectWithoutProperties(e, t) { if (null == e) return {}; var o, r, i = _objectWithoutPropertiesLoose(e, t); if (Object.getOwnPropertySymbols) { var n = Object.getOwnPropertySymbols(e); for (r = 0; r < n.length; r++) o = n[r], -1 === t.indexOf(o) && {}.propertyIsEnumerable.call(e, o) && (i[o] = e[o]); } return i; }\nfunction _objectWithoutPropertiesLoose(r, e) { if (null == r) return {}; var t = {}; for (var n in r) if ({}.hasOwnProperty.call(r, n)) { if (-1 !== e.indexOf(n)) continue; t[n] = r[n]; } return t; }\n/* @jsxRuntime classic */\n/* @jsx mdx */\n\nvar _frontmatter = {\n  \"title\": \"MCP\",\n  \"metaTitle\": \"MCP DesignerBox | Liga Qualquer Assistente AI\",\n  \"metaDescription\": \"Liga o DesignerBox ao Claude, Cursor, ChatGPT e a qualquer cliente MCP. Gera imagens e vídeos, gere recursos e executa fluxos de trabalho.\",\n  \"order\": 3\n};\nvar layoutProps = {\n  _frontmatter: _frontmatter\n};\nvar MDXLayout = \"wrapper\";\nreturn function MDXContent(_ref) {\n  var components = _ref.components,\n    props = _objectWithoutProperties(_ref, _excluded);\n  return mdx(MDXLayout, _extends({}, layoutProps, props, {\n    components: components,\n    mdxType: \"MDXLayout\"\n  }), mdx(\"h1\", null, \"MCP\"), mdx(\"p\", null, \"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\\xE9ditos ou obter um recurso da tua biblioteca, e tudo acontece na tua conta e aparece na aplica\\xE7\\xE3o.\"), mdx(\"p\", null, \"MCP (Model Context Protocol) \\xE9 uma norma aberta para ligar assistentes de AI a ferramentas externas. O DesignerBox disponibiliza um servidor MCP alojado, por isso n\\xE3o h\\xE1 nada para instalar nem nada para alojares por ti.\"), mdx(\"p\", null, mdx(\"span\", {\n    parentName: \"p\",\n    \"className\": \"gatsby-resp-image-wrapper\",\n    \"style\": {\n      \"position\": \"relative\",\n      \"display\": \"block\",\n      \"marginLeft\": \"auto\",\n      \"marginRight\": \"auto\",\n      \"maxWidth\": \"800px\"\n    }\n  }, \"\\n      \", mdx(\"a\", {\n    parentName: \"span\",\n    \"className\": \"gatsby-resp-image-link\",\n    \"href\": \"/docs/static/4c3c658a490868a68460ef55f89028f7/356e8/home.jpg\",\n    \"style\": {\n      \"display\": \"block\"\n    },\n    \"target\": \"_blank\",\n    \"rel\": \"noopener\"\n  }, \"\\n    \", mdx(\"span\", {\n    parentName: \"a\",\n    \"className\": \"gatsby-resp-image-background-image\",\n    \"style\": {\n      \"paddingBottom\": \"57.00000000000001%\",\n      \"position\": \"relative\",\n      \"bottom\": \"0\",\n      \"left\": \"0\",\n      \"backgroundImage\": \"url('data:image/jpeg;base64,/9j/2wBDABALDA4MChAODQ4SERATGCgaGBYWGDEjJR0oOjM9PDkzODdASFxOQERXRTc4UG1RV19iZ2hnPk1xeXBkeFxlZ2P/2wBDARESEhgVGC8aGi9jQjhCY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2P/wgARCAALABQDASIAAhEBAxEB/8QAFwABAQEBAAAAAAAAAAAAAAAAAAUBBP/EABUBAQEAAAAAAAAAAAAAAAAAAAAB/9oADAMBAAIQAxAAAAHun1Z5gj//xAAbEAABBAMAAAAAAAAAAAAAAAABAAIDBBMyNP/aAAgBAQABBQKyZQclxNktKfVnKSQv/8QAFBEBAAAAAAAAAAAAAAAAAAAAEP/aAAgBAwEBPwE//8QAFBEBAAAAAAAAAAAAAAAAAAAAEP/aAAgBAgEBPwE//8QAHhAAAgEDBQAAAAAAAAAAAAAAAAECITGSEBETgZH/2gAIAQEABj8Cjxb9ItLEqpY6XfpRs//EABsQAQACAwEBAAAAAAAAAAAAAAEAMREhQXEQ/9oACAEBAAE/IcfKudnz6S9Fe2+eRPseouAjB2f/2gAMAwEAAgADAAAAEEP/AP/EABURAQEAAAAAAAAAAAAAAAAAAAAR/9oACAEDAQE/EEf/xAAVEQEBAAAAAAAAAAAAAAAAAAAAEf/aAAgBAgEBPxBX/8QAHhAAAgICAgMAAAAAAAAAAAAAAREAITFBUXGBkdH/2gAIAQEAAT8QIChqlmEMdxGzw+QzNpTEV6hlIBbIg5cQkmcvdmttx8GSfgT/2Q==')\",\n      \"backgroundSize\": \"cover\",\n      \"display\": \"block\"\n    }\n  }), \"\\n  \", mdx(\"img\", {\n    parentName: \"a\",\n    \"className\": \"gatsby-resp-image-image\",\n    \"alt\": \"A aplicação DesignerBox, cujas funcionalidades de geração e recursos estão também disponíveis através do MCP\",\n    \"title\": \"A aplicação DesignerBox, cujas funcionalidades de geração e recursos estão também disponíveis através do MCP\",\n    \"src\": \"/docs/static/4c3c658a490868a68460ef55f89028f7/4b190/home.jpg\",\n    \"srcSet\": [\"/docs/static/4c3c658a490868a68460ef55f89028f7/e07e9/home.jpg 200w\", \"/docs/static/4c3c658a490868a68460ef55f89028f7/066f9/home.jpg 400w\", \"/docs/static/4c3c658a490868a68460ef55f89028f7/4b190/home.jpg 800w\", \"/docs/static/4c3c658a490868a68460ef55f89028f7/e5166/home.jpg 1200w\", \"/docs/static/4c3c658a490868a68460ef55f89028f7/356e8/home.jpg 1512w\"],\n    \"sizes\": \"(max-width: 800px) 100vw, 800px\",\n    \"style\": {\n      \"width\": \"100%\",\n      \"height\": \"100%\",\n      \"margin\": \"0\",\n      \"verticalAlign\": \"middle\",\n      \"position\": \"absolute\",\n      \"top\": \"0\",\n      \"left\": \"0\"\n    },\n    \"loading\": \"lazy\"\n  }), \"\\n  \"), \"\\n    \")), mdx(\"h2\", null, \"URL do servidor\"), mdx(\"p\", null, \"Liga o teu cliente a:\"), mdx(\"pre\", null, mdx(\"code\", {\n    parentName: \"pre\"\n  }, \"https://mcp.designerbox.ai/api\\n\")), mdx(\"p\", null, \"O caminho \\xE9 \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"/api\"), \", n\\xE3o \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"/mcp\"), \". O servidor comunica em JSON-RPC 2.0 sobre HTTP streamable.\"), mdx(\"h2\", null, \"Liga o teu assistente\"), mdx(\"p\", null, \"Os passos exatos variam consoante o cliente, mas o formato \\xE9 sempre o mesmo: adiciona um conector personalizado, cola o URL do servidor e inicia sess\\xE3o.\"), mdx(\"h3\", null, \"Claude (web, Desktop e Cowork)\"), mdx(\"ol\", null, mdx(\"li\", {\n    parentName: \"ol\"\n  }, \"Abre Settings, depois Connectors.\"), mdx(\"li\", {\n    parentName: \"ol\"\n  }, \"Escolhe adicionar um conector personalizado.\"), mdx(\"li\", {\n    parentName: \"ol\"\n  }, \"Cola \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"https://mcp.designerbox.ai/api\"), \".\"), mdx(\"li\", {\n    parentName: \"ol\"\n  }, \"Conclui o in\\xEDcio de sess\\xE3o no DesignerBox quando o teu browser abrir.\"), mdx(\"li\", {\n    parentName: \"ol\"\n  }, \"Inicia uma conversa e pede algo, por exemplo \\\"lista os meus designs do DesignerBox\\\".\")), mdx(\"p\", null, \"O conector regista-se automaticamente, por isso n\\xE3o h\\xE1 client ID nem secret para copiar. Depois de ligado no Claude, a mesma liga\\xE7\\xE3o fica dispon\\xEDvel no Cowork.\"), mdx(\"h3\", null, \"Cursor e outros clientes MCP\"), mdx(\"p\", null, \"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\\xEDcio de sess\\xE3o por si pr\\xF3prios.\"), mdx(\"h2\", null, \"Autentica\\xE7\\xE3o\"), mdx(\"p\", null, \"O MCP do DesignerBox usa \", mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"apenas OAuth\"), \". Inicias sess\\xE3o atrav\\xE9s do teu browser e o teu cliente recebe um token limitado \\xE0 tua conta. N\\xE3o h\\xE1 nenhuma chave de API para colar, e as chaves de API de outras partes do DesignerBox n\\xE3o s\\xE3o aceites aqui.\"), mdx(\"p\", null, \"O servidor suporta registo din\\xE2mico de clientes, por isso os clientes bem comportados configuram-se apenas a partir do URL. Os tokens s\\xE3o emitidos com estes scopes:\"), mdx(\"ul\", null, mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"openid\"), \" - identifica a tua conta.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"mcp:read\"), \" - l\\xEA os teus designs, recursos, modelos e plano.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"mcp:write\"), \" - gera conte\\xFAdo media e altera os teus dados.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"offline_access\"), \" - renova a sess\\xE3o para que n\\xE3o tenhas de iniciar sess\\xE3o todos os dias.\")), mdx(\"p\", null, \"A tua ades\\xE3o \\xE0 equipa \\xE9 verificada em cada pedido, por isso remover algu\\xE9m de uma equipa revoga o seu acesso imediatamente, sem esperar que um token expire.\"), mdx(\"p\", null, \"Para rever ou revogar um assistente ligado, abre as liga\\xE7\\xF5es MCP nas defini\\xE7\\xF5es da tua conta na aplica\\xE7\\xE3o. Revogar a\\xED desliga esse cliente.\"), mdx(\"h2\", null, \"O que o teu assistente pode fazer\"), mdx(\"p\", null, \"O servidor exp\\xF5e 63 ferramentas, 37 de leitura e 26 de escrita. N\\xE3o precisas de aprender os nomes. Pede o que queres em linguagem natural e o assistente escolhe a ferramenta.\"), mdx(\"p\", null, \"As \\xE1reas principais:\"), mdx(\"ul\", null, mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"strong\", {\n    parentName: \"li\"\n  }, \"Gerar.\"), \" Imagens, v\\xEDdeos, fotos cinema studio e AI characters.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"strong\", {\n    parentName: \"li\"\n  }, \"Editar.\"), \" Remo\\xE7\\xE3o de fundo, reilumina\\xE7\\xE3o e \\xE2ngulos, retoque de pele, prova virtual, flat lays e an\\xFAncios de produto.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"strong\", {\n    parentName: \"li\"\n  }, \"Modelos e t\\xE9cnicas.\"), \" Navega no cat\\xE1logo curado e aplica um modelo \\xE0s tuas pr\\xF3prias imagens de refer\\xEAncia.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"strong\", {\n    parentName: \"li\"\n  }, \"Biblioteca.\"), \" Lista e obt\\xE9m os teus designs, recursos, pastas e galerias, ou carrega um novo recurso diretamente a partir da conversa.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"strong\", {\n    parentName: \"li\"\n  }, \"Marca.\"), \" L\\xEA e atualiza o teu perfil de marca e os recursos de marca.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"strong\", {\n    parentName: \"li\"\n  }, \"Fluxos de trabalho.\"), \" Lista, cria e executa pipelines a partir da tela.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"strong\", {\n    parentName: \"li\"\n  }, \"Conta.\"), \" Consulta o teu plano, saldo de cr\\xE9ditos, limites e equipas.\")), mdx(\"p\", null, \"As ferramentas de leitura e de escrita est\\xE3o identificadas para que o teu assistente saiba quais as a\\xE7\\xF5es que alteram a tua conta. A maioria dos clientes pede-te confirma\\xE7\\xE3o antes de executar uma ferramenta de escrita pela primeira vez.\"), mdx(\"h3\", null, \"Experimenta estas\"), mdx(\"ul\", null, mdx(\"li\", {\n    parentName: \"ul\"\n  }, \"\\\"Gera uma foto de produto de uma garrafa de \\xE1gua preta mate sobre uma superf\\xEDcie de bet\\xE3o.\\\"\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, \"\\\"Que modelos tens para flat lays de moda?\\\"\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, \"\\\"Quantos cr\\xE9ditos me restam este m\\xEAs?\\\"\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, \"\\\"Remove o fundo da \\xFAltima imagem que criaste.\\\"\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, \"\\\"Lista os meus designs desta semana.\\\"\")), mdx(\"h2\", null, \"Planos e cr\\xE9ditos\"), mdx(\"p\", null, \"As gera\\xE7\\xF5es gastam cr\\xE9ditos do mesmo conjunto mensal que a aplica\\xE7\\xE3o utiliza. N\\xE3o h\\xE1 dota\\xE7\\xE3o MCP separada nem custo adicional por usar MCP. O plano Free inclui 112 cr\\xE9ditos (cerca de quatro imagens no modelo predefinido), por isso podes experimentar a gera\\xE7\\xE3o antes de fazer upgrade; quando os cr\\xE9ditos acabam, as ferramentas de gera\\xE7\\xE3o param at\\xE9 a tua dota\\xE7\\xE3o renovar ou fazeres upgrade, enquanto as ferramentas de leitura continuam a funcionar.\"), mdx(\"p\", null, \"O custo de uma imagem depende do modelo:\"), mdx(\"table\", null, mdx(\"thead\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"thead\"\n  }, mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Modelo\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Cr\\xE9ditos por imagem\"))), mdx(\"tbody\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Seedream 5\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"4\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"FLUX Pro 1.1\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"5\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Nano Banana 2\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"7\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"FLUX 2 Flex\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"7\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Nano Banana Pro\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"14\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"GPT Image 2\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"22\")))), mdx(\"p\", null, \"Outras opera\\xE7\\xF5es:\"), mdx(\"table\", null, mdx(\"thead\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"thead\"\n  }, mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Opera\\xE7\\xE3o\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Cr\\xE9ditos\"))), mdx(\"tbody\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Aplicar uma t\\xE9cnica a uma imagem\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"O custo por imagem do modelo escolhido (14 no modelo predefinido)\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Remover fundo\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"3\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Cinema studio\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"2 por imagem\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"AI character (9 poses)\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"25\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"V\\xEDdeo\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Taxa do modelo por segundo, vezes a dura\\xE7\\xE3o\")))), mdx(\"p\", null, \"Pede ao teu assistente para listar os modelos de imagem ou v\\xEDdeo se quiseres os custos e capacidades atuais sem sair da conversa. Consulta \", mdx(\"a\", {\n    parentName: \"p\",\n    \"href\": \"/docs/pt-pt/knowledge-base/plans-credits-and-limits\"\n  }, \"Planos, Cr\\xE9ditos e Limites\"), \" para o panorama completo.\"), mdx(\"h2\", null, \"Quanto tempo demoram as coisas\"), mdx(\"p\", null, \"Algumas ferramentas terminam na conversa, outras executam em segundo plano:\"), mdx(\"ul\", null, mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"strong\", {\n    parentName: \"li\"\n  }, \"As imagens terminam na conversa.\"), \" Uma gera\\xE7\\xE3o demora cerca de 30 segundos, e o assistente devolve a imagem quando estiver pronta.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"strong\", {\n    parentName: \"li\"\n  }, \"Os v\\xEDdeos e AI characters executam em segundo plano.\"), \" Recebes de imediato uma refer\\xEAncia da tarefa, e o assistente verifica o estado at\\xE9 estar pronto. Podes continuar a trabalhar, ou voltar mais tarde e perguntar se j\\xE1 terminou.\")), mdx(\"p\", null, \"Tudo o que geras \\xE9 guardado na tua biblioteca do DesignerBox, por isso est\\xE1 na aplica\\xE7\\xE3o quer a conversa continue aberta ou n\\xE3o.\"), mdx(\"h2\", null, \"Limites\"), mdx(\"p\", null, \"Os pedidos t\\xEAm limite de taxa por conta. A utiliza\\xE7\\xE3o 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.\"), mdx(\"h2\", null, \"Resolu\\xE7\\xE3o de problemas\"), mdx(\"p\", null, mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"O assistente diz que n\\xE3o consegue encontrar o servidor.\"), \" Verifica se o URL termina em \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"/api\"), \". \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"https://mcp.designerbox.ai/mcp\"), \" n\\xE3o \\xE9 v\\xE1lido e devolve n\\xE3o encontrado.\"), mdx(\"p\", null, mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"O in\\xEDcio de sess\\xE3o funciona mas as ferramentas falham com um erro de autoriza\\xE7\\xE3o.\"), \" O teu token pode ter sido revogado, ou foste removido da equipa. Volta a ligar o conector.\"), mdx(\"p\", null, mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"Uma gera\\xE7\\xE3o para e menciona cr\\xE9ditos.\"), \" Os teus cr\\xE9ditos mensais foram gastos (o plano Free come\\xE7a com 112). As ferramentas de leitura continuam a funcionar; para voltares a gerar, espera que a tua dota\\xE7\\xE3o renove, compra um pacote de cr\\xE9ditos ou faz upgrade. Verifica o teu saldo na aplica\\xE7\\xE3o, ou pergunta ao assistente qual \\xE9 o teu plano.\"), mdx(\"p\", null, mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"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\\\".\"), mdx(\"h2\", null, \"Relacionados\"), mdx(\"ul\", null, mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"a\", {\n    parentName: \"li\",\n    \"href\": \"/docs/pt-pt/integrations/api\"\n  }, \"API\"), \" - a API REST, para c\\xF3digo em vez de conversa.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"a\", {\n    parentName: \"li\",\n    \"href\": \"/docs/pt-pt/knowledge-base/plans-credits-and-limits\"\n  }, \"Planos, Cr\\xE9ditos e Limites\"), \" - como as gera\\xE7\\xF5es consomem cr\\xE9ditos.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"a\", {\n    parentName: \"li\",\n    \"href\": \"/docs/pt-pt/features/workflows-and-canvas\"\n  }, \"Fluxos de Trabalho e a Tela\"), \" - os pipelines que o MCP pode executar.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"a\", {\n    parentName: \"li\",\n    \"href\": \"/docs/pt-pt/features/techniques-and-templates\"\n  }, \"T\\xE9cnicas e Modelos\"), \" - o cat\\xE1logo que o teu assistente pode aplicar.\")));\n}\n;\nMDXContent.isMDXComponent = true;","rawBody":"---\ntitle: \"MCP\"\nmetaTitle: \"MCP DesignerBox | Liga Qualquer Assistente AI\"\nmetaDescription: \"Liga o DesignerBox ao Claude, Cursor, ChatGPT e a qualquer cliente MCP. Gera imagens e vídeos, gere recursos e executa fluxos de trabalho.\"\norder: 3\n---\n\n# MCP\n\nO 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.\n\nMCP (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.\n\n![A aplicação DesignerBox, cujas funcionalidades de geração e recursos estão também disponíveis através do MCP](../images/docs/home.jpg)\n\n## URL do servidor\n\nLiga o teu cliente a:\n\n```\nhttps://mcp.designerbox.ai/api\n```\n\nO caminho é `/api`, não `/mcp`. O servidor comunica em JSON-RPC 2.0 sobre HTTP streamable.\n\n## Liga o teu assistente\n\nOs 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.\n\n### Claude (web, Desktop e Cowork)\n\n1. Abre Settings, depois Connectors.\n2. Escolhe adicionar um conector personalizado.\n3. Cola `https://mcp.designerbox.ai/api`.\n4. Conclui o início de sessão no DesignerBox quando o teu browser abrir.\n5. Inicia uma conversa e pede algo, por exemplo \"lista os meus designs do DesignerBox\".\n\nO 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.\n\n### Cursor e outros clientes MCP\n\nQualquer 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.\n\n## Autenticação\n\nO 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.\n\nO 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:\n\n- `openid` - identifica a tua conta.\n- `mcp:read` - lê os teus designs, recursos, modelos e plano.\n- `mcp:write` - gera conteúdo media e altera os teus dados.\n- `offline_access` - renova a sessão para que não tenhas de iniciar sessão todos os dias.\n\nA 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.\n\nPara 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.\n\n## O que o teu assistente pode fazer\n\nO 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.\n\nAs áreas principais:\n\n- **Gerar.** Imagens, vídeos, fotos cinema studio e AI characters.\n- **Editar.** Remoção de fundo, reiluminação e ângulos, retoque de pele, prova virtual, flat lays e anúncios de produto.\n- **Modelos e técnicas.** Navega no catálogo curado e aplica um modelo às tuas próprias imagens de referência.\n- **Biblioteca.** Lista e obtém os teus designs, recursos, pastas e galerias, ou carrega um novo recurso diretamente a partir da conversa.\n- **Marca.** Lê e atualiza o teu perfil de marca e os recursos de marca.\n- **Fluxos de trabalho.** Lista, cria e executa pipelines a partir da tela.\n- **Conta.** Consulta o teu plano, saldo de créditos, limites e equipas.\n\nAs 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.\n\n### Experimenta estas\n\n- \"Gera uma foto de produto de uma garrafa de água preta mate sobre uma superfície de betão.\"\n- \"Que modelos tens para flat lays de moda?\"\n- \"Quantos créditos me restam este mês?\"\n- \"Remove o fundo da última imagem que criaste.\"\n- \"Lista os meus designs desta semana.\"\n\n## Planos e créditos\n\nAs 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.\n\nO custo de uma imagem depende do modelo:\n\n| Modelo | Créditos por imagem |\n|-------|-------------------|\n| Seedream 5 | 4 |\n| FLUX Pro 1.1 | 5 |\n| Nano Banana 2 | 7 |\n| FLUX 2 Flex | 7 |\n| Nano Banana Pro | 14 |\n| GPT Image 2 | 22 |\n\nOutras operações:\n\n| Operação | Créditos |\n|-----------|---------|\n| Aplicar uma técnica a uma imagem | O custo por imagem do modelo escolhido (14 no modelo predefinido) |\n| Remover fundo | 3 |\n| Cinema studio | 2 por imagem |\n| AI character (9 poses) | 25 |\n| Vídeo | Taxa do modelo por segundo, vezes a duração |\n\nPede 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](/pt-pt/knowledge-base/plans-credits-and-limits) para o panorama completo.\n\n## Quanto tempo demoram as coisas\n\nAlgumas ferramentas terminam na conversa, outras executam em segundo plano:\n\n- **As imagens terminam na conversa.** Uma geração demora cerca de 30 segundos, e o assistente devolve a imagem quando estiver pronta.\n- **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.\n\nTudo o que geras é guardado na tua biblioteca do DesignerBox, por isso está na aplicação quer a conversa continue aberta ou não.\n\n## Limites\n\nOs 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.\n\n## Resolução de problemas\n\n**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.\n\n**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.\n\n**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.\n\n**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\".\n\n## Relacionados\n\n- [API](/pt-pt/integrations/api) - a API REST, para código em vez de conversa.\n- [Planos, Créditos e Limites](/pt-pt/knowledge-base/plans-credits-and-limits) - como as gerações consomem créditos.\n- [Fluxos de Trabalho e a Tela](/pt-pt/features/workflows-and-canvas) - os pipelines que o MCP pode executar.\n- [Técnicas e Modelos](/pt-pt/features/techniques-and-templates) - o catálogo que o teu assistente pode aplicar.\n","tableOfContents":{"items":[{"url":"#mcp","title":"MCP","items":[{"url":"#url-do-servidor","title":"URL do servidor"},{"url":"#liga-o-teu-assistente","title":"Liga o teu assistente","items":[{"url":"#claude-web-desktop-e-cowork","title":"Claude (web, Desktop e Cowork)"},{"url":"#cursor-e-outros-clientes-mcp","title":"Cursor e outros clientes MCP"}]},{"url":"#autenticação","title":"Autenticação"},{"url":"#o-que-o-teu-assistente-pode-fazer","title":"O que o teu assistente pode fazer","items":[{"url":"#experimenta-estas","title":"Experimenta estas"}]},{"url":"#planos-e-créditos","title":"Planos e créditos"},{"url":"#quanto-tempo-demoram-as-coisas","title":"Quanto tempo demoram as coisas"},{"url":"#limites","title":"Limites"},{"url":"#resolução-de-problemas","title":"Resolução de problemas"},{"url":"#relacionados","title":"Relacionados"}]}]},"parent":{"__typename":"File","relativePath":"pt-pt/integrations/mcp.md"},"frontmatter":{"metaTitle":"MCP DesignerBox | Liga Qualquer Assistente AI","metaDescription":"Liga o DesignerBox ao Claude, Cursor, ChatGPT e a qualquer cliente MCP. Gera imagens e vídeos, gere recursos e executa fluxos de trabalho.","order":3}},"allMdx":{"edges":[{"node":{"fields":{"slug":"/pt-pt/features","title":"Funcionalidades"}}},{"node":{"fields":{"slug":"/pt-pt/guides","title":"Guias"}}},{"node":{"fields":{"slug":"/pt-pt/knowledge-base","title":"Base de Conhecimento"}}},{"node":{"fields":{"slug":"/pt-pt/integrations","title":"Integrações"}}},{"node":{"fields":{"slug":"/pt-pt/pricing-faqs","title":"FAQs de Preços"}}},{"node":{"fields":{"slug":"/pt-pt/guides/creating-videos","title":"Criar Vídeos"}}},{"node":{"fields":{"slug":"/pt-pt/guides/create-your-first-image","title":"Cria a Tua Primeira Imagem"}}},{"node":{"fields":{"slug":"/pt-pt/guides/teams-and-brand-profiles","title":"Equipas e Perfis de Marca"}}},{"node":{"fields":{"slug":"/pt-pt/features/ai-assistant","title":"DesignerBox AI"}}},{"node":{"fields":{"slug":"/pt-pt/features/apps","title":"Apps"}}},{"node":{"fields":{"slug":"/pt-pt/features/avatars-and-models","title":"AI Character"}}},{"node":{"fields":{"slug":"/pt-pt/guides/using-techniques-and-templates","title":"Utilizar Técnicas e Modelos"}}},{"node":{"fields":{"slug":"/pt-pt/features/brand-profile","title":"Perfil de Marca e Biblioteca"}}},{"node":{"fields":{"slug":"/pt-pt/features/photo-packs","title":"Photo Packs"}}},{"node":{"fields":{"slug":"/pt-pt/features/gallery","title":"Gallery"}}},{"node":{"fields":{"slug":"/pt-pt/guides/building-workflows-on-the-canvas","title":"Criar Fluxos de Trabalho na Tela"}}},{"node":{"fields":{"slug":"/pt-pt/features/image-generation","title":"AI Image"}}},{"node":{"fields":{"slug":"/pt-pt/features/cinema-studio","title":"Cinema Studio"}}},{"node":{"fields":{"slug":"/pt-pt/features/relighting-and-angles","title":"Iluminação e Ângulos"}}},{"node":{"fields":{"slug":"/pt-pt/features/skills","title":"Skills"}}},{"node":{"fields":{"slug":"/pt-pt/features/stock-and-audio","title":"Stock Library and Audio"}}},{"node":{"fields":{"slug":"/pt-pt/features/upscaling","title":"Ampliação"}}},{"node":{"fields":{"slug":"/pt-pt/features/video-studio","title":"Video Studio"}}},{"node":{"fields":{"slug":"/pt-pt/features/techniques-and-templates","title":"Técnicas e Modelos"}}},{"node":{"fields":{"slug":"/pt-pt/features/video","title":"AI Video"}}},{"node":{"fields":{"slug":"/pt-pt/features/community","title":"Comunidade"}}},{"node":{"fields":{"slug":"/pt-pt/features/workflows-and-canvas","title":"Fluxos de Trabalho e a Tela"}}},{"node":{"fields":{"slug":"/pt-pt/integrations/chrome-extension","title":"Extensão Chrome"}}},{"node":{"fields":{"slug":"/pt-pt/integrations/mcp","title":"MCP"}}},{"node":{"fields":{"slug":"/pt-pt/integrations/api","title":"API"}}},{"node":{"fields":{"slug":"/pt-pt/features/virtual-try-on","title":"Virtual Try-On"}}},{"node":{"fields":{"slug":"/pt-pt/knowledge-base/plans-credits-and-limits","title":"Planos, Créditos e Limites"}}},{"node":{"fields":{"slug":"/pt-pt/integrations/white-label","title":"Marca Branca"}}},{"node":{"fields":{"slug":"/pt-pt/knowledge-base/referrals","title":"Referrals and Free Credits"}}},{"node":{"fields":{"slug":"/pt-pt/knowledge-base/understanding-declined-card-payments","title":"Compreender Pagamentos Recusados"}}},{"node":{"fields":{"slug":"/pt-pt/knowledge-base/how-to-update-card-details","title":"Como Atualizar os Dados do Cartão"}}},{"node":{"fields":{"slug":"/pt-pt/features/workflows-and-canvas/node-types","title":"Tipos de Nós"}}},{"node":{"fields":{"slug":"/pt-pt/features/image-generation/editing-modes","title":"Modos de Edição"}}},{"node":{"fields":{"slug":"/pt-pt","title":"Documentação DesignerBox"}}}]}},"pageContext":{"id":"1cbbdc5b-9fc3-55f0-9fd2-b103d652dd18","locale":"pt-PT"}},"staticQueryHashes":["361965504","361965504","417421954","417421954","445494767","445494767"]}