Zum Hauptinhalt springen

MCP-Tool-Referenz

Diese Seite listet 52 Tools von Copera MCP Cloud in zehn Domänen auf. Jedes Tool ist ein dünner Wrapper über einen Endpunkt der Copera Public API — die Spalte Public-API-Fähigkeit zeigt den darunterliegenden Endpunkt.

DomäneTools
Workspace3
Board11
Suche1
Docs8
Benachrichtigungen3
Chat2
Kommentar3
Drive5
Export1
Design Artifacts15
Gesamt52
Discovery ist explizit

Der Server ist zustandslos, daher brauchen Board-/Tabellen-/Zeilen-Tools explizite Hex-ObjectIds. Der Discovery-Flow ist get_workspace_info → list_boards → list_tables → get_table_schema → list_rows. Rufen Sie vor dem Schreiben von Zeilen immer get_table_schema auf, damit Sie echte columnIds und gültige Options-IDs verwenden.

Workspace​

Scope: workspace-weit (Ergebnisse nach Token-Berechtigungen gefiltert).

ToolBeschreibungPublic-API-Fähigkeit
get_workspace_infoBasis-Metadaten des Workspace, zu dem das Token gehört (Name, Slug, Seat-Anzahl, Zeitstempel).GET /workspace/info
list_workspace_membersMembers listen, um eine User-ID aus Name oder E-Mail aufzulösen; offset-paginiert, optionales query.GET /workspace/members
list_workspace_teamsTeams mit Teilnehmer-User-IDs listen; offset-paginiert, optionales query.GET /workspace/teams

Board​

Scope: access_boards. Der Discovery → Query → Write-Loop über Boards, Tabellen und Zeilen.

ToolBeschreibungPublic-API-Fähigkeit
list_boardsBoards listen, auf die das Token zugreifen kann, optionale Namenssuche. Hier starten, um eine boardId zu finden.GET /board/list-boards
get_boardMetadaten eines einzelnen Boards per boardId.GET /board/{boardId}
list_tablesTabellen eines Boards mit Spaltendefinitionen listen, optionale Namenssuche.GET /board/{boardId}/tables
get_table_schemaVollständige Spaltendefinitionen einer Tabelle inkl. Options-IDs für STATUS/DROPDOWN/LABELS.GET /board/{boardId}/table/{tableId}
list_rowsZeilen einer Tabelle mit optionalem query, strukturiertem filter und sort. Nicht paginiert.GET /board/{boardId}/table/{tableId}/rows
get_rowEine Zeile per Hex-rowId oder sichtbarer rowNumber holen (genau eine angeben).GET …/row/{rowId} oder GET …/row-number/{rowNumber}
create_rowZeile aus Zellen { columnId, value } anlegen; optionale Legacy-description.POST /board/{boardId}/table/{tableId}/row
update_rowZellwerte einer bestehenden Zeile per rowId aktualisieren (bearbeitet keinen Langtext).PATCH …/row/{rowId}
delete_rowZeile für bis zu 30 Tage in den Papierkorb des Boards verschieben. Gibt trashBatchId zurück.DELETE …/row/{rowId}
list_row_trashSichtbare gelöschte Zeilen mit optionalen Tabellen-, Such- und Seitenfiltern auflisten.GET /board/{boardId}/trash/rows
restore_rowsZeilen anhand einer Löschbatch-ID oder anhand von Papierkorbeintrag-IDs wiederherstellen.POST /board/{boardId}/trash/rows/restore
get_row_markdownLangtext-Markdown lesen: Legacy-Zeilenbeschreibung oder RICH-TEXT-Spaltenzelle, wenn columnId angegeben.GET …/row/{rowId}/md oder …/column/{columnId}/md
set_row_markdownMarkdown (replace/append/prepend) in die Legacy-Beschreibung oder eine RICH-TEXT-Spaltenzelle schreiben. Async (HTTP 202).POST …/row/{rowId}/md oder …/column/{columnId}/md

Scope: workspace-weit (Ergebnisse nach Token-Berechtigungen gefiltert).

ToolBeschreibungPublic-API-Fähigkeit
searchCross-Entity-Volltextsuche über Dokumente, Channels, Nachrichten, Todos, Drive-Dateien, Voice-Transkriptionen und KI-Chats. Mit types einschränken.GET /search/

Docs​

Scope: access_docs (Dokumente sind PAT-only).

ToolBeschreibungPublic-API-Fähigkeit
search_docsVolltextsuche über Dokumente mit gerankten Hits und Highlights.GET /docs/search
get_docs_treeDokumenthierarchie browsen; parentId weglassen für Root, mit depth begrenzen.GET /docs/tree
get_docDokument-Metadaten (Titel, Icon, Cover, Owner, Parent, Zeitstempel) per docId.GET /docs/{docId}
get_doc_contentVollständiger Markdown-Body eines Dokuments per docId (kann groß sein).GET /docs/{docId}/md
create_docDokument mit title anlegen, optionalem parentId und Seed-content.POST /docs/
set_doc_contentMarkdown (replace/append/prepend) in einen Dokument-Body schreiben. Async (HTTP 202).POST /docs/{docId}/md
update_doc_metadatatitle, icon und/oder cover eines Dokuments aktualisieren (nicht den Body).PATCH /docs/{docId}
delete_docDokument per docId löschen (nur Owner). Kein Undo.DELETE /docs/{docId}

Benachrichtigungen​

Scope: access_notifications (für den eigenen Benutzer des Tokens).

ToolBeschreibungPublic-API-Fähigkeit
list_notificationsBenachrichtigungen des Token-Benutzers mit unreadCount listen; ID-Cursor-paginiert (after/before).GET /notifications/
update_notificationEine Benachrichtigung per notificationId als read oder unread markieren.PATCH /notifications/{notificationId}
delete_notificationEine Benachrichtigung per notificationId löschen. Kein Undo.DELETE /notifications/{notificationId}

Chat​

Scope: access_channels.

ToolBeschreibungPublic-API-Fähigkeit
list_channelsChannels und DM-Unterhaltungen listen; filtern nach query/type/kind/participantId; offset-paginiert.GET /chat/channels
send_messageNachricht an einen Channel (channelId) senden oder einem Benutzer eine DM (userId) — genau eine.POST /chat/channel/{channelId}/send-message oder POST /chat/direct-message/send-message

Kommentar​

Scope: access_boards. Zeilenkommentare und Anhangsreferenzen.

ToolBeschreibungPublic-API-Fähigkeit
list_row_commentsZeilenkommentare auflisten (neueste zuerst), mit Autor- und Anhangsmetadaten, Dateiverweisen, Ankern und Erledigt-Status. Unterstützt Cursor-Paginierung sowie die Filter fileId und visibility.GET …/row/{rowId}/comments
add_row_commentEine Zeile oder einen FILE-Anhang kommentieren, optional mit Bildmarkierung oder Audio-/Videozeitpunkt. visibility ist standardmäßig internal.POST …/row/{rowId}/comment
resolve_row_commentEinen Dateikommentar als erledigt markieren oder wieder öffnen.POST …/row/{rowId}/comment/{commentId}/resolve
update_row_fileEinen FILE-Anhang umbenennen oder beschreiben.PATCH …/row/{rowId}/column/{columnId}/file/{fileId}
get_row_attachment_urlAuthentifizierte downloadUrl für einen FILE-Spalten- oder Kommentar-Anhang auflösen (keine Bytes zurück).…/column/{columnId}/file/{fileId}/download oder …/comment/{commentId}/file/{fileId}/download

Drive​

Scope: access_drive (Drive ist PAT-only).

ToolBeschreibungPublic-API-Fähigkeit
get_drive_treeDrive als verschachtelten Datei-/Ordner-Baum browsen; depth-begrenzt, mit Truncation-Drill-down.GET /drive/tree
search_driveVolltextsuche über Drive-Dateien und -Ordner.GET /drive/search
get_drive_itemMetadaten einer einzelnen Datei oder eines Ordners per fileId.GET /drive/files/{fileId}
get_drive_download_urlZeitlich begrenzte presigned CloudFront-Download-URL für eine Datei (kein Auth nötig zum Abruf).GET /drive/files/{fileId}/download
create_drive_folderOrdner an der Root oder unter einer parentId anlegen.POST /drive/folders

Export​

Scope: access_boards.

ToolBeschreibungPublic-API-Fähigkeit
export_tableTabellen-View nach CSV/XLSX/JSON/MARKDOWN/HTML/PDF/ZIP/ICS rendern; inline oder queued; saveToDrive für große/binäre Exporte.POST /board/{boardId}/table/{tableId}/export

Design Artifacts​

Scope: access_drive, und Design Artifacts muss in deinem Workspace verfügbar sein. Lies und bearbeite die Apps, Dashboards und Seiten, die in Copera entstehen — und übergib sie an einen Coding-Agent.

ToolBeschreibungPublic-API-Fähigkeit
get_artifact_handoffDer eine Aufruf, um aus einem Design zu bauen. Liefert den Link des Designs, die Version, die Spec, die Notizen, das gemeinsame Design (Richtlinien, Tokens, Komponenten und Assets mit kurzlebigen Download-Links), jede Seite (Oberfläche, Viewport, Einstiegsdatei und die Dateien, die sie lädt), die Links zwischen den Seiten und die Quelldateien. Optional versionId und maxInlineBytes.GET /artifacts/{artifactId}/handoff
list_artifactsListet die Designs, die du öffnen kannst; scope ist mine oder shared, optional search, cursor-paginiert (after, limit bis 50).GET /artifacts/
get_artifactDie aktuelle Version des Designs: Seiten, gemeinsames Design, Assets, die Dateiliste mit SHA-256-Digests und die Vorschau. Dateiinhalte liest du mit read_artifact_source.GET /artifacts/{artifactId}
list_artifact_versionsDer Versionsverlauf des Designs; cursor-paginiert (after, limit bis 50).GET /artifacts/{artifactId}/versions
get_artifact_versionSeiten, gemeinsames Design und Dateiliste einer Version (versionId). Eine gespeicherte Version ändert sich nie.GET …/versions/{versionId}
read_artifact_sourceLiest eine Quelldatei (path) einer Version in begrenzten Blöcken. Mit dem zurückgegebenen nextCursor weiterlesen, bis eof true ist.GET …/versions/{versionId}/source
get_artifact_page_previewVorschau einer Seite (pageId) einer Version.GET …/versions/{versionId}/pages/{pageId}/preview
get_artifact_design_snapshotEine wiederverwendbare Kopie des gemeinsamen Designs einer Version (Richtlinien, Tokens, Komponenten, Assets) mit Digest — an create_artifact als reuseDesign übergeben.GET …/versions/{versionId}/design
list_artifact_design_startersDie kuratierten Design-Starter (z. B. shadcn-core-v1) und ihre fixierten Abhängigkeiten.GET /artifacts/starters
list_artifact_assetsLogos, Schriften, Bilder und Referenzen im gemeinsamen Design.GET /artifacts/{artifactId}/design-assets
import_artifact_assetFügt eine von dir hochgeladene Datei (fileId) als logo, font, image oder reference zum gemeinsamen Design hinzu, optional mit altText. Platziere sie mit patch_artifact_source auf einer Seite.POST /artifacts/{artifactId}/design-assets
patch_artifact_sourceBearbeitet Quelldateien auf Basis von baseVersionId mit den Operationen replace_text, put_file und delete_file (bis zu 32 Dateien), jeweils gegen den aktuellen SHA-256 der Datei geprüft. Wird eingereiht — get_artifact_request abfragen.POST /artifacts/{artifactId}/source-patches
list_artifact_requestsDie letzten Bearbeitungsanfragen am Design, mit Status und der jeweils erzeugten Version.GET /artifacts/{artifactId}/requests
get_artifact_requestStatus einer Bearbeitungsanfrage (requestId) und die exakte Version, die sie erzeugt hat.GET /artifacts/{artifactId}/requests/{requestId}
create_artifactErstellt ein privates Design aus deinem eigenen Quellprojekt (static_web oder vite_react), mit title, einem request, der den Zweck beschreibt, und einem idempotencyKey. Optional mit einem Design-Starter (designStarterId) beginnen oder ein Design wiederverwenden (reuseDesign) — eines von beiden.POST /artifacts/
Mit einem Aufruf aus einem Design bauen

get_artifact_handoff ist alles, was ein Coding-Agent braucht. Arbeite das Ergebnis der Reihe nach ab: zuerst die Spec lesen, dann die Notizen, dann das Design einrichten, dann jede Seite aus ihren Dateien bauen und zuletzt die Links zwischen den Seiten verbinden — und den zurückgegebenen nextSteps folgen. Ohne versionId erhältst du die neueste erfolgreich gebaute Version. Dateiinhalte werden bis maxInlineBytes eingebettet (standardmäßig 32 KiB, bis 1 MiB, wenn dein Client große Ergebnisse akzeptiert); mit omitted: "over_budget" markierte Dateien liest du mit read_artifact_source und der zurückgegebenen Versions-ID. Die Einrichtung steht unter Mit deinem Coding-Agent bauen.

Verhaltenshinweise​

Async-Writes sind eventually consistent

set_row_markdown und set_doc_content werden in die Queue gestellt (HTTP 202) — erneut mit get_row_markdown / get_doc_content lesen, um zu bestätigen, dass die Änderung gelandet ist. Channel-Sends sind synchron; Direktnachrichten sind queued und erscheinen möglicherweise nicht sofort.

Bearbeitungen von Designs werden eingereiht

patch_artifact_source und create_artifact liefern eine Quittung, keinen fertigen Build. Nach einem Patch get_artifact_request abfragen, bis die Anfrage abgeschlossen oder fehlgeschlagen ist, und dann die erzeugte Version lesen; nach einem Create das zurückgegebene Design und seine Vorschau lesen. Einen idempotencyKey nur wiederverwenden, um exakt dieselbe Anfrage zu wiederholen. Hat sich eine Datei seit dem Lesen geändert, schlägt die Bearbeitung mit einem Konflikt fehl — neu lesen und erneut versuchen.

Löschziele prüfen

delete_doc und delete_notification löschen Daten endgültig. Mit delete_row gelöschte Zeilen lassen sich bis zu 30 Tage lang wiederherstellen, sofern sie nicht vorher endgültig gelöscht wurden.

Kein Tool liefert jemals rohe Dateibytes. get_drive_download_url liefert eine presigned URL, die Sie ohne Auth abrufen können; get_row_attachment_url liefert eine authentifizierte downloadUrl, die Sie selbst mit Ihrem Bearer-Token abrufen.

Für das Request-/Response-Schema jedes darunterliegenden Endpunkts siehe die API-Referenz.