Copera-Designs mit deinem Coding-Agent nutzen

Entwirf eine App, ein Dashboard oder eine Reihe von Seiten als Artefakt 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 Artefakt in einem Lesevorgang:

Teil	Inhalt
Spec	Die Spec des Artefakts — 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 Artefakts, einschließlich der Dateiinhalte.

Einrichtung

Token mit Drive-Zugriff erstellen

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.

Copera zu deinem Coding-Agent hinzufügen

Ersetze <YOUR_TOKEN> durch dein Token. Es sind dieselben Zeilen, die Copera im Menü Exportieren → Mit deinem Coding-Agent umsetzen eines Artefakts zeigt.

Claude Code

Im Terminal ausführen:

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

Codex

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>"

OpenCode

Als opencode.json in deinem Projekt speichern. Wenn die Datei schon existiert, füge den Eintrag copera stattdessen in ihr mcp-Objekt ein:

opencode.json

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

Cursor

Als .cursor/mcp.json in deinem Projekt speichern. Wenn die Datei schon existiert, füge den Eintrag copera stattdessen in ihr mcpServers-Objekt ein:

.cursor/mcp.json

{
  "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.

Deinen Agent bauen lassen

Kopiere den Prompt aus demselben Menü Exportieren und schick ihn an deinen Agent:

Baue das Artefakt <Name des Artefakts> aus Copera

Ergänze, was du willst, etwa "als Next.js-App mit Tailwind". Der Agent findet das Artefakt 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:

1. Spec lesen — Absicht, Nutzer und Regeln.
2. Notizen lesen — Feedback und Entscheidungen, die an Seiten angeheftet sind.
3. Design einrichten — zuerst Tokens, Komponenten, Schriften, Logos und Bilder, damit alle Seiten sie teilen.
4. Jede Seite bauen aus ihren Dateien, in ihrer Oberfläche und Viewport-Größe.
5. Links verbinden zwischen den Seiten, damit die Abläufe funktionieren.

Standardmäßig erhält der Agent die neueste erfolgreich gebaute Version des Artefakts. Für eine bestimmte Version übergib deren versionId (zu finden mit list_artifact_versions).

Große Artefakte

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).

Halte dein Token aus der Versionsverwaltung heraus

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 Artefakt-Tool	Dem Token fehlt der Drive-Zugriff (access_drive), oder Artefakte sind in deinem Workspace nicht verfügbar.
Das Artefakt wird nicht gefunden	Der Benutzer des Tokens kann dieses Artefakt 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 — Artefakte — jedes Artefakt-Tool und seine Eingaben.
• Einen MCP-Client verbinden — Endpunktdetails und Tests mit dem MCP Inspector.
• Artefakte in Drive — Artefakte in Copera erstellen, hochladen und teilen.