---
title: Connect Mosaic to your AI assistant
description: Use the Mosaic MCP server to build and edit your photo book from Claude, ChatGPT or Cursor. Free to connect with your Mosaic account. Server URL https://mcp.mosaicbook.design
seo:
  title: Connect Mosaic to Claude, ChatGPT or Cursor
sidebar:
  label: Connect your AI assistant
---

Mosaic is a photo book app. Templates, editing, ordering, and your account are documented in the rest of these docs. This page is how you connect an assistant.

Our MCP server lets you build and edit your own Mosaic book from Claude, ChatGPT, Cursor or another app that supports remote MCP servers.

**Server URL:** `https://mcp.mosaicbook.design`

**Sign-in:** Your AI app opens a Mosaic sign-in page. Once you sign in, it can only see your own books and orders. No API key needed.

[Create a free Mosaic account](https://app.mosaicbook.design/?utm_source=mcp_page)

## What you can do

Once connected, your assistant can:

- Create a book from one of our templates: Chronicle, Atoll, Vista or Terra
- Add your photos
- Arrange your photos into layouts automatically
- Edit text, colors and fonts
- Swap a photo or a layout
- Add, delete or reorder spreads
- Preview a spread as an image
- See your orders
- Use version history: save a version, list them and restore one

Auto-layout only arranges the photos you add. It never creates images.

You review, order and pay for your book in the Mosaic app.

## Connection details

- **Protocol:** Streamable HTTP
- **Server URL:** `https://mcp.mosaicbook.design` (also `https://mcp.mosaicbook.design/mcp`)
- **Sign-in:** OAuth via Clerk at `https://clerk.mosaicbook.design`
- **CIMD:** supported
- **Dynamic client registration:** off
- **Tools:** 31, and they only access the signed-in user's own data
- Mosaic is not an AI provider. You bring your own AI.

## Connect in Claude

Works on Claude web, Claude Desktop and Cowork. Free plans can add one custom connector.

1. Go to **Customize > Connectors**.
2. Click **Add**, then **Add custom connector** (on some versions, hover **Custom** and pick **Web**).
3. Name it `Mosaic` and paste `https://mcp.mosaicbook.design` as the server URL. Click **Continue**.
4. Keep the sign-in settings Claude detects and click **Add**.
5. Click **Connect** and sign in with your Mosaic account.
6. In a chat, turn on Mosaic from the connectors menu.

On Team or Enterprise plans, an owner adds the connector under **Organization settings > Connectors** first. Then each person connects their own account.

## Connect in ChatGPT

Use ChatGPT on the web.

1. Go to **Plugins**.
2. Click the plus button, then **Add custom MCP server**.
3. Name it `Mosaic` and enter `https://mcp.mosaicbook.design/mcp` as the server URL.
4. Choose **OAuth** for authentication.
5. Read the warning, tick **I understand and want to continue**, then click **Create as a plugin**.
6. Sign in with your Mosaic account when asked, and install the plugin.

On Business or Enterprise workspaces, an admin may need to allow custom MCP servers (developer mode) first.

## Connect in Cursor

Add Mosaic as a remote MCP server. Put this in `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (one project):

```json
{
  "mcpServers": {
    "mosaic": {
      "url": "https://mcp.mosaicbook.design"
    }
  }
}
```

Then sign in to Mosaic when Cursor asks.

## Things to ask

- "Show me the Mosaic templates and help me pick one for a travel book."
- "Make a new Chronicle book called Lisbon 2026."
- "Add these photos to my Lisbon book."
- "Swap the layout on spread 4 and replace the second photo with a different one."
- "Arrange the photos I just added into layouts."
- "Change the title on the cover and use a different font."
- "Make the page backgrounds a warm off-white."
- "Move the beach spreads to the end and delete the blank one."
- "Save a version before you change anything else."
- "Show me a preview of spread 2."
- "What's the status of my last order?"

## FAQ

### Does it cost anything to connect?

No. Connecting is free. You only pay when you order a printed book.

### Do I need a Mosaic account?

Yes. Your AI app opens a Mosaic sign-in page when you connect. [Sign up free](https://app.mosaicbook.design/?utm_source=mcp_page).

### Can I order a book through my assistant?

Your assistant can build and edit the book and show your past orders. You review, order and pay in the Mosaic app.

### Is Mosaic an AI tool?

Mosaic isn't an AI company. We don't run AI models, we never train AI on your photos, and we never use AI-generated images. The MCP lets you bring the assistant you already use, like Claude or ChatGPT, and it can only work on your own books when you sign in.

### Which apps work with it?

Claude, ChatGPT and Cursor. Other apps that support remote MCP servers with sign-in may work too.