Skip to content

Claude Cowork

Connect Claude Cowork to publish work from a task and return a shareable link.

On this page

Connect Display.dev so Claude Cowork can publish work from a task and return its link. Each published piece of work is an artifact. Add Display.dev as a remote custom connector, then enable it in Cowork from Claude on the web, Claude Desktop, or the mobile app.

Cowork is a mode inside Claude, not a separate app. Its tasks run remotely by default, so the agent loop and code execution stay in Anthropic's cloud whichever Claude app you use to start the task.

Claude Cowork requires a paid Claude plan. Publishing larger existing files also requires Cowork's cloud code execution to reach api.display.dev.

Use the Quickstart setup prompt to have your agent guide you, or follow the steps below. Complete any sign-in or approval steps yourself.

Add Display.dev to an individual Claude account

Personal Claude Pro and Max accounts can use the connector for inline publishing, but Cowork cannot transfer large existing files because these accounts cannot allow api.display.dev for cloud code execution. Large staged uploads require a Claude Team or Enterprise organization configured as described below.

  1. In Claude.ai, select Customize in the sidebar, then select Connectors.
  2. Select Add → Add custom connector.
  3. Enter Display.dev in Name and https://api.display.dev/v1/mcp in Remote MCP server URL.
  4. Under Advanced settings, leave OAuth Client ID and OAuth Client Secret empty, then select Add.
  5. On the Display.dev connector page, select Connect.
  6. On the Display.dev authorization screen, confirm that Redirects to shows claude.ai, review the requested access, then select Authorize Claude. If the redirect host is different, select Cancel.
  7. When Claude.ai returns to Display.dev and shows Disconnect and Tool permissions, the connection is complete.

The connector also runs through Anthropic's cloud. A cloud task does not need a local MCP server. Keep Claude Desktop open only when the task needs a local file, browser, or computer.

Add Display.dev to a Claude Team or Enterprise organization

An Owner or Primary Owner must add the connector first:

  1. Open Organization settings → Connectors.
  2. Select Add, hover over Custom, then choose Web.
  3. Enter https://api.display.dev/v1/mcp and select Add.

Each member then opens Customize → Connectors, finds Display.dev, and selects Connect to complete their own authorization.

For staged file publishing, an Owner or Primary Owner must also:

  1. Open Organization settings → Capabilities → Code execution.
  2. Under Additional allowed domains, add api.display.dev.
  3. Start a new Cowork task after the policy change.

The connector and code execution use separate network paths. Connecting Display.dev does not allow a Cowork shell to reach api.display.dev.

Start a Cowork cloud session

  1. Open Claude on the web, Claude Desktop, or the Claude mobile app.
  2. Select Cowork in the message box and start a task.
  3. Open + → Connectors and enable Display.dev for the task.
  4. Ask Claude to list the available Display.dev tools without calling them.

Confirm that both publish and create_upload appear. This verifies the connection without creating an artifact.

Publish your first artifact

Once Display.dev's tools are available, use the first-publish example to create a Private sample and open its link.

Publish an existing file

Ask Cowork to use staged publishing when the HTML or Markdown file already exists in its code-execution environment or is too large for a safe inline tool call:

text
Publish the existing file report.html through Display.dev. Before you start,
ask me to choose its visibility.
Keep the source in code execution and use staged publishing if needed. Return
the artifact link without temporary upload credentials or source contents.

Cowork measures the file, transfers its raw bytes, then calls publish. The temporary transfer expires after 15 minutes. The per-artifact limit is 10MB on Free and 50MB on Solo, Pro, and Enterprise.

For small HTML or Markdown generated directly in the task, Cowork may call publish with inline content instead.

On personal Claude Pro or Max, Cowork can publish smaller files inline through MCP. For a larger existing file in Cowork, download it from the task, then run the Display.dev CLI from your terminal (dsp publish ./report.html) or publish it through the Display.dev dashboard. If the file is already on your computer, use it there directly.

Fix connection or publishing errors

  • Claude asks to install a skill or CLI – Cowork's Display.dev connector tools run through Claude's remote connector service, while commands, scripts, and staged file transfers run inside Cowork code execution. Do not install the Display.dev skill or CLI there. Add Display.dev under Customize → Connectors, complete authorization, start a new Cowork task, then enable Display.dev under + → Connectors. On Claude Team or Enterprise, an Owner or Primary Owner must add the connector to the organization first.
  • The connector returns 401 – open Customize → Connectors, disconnect Display.dev, then connect it again.
  • create_upload is missing – reconnect Display.dev, then start a new Cowork task and check the tools again.
  • Publishing fails with curl: (56) … response 403 or API returned 000 – Claude tried to publish from code execution. For small HTML or Markdown generated in the task, ask Claude to use the Display.dev connector's publish tool with inline content. For a large existing file on Claude Team or Enterprise, follow the staged file transfer recovery below. On personal Claude Pro or Max, download the file from the Cowork task, then run the Display.dev CLI from your terminal (dsp publish ./report.html) or publish it through the Display.dev dashboard.
  • A staged file transfer cannot reach api.display.dev – on Claude Team or Enterprise, add api.display.dev under the organization's code-execution allowlist, then start a new Cowork task. Personal Claude Pro and Max cannot currently add this domain.
  • The transfer expires or becomes unavailable – ask Cowork to start again with a new create_upload. Do not reuse the previous transfer.

See MCP tools for the complete tool inventory and staged-publishing contract.

Was this page helpful?