Quickstart

From sign-up to asking your AI “how are my projects doing?” in a few minutes. A project is a website, an API or backend service, or a scheduled job.

1. Sign up and create a workspace

Sign in with a magic link or Google. Name your workspace and check the time zone (it's used for daily charts, digests and “today”). Your first workspace starts on a 14-day Pro trial, with no card required.

2. Add a project

Open Add project and paste an address. Mosaicdeck looks at it and fills in the name and kind for you; change them if they're off. An address that answers like an API (JSON, or an error page from a framework with a health check behind it) is added as an API, with uptime on its health check when it has one at /health, /healthzor /api/health. Uptime checks start straight away (every minuteon Pro, 5 minutes on Free).

A cron job, backup or worker without an address? Choose No address? Add a scheduled job, name it and say how often it runs. See APIs and scheduled jobs.

3. Connect your data

Pick one or both. You can add the other later from the project's Connections tab.

Let a coding agent do it

If the project's code is in a repository you work on with Claude Code or another coding agent, copy the prompt fromSet up with an AI agent (shown after you add a project, and on its Connections tab). It's written for that project. For a website: its script tag, custom events that suit its kind, and, if you want them, the metrics endpoint and the numbers worth reporting. For an API: a health check and the metrics endpoint. For a scheduled job: a ping after each run. The agent opens a pull request for you to review. The prompt never contains your metrics secret, and the agent never needs it: your deployed endpoint reads it at runtime from MOSAICDECK_SECRET, which you set in your host's secret settings.

Several projects at once

On Add project, choose Add another, or paste a list of addresses into the address field (one per line, or separated by commas). Each address is looked at, you check the names and kinds in one list, and one click adds them all. If their code is in repositories, copy Connect them all with one prompt and give it to one coding agent that can see every repository: Claude Code on the web with each repository added to the session, or a folder or multi-root workspace holding them all. The agent maps each project to its repository, checks the mapping with you, and opens one pull request per repository: the script and custom events for a website, a health check for an API, pings for a job. Metrics endpoints and ping URLs are secret per project, so set those from each project's own page. Projects added earlier that aren't connected yet have the same prompt under Connect them all with one AI agent prompt on the portfolio.

Script tag: a website's traffic and errors

Paste this into your site's <head>. The app shows it with your real site ID and copy buttons for common platforms.

<script>window.mosaicdeck=window.mosaicdeck||{q:[],track:function(){var q=window.mosaicdeck.q;q.length<50&&q.push([].slice.call(arguments))}}</script>
<script defer src="https://t.mosaicdeck.com/s.js" data-site="site_01J9XEXAMPLE00000000000000"></script>

Open your site in a browser. The checklist in the app turns from “Waiting for first page view…” to “Receiving data”. The script doesn't run on localhost, so test on your real domain. See Script installfor framework guides.

Metrics endpoint: your app's own numbers

Expose one signed JSON endpoint that lists numbers like signups or orders. The app shows a secret once, stack-specific code, and a Test connection button that shows exactly what it parsed. See theMetrics Protocol and the SDKs.

4. Look at your dashboard

Mosaicdeck builds a dashboard from what the project sends: traffic, your app metrics, custom events, uptime or runs. Rearrange, resize or remove widgets if you like. Your portfolio home shows every project at once. TheCheckup on the Connections tab suggests good practice for the kind of project, like security headers for a website or a health check for an API; dismiss anything that doesn't apply.

5. Ask your AI

Open Connect AI in the app, copy your server URL, and add it to Claude or another MCP client. Then ask “how are my projects doing this week?” Step-by-step instructions: Connect your AI.

Next