Skip to content

Claude Cowork

Connect Display.dev to a Claude Cowork cloud session through remote MCP.

On this page

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

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 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 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 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, run the Display.dev CLI from a terminal on the computer where the file exists (dsp publish ./report.html), or upload the file through the Display.dev dashboard.

Fix connection or publishing errors

  • 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.
  • The file transfer cannot reach api.display.dev – on Team or Enterprise, add api.display.dev under the organization's code-execution allowlist, then start a new Cowork task. Personal 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 server for the complete tool inventory and staged-publishing contract.

Was this page helpful?