Quickstart

This walkthrough uses Claude Code to go from setup to publishing and reviewing your first artifact. For other MCP clients, see MCP integration.

1. Create a workspace and a project

Sign in at https://tray.page and you'll be prompted to create a workspace (your team's unit). Create one project (where artifacts live) inside it. Skip this step if you've already been invited to a workspace.

2. Add the MCP server

Run this in your terminal:

claude mcp add --transport http traypage https://tray.page/api/mcp

Inside Claude Code, run /mcp, select traypage, and authenticate. A browser opens — sign in, confirm the workspace and permissions you're granting, and you're connected. No manual token copying needed.

3. Publish an artifact

Ask Claude Code to create HTML and publish it to TrayPage:

Create a sales analysis report in HTML and publish it to the
"reports" project in my TrayPage workspace "acme"

Claude Code calls the publish_html_artifact tool and returns a review URL and a viewer URL.

4. Review and share

Open the review URL to see the artifact preview with a comment panel. Team members can select text and comment on it. Visibility defaults to the project's setting (project members) and can be changed per artifact.

5. Iterate on comments

Once comments come in, ask Claude Code to revise:

Apply the TrayPage comments and publish a revised version

Claude Code uses get_revision_prompt to turn open comments into revision instructions, then publishes a new version with publish_new_artifact_version. Version history is kept automatically.

If something doesn't work, check the MCP troubleshooting section.