Utilisez les designs Copera avec votre agent de code

Concevez une app, un tableau de bord ou un ensemble de pages sous forme d'artefact dans Copera, puis confiez-le à votre agent de code pour le construire pour de vrai. Claude Code, Codex, OpenCode et Cursor se connectent à Copera MCP Cloud et lisent tout ce dont ils ont besoin en un seul appel d'outil : get_artifact_handoff.

Ce que reçoit votre agent

get_artifact_handoff renvoie l'artefact entier en une seule lecture :

Partie	Contenu
Spec	La Spec de l'artefact — à quoi il sert, qui l'utilise et comment il doit se comporter.
Notes	Les notes épinglées aux pages ou à la Spec.
Design	Le design partagé : fichiers de consignes, de tokens et de composants, ainsi que logos, polices et images avec des liens de téléchargement de courte durée.
Pages	Chaque page avec sa surface, sa taille de viewport, son fichier d'entrée et les fichiers qu'elle charge.
Liens	Comment les pages se relient entre elles (les parcours entre les écrans).
Fichiers source	Le code source de l'artefact, contenu des fichiers inclus.

Configuration

Créez un jeton avec accès au Drive

Les agents de code qui tournent sur votre ordinateur se connectent avec un Personal Access Token. Dans Copera, ouvrez Workspace Settings → Integrations, créez un Personal Access Token et donnez-lui l'accès au Drive (le scope access_drive). Copiez le jeton (cp_pat_…) — traitez-le comme un mot de passe. Voir Authentification pour plus de détails.

Ajoutez Copera à votre agent de code

Remplacez <YOUR_TOKEN> par votre jeton. Ce sont les mêmes lignes que Copera affiche dans le menu Exporter → Construisez-le avec votre agent de code d'un artefact.

Claude Code

Exécutez dans votre terminal :

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

Codex

Ajoutez à ~/.codex/config.toml:

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

Rendez ensuite le jeton disponible pour Codex :

export COPERA_TOKEN="<YOUR_TOKEN>"

OpenCode

Enregistrez ce contenu sous opencode.json dans votre projet. Si le fichier existe déjà, ajoutez plutôt l'entrée copera dans son objet mcp :

opencode.json

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

Cursor

Enregistrez ce contenu sous .cursor/mcp.json dans votre projet. Si le fichier existe déjà, ajoutez plutôt l'entrée copera dans son objet mcpServers :

.cursor/mcp.json

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

Redémarrez ou rechargez l'agent pour qu'il prenne en compte le serveur copera.

Demandez à votre agent de le construire

Copiez la demande depuis le même menu Exporter et envoyez-la à votre agent :

Construis l’artefact <nom de l'artefact> depuis Copera

Ajoutez ce que vous voulez sur votre stack, par exemple « en app Next.js avec Tailwind ». L'agent trouve l'artefact avec list_artifacts, appelle get_artifact_handoff et construit à partir du résultat.

Comment l'agent construit

get_artifact_handoff indique à l'agent quoi faire ensuite, dans cet ordre :

1. Lire la Spec — l'intention, les personnes qui l'utilisent et les règles.
2. Lire les notes — retours et décisions épinglés aux pages.
3. Mettre en place le design — d'abord tokens, composants, polices, logos et images, pour que toutes les pages les partagent.
4. Construire chaque page à partir de ses fichiers, à sa surface et à sa taille de viewport.
5. Relier les liens entre les pages pour que les parcours fonctionnent.

Par défaut, l'agent reçoit la dernière version de l'artefact construite avec succès. Pour construire une version précise, passez son versionId (trouvez-le avec list_artifact_versions).

Artefacts volumineux

Pour garder des résultats d'outils légers, le contenu des fichiers est inclus jusqu'à 32 KiB par défaut. Les fichiers plus gros reviennent marqués omitted: "over_budget", et l'agent les lit avec read_artifact_source. Si votre client accepte de gros résultats, l'agent peut augmenter maxInlineBytes (jusqu'à 1 MiB).

Gardez votre jeton hors du contrôle de version

opencode.json et .cursor/mcp.json se trouvent souvent dans un projet. Si vous y collez votre jeton, ne commitez pas le fichier. Révoquez le jeton et créez-en un nouveau dans Workspace Settings → Integrations s'il fuit.

Dépannage

Symptôme	Cause probable
401 Unauthorized	Le jeton est absent, mal saisi ou expiré. Vérifiez la valeur Authorization: Bearer ….
403 Forbidden sur un outil d'artefact	Le jeton n'a pas l'accès au Drive (access_drive), ou les Artefacts ne sont pas disponibles dans votre workspace.
L'artefact est introuvable	L'utilisateur du jeton ne peut pas ouvrir cet artefact. Demandez à son propriétaire de le partager avec vous.
L'agent vous demande de vous connecter	Il essaie de se connecter sans votre jeton. Vérifiez la ligne de configuration de l'étape 2.

Voir aussi

• Référence des outils — Artefacts — chaque outil d'artefact et ses paramètres.
• Connecter un client MCP — détails de l'endpoint et tests avec le MCP Inspector.
• Artefacts dans Drive — créez, téléversez et partagez des artefacts dans Copera.