Skip to content

Claude Code

Connect Claude Code to publish and update work from your projects.

On this page

Connect Display.dev so Claude Code can publish and update your HTML or Markdown files. Each published piece of work is an artifact, with its own link. The recommended setup installs the display.dev skill and connects through browser sign-in.

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

Install the skill

bash
npx skills add display-dev/skill --skill display-dev

Connect with browser sign-in

Add the authenticated HTTP endpoint:

bash
claude mcp add --transport http --scope user display https://api.display.dev/v1/mcp

Open /mcp inside Claude Code, select display, and complete the browser sign-in. Claude Code stores and refreshes the OAuth credential.

Run claude mcp get display to confirm the server and scope.

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.

Choose a scope

  • Local – current project, visible only to you. This is the default and is stored in your user configuration under the current project.
  • Project – current project, shared through .mcp.json. Use it only for credential-free configuration; each teammate completes OAuth separately.
  • User – every project on your machine, visible only to you. The OAuth example above uses this scope.

Replace --scope user with --scope local or --scope project when needed.

Alternative: connect with an API key

Use this path for a fixed credential in a controlled environment:

bash
export DISPLAYDEV_API_KEY="<api-key>"
claude mcp add --transport http --scope user \
  --header "Authorization: Bearer $DISPLAYDEV_API_KEY" \
  display https://api.display.dev/v1/mcp

Do not put a real API key in project-scoped configuration or commit it to source control.

Alternative: connect through local MCP

If you already use dsp login, connect Claude Code through the local Model Context Protocol (MCP) server:

bash
claude mcp add --transport stdio --scope user display -- dsp mcp

Install @displaydev/cli first if dsp is not on your PATH. After changing authentication or configuration, open /mcp to reconnect and confirm the tool count.

Was this page helpful?