Integration Guides

Connect Mosaic to Claude

Connect Mosaic to Claude to bring your Mosaic project, resourcing, and time data into a Claude conversation — and take action on it — without leaving Claude. Mosaic exposes its tools through a remote MCP (Model Context Protocol) connector that works with Claude Desktop, Claude Code, and the Claude web app.

You sign in with your Mosaic account during setup — there are no API keys to copy.

Before you start

  • A Mosaic account (you'll sign in during setup).
  • A Claude account. On Team or Enterprise plans an Owner adds the connector once for the whole organization (see Team & Enterprise setup below); on individual plans you can add it yourself.
  • Your Claude organization must allow custom connectors (Team/Enterprise admins control this).

Step 1 — Copy your connector URL from Mosaic

  1. In Mosaic, open Settings (your account settings).
  2. Find the Connect to Claude section.
  3. Click the copy icon to copy your connector URL. It has the shape:
https://api-server.<env>.us-east-1.mosaicapp.com/mcp/v2/<realm>/<team>

The URL is specific to your Mosaic workspace and the team you're signed in to. If your organization has more than one Mosaic team, switch to the team you want before copying.

Step 2 — Add the connector in Claude

Claude Desktop or the Claude web app (individual plans)

  1. Open Settings → Connectors.
  2. Click Add custom connector.
  3. Paste your Mosaic connector URL and save.
  4. Click Connect — a browser window opens; sign in with your Mosaic account.
  5. Mosaic's tools are now available in your Claude chats.

Claude Code

Add the connector from your terminal, then start a session — Claude Code opens the browser to authorize:

claude mcp add --transport http mosaic https://api-server.<env>.us-east-1.mosaicapp.com/mcp/v2/<realm>/<team>

Team & Enterprise setup

On Team and Enterprise plans, individual members can't add custom connectors — a Claude Owner adds Mosaic once for the organization, then each member connects:

  1. Owner: go to Organization settings → Connectors → Add, hover Custom and choose Web, paste the Mosaic connector URL, then click Add.
  2. Each member: go to Customize → Connectors, find the Mosaic connector, and click Connect to sign in with their Mosaic account.

Because each member signs in individually, Claude only ever accesses the Mosaic data that member already has permission to see.

Troubleshooting

  • "Add custom connector" is missing (Team/Enterprise): your Claude Owner hasn't enabled or added custom connectors. Ask them to add the Mosaic connector via Organization settings → Connectors.
  • You signed in but tools don't load (or you see a 401): make sure the team in your connector URL is one you belong to. Re-copy the URL from Settings → Connect to Claude while signed in to that team.
  • The connector doesn't appear in your environment: the Mosaic AI connector is being rolled out per environment. If the Connect to Claude section isn't in your Mosaic settings yet, it isn't available for your environment.