A página de login do Archboard não abre
Use o comando de login mostrado na configuração acima, se houver. Caso contrário, remova o Archboard do app e adicione-o de novo: o app abre a página de login quando se conecta.
Integração · MCP
Conecte o Codex ao Archboard
Com o servidor MCP do Archboard, o Codex pode listar, ler, criar e editar seus diagramas. As alterações dele aparecem ao vivo no canvas, ao lado do próprio cursor, identificado com o seu nome.
URL do servidor MCP
https://getarchboard.app/mcpSobre o Codex
O Codex é o agente de programação da OpenAI; você adiciona servidores MCP a ele pela linha de comando.
Configurar o Codex
Adicionar o Archboard ao Codex
Execute isto no seu terminal:
codex mcp add archboard --url https://getarchboard.app/mcpRequer a versão 0.147.0 ou posterior.
Quando o navegador abrir, entre no Archboard e aprove o app.
Se o navegador não abrir, execute:
codex mcp login archboardO comando adiciona o Archboard à configuração do Codex neste computador, e o Codex abre o navegador para o login.
Entre e escolha o acesso
Seu app abre o Archboard. Entre com Google ou GitHub, escolha as organizações e os espaços de trabalho que ele pode usar, escolha ler, editar ou excluir para cada um e dê um nome a ele.
Peça um diagrama
Peça ao seu agente para desenhar ou atualizar um diagrama e depois abra-o no Archboard para ver as alterações chegarem ao vivo.
Seu app de IA precisa oferecer suporte a servidores MCP remotos com login OAuth.
Experimente estes prompts
Depois de conectar, peça ao Codex em linguagem simples, por exemplo:
- “Desenhe nosso serviço de checkout no Kubernetes com Postgres e Redis.”
- “Adicione um cache ao lado de checkout-api no meu diagrama Pagamentos.”
- “Desfaça sua última alteração.”
Limites de plano
O MCP funciona em todos os planos, inclusive no Free, com os mesmos limites de plano do editor. As chamadas de ferramentas do agente também têm um limite por minuto. No Free você edita ao vivo com seus agentes de IA; editar ao vivo com colegas exige assentos Pro ou Enterprise.
- Free: 3 diagramas e 15 nós de diagrama + 150 notas, textos, desenhos, figurinhas e tópicos de mapa mental por diagrama.
- Pro e Enterprise: diagramas e nós ilimitados, além de assentos para colegas editarem ao vivo.
Solução de problemas
O agente consegue ler os diagramas, mas não alterá-los
Se você aprovou acesso somente leitura ao conectar, conecte o app de novo e aprove o acesso de edição. Se a permissão do app nesse espaço de trabalho for Ler, mude-a para Editar em Configurações → Aplicativos conectados; a mudança vale a partir da próxima chamada dele.
O agente não encontra um espaço de trabalho ou diagrama
Um app pode usar as organizações e os espaços de trabalho que você permitiu ao conectá-lo. Altere-os em Configurações → Aplicativos conectados, sem precisar reconectar.
O agente diz que um limite do plano foi atingido
O MCP tem os mesmos limites de plano do editor. Quando um limite é atingido, o agente mostra a mensagem do Archboard com um link de upgrade. Remova diagramas ou nós que não são mais necessários, ou faça upgrade para o Pro.
As chamadas falham por limite de taxa
As chamadas de ferramentas do agente têm um limite por minuto. Aguarde um momento e tente de novo; pedir menos alterações, porém maiores, ajuda.
O app não tem opção para servidores MCP personalizados
Alguns apps permitem servidores MCP personalizados apenas em certos planos ou depois que um administrador os ativa.
Abra um canvas em um minuto
Entre com Google ou GitHub. Grátis para um assento. Faça upgrade quando a equipe entrar.