Copera-Designs mit deinem Coding-Agent nutzen
Entwirf eine App, ein Dashboard oder eine Reihe von Seiten als Design in Copera und übergib es dann deinem Coding-Agent, der es richtig umsetzt. Claude Code, Codex, OpenCode und Cursor verbinden sich mit Copera MCP Cloud und lesen alles Nötige mit einem einzigen Tool-Aufruf: get_artifact_handoff.
Was dein Agent erhält
get_artifact_handoff liefert das ganze Design in einem Lesevorgang:
| Teil | Inhalt |
|---|---|
| Spec | Die Spec des Designs — wofür es gedacht ist, wer es nutzt und wie es sich verhalten soll. |
| Notizen | Die Notizen, die an Seiten oder an die Spec angeheftet wurden. |
| Design | Das gemeinsame Design: Richtlinien-, Token- und Komponentendateien sowie Logos, Schriften und Bilder mit kurzlebigen Download-Links. |
| Seiten | Jede Seite mit Oberfläche, Viewport-Größe, Einstiegsdatei und den Dateien, die sie lädt. |
| Links | Wie die Seiten miteinander verlinkt sind (die Abläufe zwischen den Screens). |
| Quelldateien | Der Quellcode des Designs, einschließlich der Dateiinhalte. |
Einrichtung
Coding-Agents, die auf deinem Computer laufen, verbinden sich mit einem Personal Access Token. Öffne in Copera Workspace-Einstellungen → Integrationen, erstelle ein Personal Access Token und gib ihm Drive-Zugriff (den Scope access_drive). Kopiere das Token (cp_pat_…) — behandle es wie ein Passwort. Details unter Authentifizierung.
Ersetze <YOUR_TOKEN> durch dein Token. Es sind dieselben Zeilen, die Copera im Menü Exportieren → Mit deinem Coding-Agent umsetzen eines Designs zeigt.
- Claude Code
- Codex
- OpenCode
- Cursor
Im Terminal ausführen:
claude mcp add --transport http copera https://mcp.copera.ai/mcp --header "Authorization: Bearer <YOUR_TOKEN>"
Zu ~/.codex/config.toml hinzufügen:
[mcp_servers.copera]
url = "https://mcp.copera.ai/mcp"
bearer_token_env_var = "COPERA_TOKEN"
Mach das Token dann für Codex verfügbar:
export COPERA_TOKEN="<YOUR_TOKEN>"
Als opencode.json in deinem Projekt speichern. Wenn die Datei schon existiert, füge den Eintrag copera stattdessen in ihr mcp-Objekt ein:
{
"mcp": {
"copera": {
"type": "remote",
"url": "https://mcp.copera.ai/mcp",
"headers": { "Authorization": "Bearer <YOUR_TOKEN>" }
}
}
}
Als .cursor/mcp.json in deinem Projekt speichern. Wenn die Datei schon existiert, füge den Eintrag copera stattdessen in ihr mcpServers-Objekt ein:
{
"mcpServers": {
"copera": {
"url": "https://mcp.copera.ai/mcp",
"headers": { "Authorization": "Bearer <YOUR_TOKEN>" }
}
}
}
Starte den Agent neu oder lade ihn neu, damit er den Server copera übernimmt.
Kopiere den Prompt aus demselben Menü Exportieren und schick ihn an deinen Agent:
Baue das Design <Name des Designs> aus Copera
Ergänze, was du willst, etwa "als Next.js-App mit Tailwind". Der Agent findet das Design mit list_artifacts, ruft get_artifact_handoff auf und baut aus dem Ergebnis.
Wie der Agent baut
get_artifact_handoff sagt dem Agent, was als Nächstes zu tun ist, in dieser Reihenfolge:
- Spec lesen — Absicht, Nutzer und Regeln.
- Notizen lesen — Feedback und Entscheidungen, die an Seiten angeheftet sind.
- Design einrichten — zuerst Tokens, Komponenten, Schriften, Logos und Bilder, damit alle Seiten sie teilen.
- Jede Seite bauen aus ihren Dateien, in ihrer Oberfläche und Viewport-Größe.
- Links verbinden zwischen den Seiten, damit die Abläufe funktionieren.
Standardmäßig erhält der Agent die neueste erfolgreich gebaute Version des Designs. Für eine bestimmte Version übergib deren versionId (zu finden mit list_artifact_versions).
Damit Tool-Ergebnisse klein bleiben, werden Dateiinhalte standardmäßig bis 32 KiB eingebettet. Größere Dateien kommen mit omitted: "over_budget" markiert zurück, und der Agent liest sie mit read_artifact_source. Akzeptiert dein Client große Ergebnisse, kann der Agent maxInlineBytes erhöhen (bis 1 MiB).
opencode.json und .cursor/mcp.json liegen oft in einem Projekt. Wenn du dort dein Token einfügst, committe die Datei nicht. Widerrufe das Token und erstelle ein neues unter Workspace-Einstellungen → Integrationen, falls es je nach außen gelangt.
Fehlerbehebung
| Symptom | Wahrscheinliche Ursache |
|---|---|
401 Unauthorized | Das Token fehlt, ist falsch geschrieben oder abgelaufen. Prüfe den Wert Authorization: Bearer …. |
403 Forbidden bei einem Design-Tool | Dem Token fehlt der Drive-Zugriff (access_drive), oder Design Artifacts ist in deinem Workspace nicht verfügbar. |
| Das Design wird nicht gefunden | Der Benutzer des Tokens kann dieses Design nicht öffnen. Bitte den Eigentümer, es mit dir zu teilen. |
| Der Agent fordert dich zur Anmeldung auf | Er versucht, sich ohne dein Token zu verbinden. Prüfe die Einrichtungszeile aus Schritt 2. |
Verwandte Themen
- Tool-Referenz — Design Artifacts — jedes Design-Tool und seine Eingaben.
- Einen MCP-Client verbinden — Endpunktdetails und Tests mit dem MCP Inspector.
- Design Artifacts in Drive — Designs in Copera erstellen, hochladen und teilen.