Skip to content

Connect a coding agent over MCP

Connect Claude Code, Claude Desktop, Cursor or Codex to M1rror's MCP server with OAuth or an agent token, so your agent builds from the approved design system.

On this page

Your coding agent is good at writing code but has never seen your design system. Connecting it to M1rror over the Model Context Protocol gives it your tokens, components, screens, approved releases and build plans, so it builds what was approved instead of guessing.

Your coding agent talks to the M1rror MCP server, which acts on your workspace with the same checks as the app; the agent edits your repository.Your coding agentClaude Code, Cursor, CodexM1rror MCP serverOAuth or an agent tokenYour workspacesame checks as the appYour repositorythe agent edits a branchAgents read context and draft.Approvals, billing and members stay with people.
Your agent reaches your workspace through the MCP server, with the same checks as the app.
The Connect your agent settings page: a step to create an agent token, and the M1rror, Figma and Mobbin MCP servers with setup commands for Claude Code, Claude Desktop, Cursor and Codex.The Connect your agent settings page: a step to create an agent token, and the M1rror, Figma and Mobbin MCP servers with setup commands for Claude Code, Claude Desktop, Cursor and Codex.
Settings › Connect your agent gives you the exact commands for your agent.

Find your setup

Open Settings › Connect your agent, or a project's menu › Connect your agent… for that project's values. The page has three parts: Create an agent token, Add the servers to your agent and Try a recipe. It shows the exact server address for your deployment; for m1rror.com it is https://mcp.m1rror.com/mcp.

  1. Choose how the agent signs in

    • OAuth (recommended). Add the server without a token; your agent opens a browser window where you sign in, pick the workspace and approve the permissions.
    • Agent token. Select Create agent token. The token is shown once and lasts 30 days. It carries the implementer tools: your agent reads the approved release, links its pull request to it, reports progress and evidence, and sees what has shipped. It cannot approve, spend, merge or open pull requests for you. Keep it in an environment variable named M1RROR_TOKEN; the configs below never contain the token itself.

    Both give your agent the implementer tool profile, a short list of 14 tools that coding agents handle well. If you want your agent to save references or propose design changes too, create a token with Tools › Full (every permitted tool) in Settings › Agent access.

  2. Add the server to your agent

    Terminal
    claude mcp add --transport http m1rror https://mcp.m1rror.com/mcp --header "Authorization: Bearer $M1RROR_TOKEN"

    Then run /mcp in Claude Code. For OAuth instead of a token, leave out --header and sign in from /mcp. You can also commit the same server to .mcp.json in your repository.

    If your token has the full tool set, you can still limit one connection to the implementer tools by adding ?profile=implementer to the address:

    Terminal
    claude mcp add --transport http m1rror "https://mcp.m1rror.com/mcp?profile=implementer" --header "Authorization: Bearer $M1RROR_TOKEN"
  3. Try a recipe

    Try a recipe in Connect your agent lists ready-made prompts. The first one works with the implementer token; recipes that save screens as references or propose token changes need a token with all tools. Start with something read-only, for example asking your agent for the implementation brief of your latest approved release.

Implement an approved release

With the implementer tools, a coding agent can build an approved design in your own checkout and report back, so M1rror can show what shipped:

  1. Read the brief. taste_get_implementation_brief returns what is left to build from the latest approved release, the scope, the checks to run and the line to put in the pull request description. It never points at a release still in review.
  2. Implement the change in your repository, within the plan's allowed files if there is an authorised build plan (taste_get_implementation_contract).
  3. Open a pull request in GitHub with the M1rror-Release: … line from the brief in its description. M1rror links it to the release when GitHub reports it.
  4. Link it explicitly with taste_link_pull_request if the line isn't there.
  5. Report progress with taste_submit_implementation_progress, naming the items done and the files changed.
  6. Submit evidence of its checks with taste_submit_evidence and the link's id.
  7. Check coverage with taste_get_ship_ledger, the same view as Ship › Coverage.

Progress counts only when the files the agent names are in the pull request's diff, and evidence an agent submits is always marked as not run by M1rror.

What agents can and can't do

With the full tool set, agents can read projects, references, designs, releases, build plans and runs, and draft: add references, propose design changes, update screens and their states, ask for a review, prepare a build plan and submit evidence. With the implementer profile they see only the 14 implementer tools. The full list is in MCP tools.

Agents can never approve a release or decide a review, authorise or start a build in M1rror, open a pull request through M1rror, or change billing, members, integrations or policy. Every request is checked against both the agent's grant and the current permissions of the person who connected it.

Revoke access

Agent tokens and OAuth grants are listed in Settings › Agent access, where you can revoke them. Removing a member also revokes their agent tokens for the workspace.

Design sources in the same agent

The setup page can add Figma's and Mobbin's own MCP servers next to M1rror's, which you sign in to with your own accounts.

Last updated

Edit this page on GitHub