Usa los diseños de Copera con tu agente de programación

Diseña una app, un dashboard o un conjunto de páginas como un artefacto en Copera y luego entrégalo a tu agente de programación para construirlo de verdad. Claude Code, Codex, OpenCode y Cursor se conectan a Copera MCP Cloud y leen todo lo que necesitan con una sola llamada a una herramienta: get_artifact_handoff.

Qué recibe tu agente

get_artifact_handoff devuelve el artefacto completo en una sola lectura:

Parte	Qué contiene
Spec	La Spec del artefacto — para qué sirve, quién lo usa y cómo debe comportarse.
Notas	Las notas que las personas fijaron en las páginas o en la Spec.
Design	El diseño compartido: archivos de pautas, tokens y componentes, además de logos, fuentes e imágenes con enlaces de descarga de corta duración.
Páginas	Cada página con su superficie, tamaño de viewport, archivo de entrada y los archivos que carga.
Enlaces	Cómo se enlazan las páginas entre sí (los flujos entre pantallas).
Archivos de código	El código del artefacto, con el contenido de los archivos incluido.

Configúralo

Crea un token con acceso a Drive

Los agentes de programación que se ejecutan en tu computadora se conectan con un Personal Access Token. En Copera, abre Configuración del espacio de trabajo → Integraciones, crea un Personal Access Token y dale acceso a Drive (el alcance access_drive). Copia el token (cp_pat_…) — trátalo como una contraseña. Consulta Autenticación para más detalles.

Añade Copera a tu agente de programación

Reemplaza <YOUR_TOKEN> por tu token. Son las mismas líneas que Copera muestra en el menú Exportar → Constrúyelo con tu agente de código de un artefacto.

Claude Code

Ejecútalo en tu terminal:

claude mcp add --transport http copera https://mcp.copera.ai/mcp --header "Authorization: Bearer <YOUR_TOKEN>"

Codex

Agrégalo a ~/.codex/config.toml:

[mcp_servers.copera]
url = "https://mcp.copera.ai/mcp"
bearer_token_env_var = "COPERA_TOKEN"

Luego haz que el token esté disponible para Codex:

export COPERA_TOKEN="<YOUR_TOKEN>"

OpenCode

Guárdalo como opencode.json en tu proyecto. Si el archivo ya existe, agrega la entrada copera dentro de su objeto mcp:

opencode.json

{
  "mcp": {
    "copera": {
      "type": "remote",
      "url": "https://mcp.copera.ai/mcp",
      "headers": { "Authorization": "Bearer <YOUR_TOKEN>" }
    }
  }
}

Cursor

Guárdalo como .cursor/mcp.json en tu proyecto. Si el archivo ya existe, agrega la entrada copera dentro de su objeto mcpServers:

.cursor/mcp.json

{
  "mcpServers": {
    "copera": {
      "url": "https://mcp.copera.ai/mcp",
      "headers": { "Authorization": "Bearer <YOUR_TOKEN>" }
    }
  }
}

Reinicia o recarga el agente para que cargue el servidor copera.

Pide a tu agente que lo construya

Copia la indicación del mismo menú Exportar y envíasela a tu agente:

Construye el artefacto <nombre del artefacto> de Copera

Añade lo que quieras sobre tu stack, por ejemplo "como una app Next.js con Tailwind". El agente encuentra el artefacto con list_artifacts, llama a get_artifact_handoff y construye a partir del resultado.

Cómo construye el agente

get_artifact_handoff le indica al agente qué hacer a continuación, en este orden:

1. Leer la Spec — la intención, las personas que lo usan y las reglas.
2. Leer las notas — comentarios y decisiones fijados en las páginas.
3. Configurar el diseño — primero tokens, componentes, fuentes, logos e imágenes, para que todas las páginas los compartan.
4. Construir cada página a partir de sus archivos, con su superficie y tamaño de viewport.
5. Conectar los enlaces entre páginas para que los flujos funcionen.

Por defecto, el agente recibe la última versión del artefacto que se construyó correctamente. Para construir una versión concreta, pasa su versionId (encuéntralo con list_artifact_versions).

Artefactos grandes

Para que los resultados de las herramientas sean pequeños, el contenido de los archivos se incluye hasta 32 KiB por defecto. Los archivos más grandes vuelven marcados con omitted: "over_budget" y el agente los lee con read_artifact_source. Si tu cliente acepta resultados grandes, el agente puede subir maxInlineBytes (hasta 1 MiB).

Mantén tu token fuera del control de versiones

opencode.json y .cursor/mcp.json suelen estar dentro de un proyecto. Si pegas tu token ahí, no hagas commit del archivo. Revoca y vuelve a crear el token en Configuración del espacio de trabajo → Integraciones si alguna vez se filtra.

Solución de problemas

Síntoma	Causa probable
401 Unauthorized	El token falta, está mal escrito o caducó. Revisa el valor Authorization: Bearer ….
403 Forbidden en una herramienta de artefactos	El token no tiene acceso a Drive (access_drive), o los Artefactos no están disponibles en tu workspace.
No se encuentra el artefacto	El usuario del token no puede abrir ese artefacto. Pide a su propietario que lo comparta contigo.
El agente te pide iniciar sesión	Está intentando conectarse sin tu token. Revisa la línea de configuración del paso 2.

Relacionado

• Referencia de herramientas — Artefactos — cada herramienta de artefactos y sus entradas.
• Conectar un cliente MCP — detalles del endpoint y pruebas con el MCP Inspector.
• Artefactos en Drive — crea, sube y comparte artefactos en Copera.