Saltar al contenido

Integración · MCP

Conecta Codex a Archboard

Con el servidor MCP de Archboard, Codex puede listar, leer, crear y editar tus diagramas. Sus cambios aparecen en vivo en el lienzo, junto a su propio cursor etiquetado con tu nombre.

URL del servidor MCPhttps://getarchboard.app/mcp

Acerca de Codex

Codex es el agente de programación de OpenAI; le agregas servidores MCP desde la línea de comandos.

Configurar Codex

  1. Agregar Archboard a Codex

    Ejecuta esto en tu terminal:

    codex mcp add archboard --url https://getarchboard.app/mcp

    Requiere la versión 0.147.0 o posterior.

    Cuando se abra tu navegador, inicia sesión en Archboard y aprueba la app.

    Si el navegador no se abre, ejecuta:

    codex mcp login archboard

    El comando agrega Archboard a la configuración de Codex en este ordenador, y Codex abre el navegador para iniciar sesión.

  2. Inicia sesión y elige el acceso

    Tu app abre Archboard. Inicia sesión con Google o GitHub, elige las organizaciones y los espacios de trabajo que puede usar, elige leer, editar o eliminar para cada uno y ponle un nombre.

  3. Pide un diagrama

    Pídele a tu agente que dibuje o actualice un diagrama y luego ábrelo en Archboard para ver cómo llegan los cambios en vivo.

Tu app de IA debe admitir servidores MCP remotos con inicio de sesión OAuth.

Prueba estos prompts

Una vez conectado, pídeselo a Codex con palabras sencillas, por ejemplo:

  • “Dibuja nuestro servicio de checkout en Kubernetes con Postgres y Redis.”
  • “Agrega una caché junto a checkout-api en mi diagrama Pagos.”
  • “Deshaz tu último cambio.”
Prompts de ejemplo y los diagramas que dibujan

Límites de plan

MCP funciona en todos los planes, incluido Free, con los mismos límites de plan que el editor. Las llamadas a herramientas del agente tienen además un límite por minuto. En Free editas en vivo con tus agentes de IA; editar en vivo con compañeros requiere asientos Pro o Enterprise.

  • Free: 3 diagramas y 15 nodos de diagrama + 150 notas, textos, dibujos, pegatinas y temas de mapa mental por diagrama.
  • Pro y Enterprise: diagramas y nodos ilimitados, además de asientos para que tus compañeros editen en vivo.
Ver precios

Solución de problemas

No se abre la página de inicio de sesión de Archboard

Usa el comando de inicio de sesión que aparece en la configuración de arriba, si lo hay. Si no, quita Archboard de la app y vuelve a agregarlo: la app abre la página de inicio de sesión cuando se conecta.

El agente puede leer los diagramas, pero no cambiarlos

Si al conectar aprobaste acceso de solo lectura, vuelve a conectar la app y aprueba el acceso de edición. Si el permiso de la app en ese espacio de trabajo es Leer, cámbialo a Editar en Ajustes → Aplicaciones conectadas; el cambio se aplica en su siguiente llamada.

El agente no encuentra un espacio de trabajo o un diagrama

Una app puede usar las organizaciones y los espacios de trabajo que permitiste al conectarla. Cámbialos en Ajustes → Aplicaciones conectadas, sin volver a conectar.

El agente dice que se alcanzó un límite del plan

MCP tiene los mismos límites de plan que el editor. Cuando se alcanza un límite, el agente muestra el mensaje de Archboard con un enlace para mejorar el plan. Quita los diagramas o nodos que ya no necesites, o pásate a Pro.

Las llamadas fallan por un límite de frecuencia

Las llamadas a herramientas del agente tienen un límite por minuto. Espera un momento y vuelve a intentarlo; ayuda pedir menos cambios, pero más grandes.

La app no tiene opción para servidores MCP personalizados

Algunas apps permiten servidores MCP personalizados solo en ciertos planes o después de que un administrador los active.

Abre un lienzo en un minuto

Inicia sesión con Google o GitHub. Gratis para un asiento. Mejora el plan cuando se una el equipo.