> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superblocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Builder MCP

> Build, edit, and publish governed Superblocks apps from where you already work: Claude, Slack, ChatGPT, and Teams

export const Alert = ({type, title, children}) => {
  const getIcon = () => {
    switch (type) {
      case 'info':
        return "data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='20' height='20' viewBox='0 0 20 20' fill='none'%3E%3Cpath d='M10 0C4.477 0 0 4.477 0 10s4.477 10 10 10 10-4.477 10-10S15.523 0 10 0zm0 15c-.552 0-1-.448-1-1s.448-1 1-1 1 .448 1 1-.448 1-1 1zm1-3H9V6h2v6z' fill='%230099FF'/%3E%3C/svg%3E";
      case 'success':
        return "data:image/svg+xml,%3Csvg width='20' height='20' viewBox='0 0 20 20' fill='none' xmlns='http://www.w3.org/2000/svg'%3E%3Cpath fill-rule='evenodd' clip-rule='evenodd' d='M10 0C4.477 0 0 4.477 0 10s4.477 10 10 10 10-4.477 10-10S15.523 0 10 0zm4.293 6.293L9 11.586 5.707 8.293c-.391-.391-1.024-.391-1.414 0s-.391 1.024 0 1.414l4 4c.391.391 1.024.391 1.414 0l6-6c.391-.391.391-1.024 0-1.414s-1.024-.391-1.414 0z' fill='%230CC26D'/%3E%3C/svg%3E";
      case 'warning':
        return "data:image/svg+xml;charset=utf-8;base64,PHN2ZyB4bWxucz0naHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmcnIHhtbDpzcGFjZT0ncHJlc2VydmUnIHdpZHRoPScxMDgwJyBoZWlnaHQ9JzEwODAnPjxyZWN0IHdpZHRoPScxMDAlJyBoZWlnaHQ9JzEwMCUnIGZpbGw9J3RyYW5zcGFyZW50Jy8+PHBhdGggZD0nTTEzLjc5NCAxMC43NSA4LjMgMS4yNWExLjUgMS41IDAgMCAwLTIuNiAwbC01LjQ5NCA5LjVBMS40OTQgMS40OTQgMCAwIDAgMS41IDEzaDExYTEuNDkzIDEuNDkzIDAgMCAwIDEuMjk0LTIuMjVNNi41IDUuNWEuNS41IDAgMCAxIDEgMFY4YS41LjUgMCAwIDEtMSAwek03IDExYS43NS43NSAwIDEgMSAwLTEuNS43NS43NSAwIDAgMSAwIDEuNScgc3R5bGU9J3N0cm9rZTpub25lO3N0cm9rZS13aWR0aDoxO3N0cm9rZS1kYXNoYXJyYXk6bm9uZTtzdHJva2UtbGluZWNhcDpidXR0O3N0cm9rZS1kYXNob2Zmc2V0OjA7c3Ryb2tlLWxpbmVqb2luOm1pdGVyO3N0cm9rZS1taXRlcmxpbWl0OjQ7ZmlsbDojZmY5ZjM1O2ZpbGwtcnVsZTpub256ZXJvO29wYWNpdHk6MScgdHJhbnNmb3JtPSd0cmFuc2xhdGUoLjAyIDE5LjMwNSlzY2FsZSg3Ny4xNCknLz48L3N2Zz4=";
      case 'danger':
        return "data:image/svg+xml,%3Csvg width='20' height='20' viewBox='0 0 20 20' fill='none' xmlns='http://www.w3.org/2000/svg'%3E%3Cpath d='M10 0C4.477 0 0 4.477 0 10s4.477 10 10 10 10-4.477 10-10S15.523 0 10 0zm5.707 4.293L10 9.586 4.293 4.293c-.391-.391-1.024-.391-1.414 0s-.391 1.024 0 1.414L8.586 11l-5.707 5.293c-.391.391-.391 1.024 0 1.414s1.024.391 1.414 0L10 12.414l5.707 5.293c.391.391 1.024.391 1.414 0s.391-1.024 0-1.414L11.414 11l5.707-5.293c.391-.391.391-1.024 0-1.414s-1.024-.391-1.414 0z' fill='%23F45252'/%3E%3C/svg%3E";
      case 'note':
        return "data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='20' height='20' viewBox='0 0 20 20' fill='none'%3E%3Cpath d='M10 0C4.477 0 0 4.477 0 10s4.477 10 10 10 10-4.477 10-10S15.523 0 10 0zm0 15c-.552 0-1-.448-1-1s.448-1 1-1 1 .448 1 1-.448 1-1 1zm1-3H9V6h2v6z' fill='%230099FF'/%3E%3C/svg%3E";
      default:
        return "";
    }
  };
  return <div className={`alert alert--${type}`}>
      <div className="alert-icon" style={{
    backgroundImage: `url("${getIcon()}")`,
    backgroundRepeat: 'no-repeat',
    backgroundPosition: 'center center',
    backgroundSize: '20px',
    width: '24px',
    height: '24px',
    position: 'absolute',
    left: '16px',
    top: '16px'
  }} />
      <div className="alert-content">
        {title && <div className="alert-title">{title}</div>}
        <div className="alert-body">{children}</div>
      </div>
    </div>;
};

<Alert type="note">
  <p>
    <strong>Coming Soon</strong> - The Builder MCP is coming to Superblocks soon. <a href="mailto:support@superblockshq.com">Contact us</a> to join the early access list.
  </p>
</Alert>

## Overview

The Builder MCP lets you build in Superblocks without leaving the AI tools you already use. Connect Superblocks to Claude (and, soon, Slack, ChatGPT, and Teams) through the [Model Context Protocol](https://modelcontextprotocol.io/), then ask in plain language to import, build, edit, or publish an app. Superblocks does the work and sends back an editor or deployed link.

Many builders and business users already prototype in Claude and want to take that work to production in a governed way. The Builder MCP meets them where they are, with no separate onboarding and no new tool to learn. Whatever tool a builder starts in, the app they ship lands on Superblocks with your organization's guardrails already applied.

## What you can do

* **Start a new app**: Ask Claude to build a new app in Superblocks and get an editor link back.
* **Import an existing app**: Bring a prototype you built in Claude into Superblocks. It imports the app, replaces integrations with your governed data sources, and adds platform authentication and RBAC.
* **Edit an app**: Describe a change and Clark starts building against your existing app.
* **Publish an app**: Ask to deploy and get a deployed link back, after security agent scans and policy agents run.

## How it works

### 1. Set up the MCP

An admin or builder connects the Superblocks Builder MCP in their AI tool (Claude first, then Slack). Setup instructions will be provided at launch.

### 2. Ask in natural language

Prompt the tool the same way you already do:

```
"Import this app into Superblocks, connect it to our Postgres
database, and send me the editor link."
```

```
"Add an approvals table to my Superblocks expense app and
publish it."
```

### 3. Plan and refine with Clark

Clark works with you conversationally through the MCP, just like in the Superblocks UI. Before building, it can ask clarifying questions about functionality, data, and design, inspect your integration metadata, and propose a plan, right in the chat. You answer in the same thread, and Clark refines its approach before it starts building. See [Plan & Build modes](/building-with-clark/plan-and-build-modes) for how this works in the editor.

### 4. Get links back

Where relevant, the Builder MCP replies with an editor link, a deployed link, and, depending on the platform, screenshots or a short video so you can review the result before opening Superblocks.

## Preview your app in chat with MCP Apps

<Alert type="note">
  <p>
    <strong>Coming Soon</strong> - Rendering the live app inside the chat is on the roadmap for hosts that support it, starting with Claude.
  </p>
</Alert>

Beyond links and screenshots, we're building toward rendering the app's live HTML interface directly inside the conversation using [MCP Apps](https://modelcontextprotocol.io/extensions/apps/overview), the MCP extension for interactive UI. Instead of switching to a browser tab, you'd see and click through the app you just built without leaving Claude.

MCP Apps make this a good fit for the Builder MCP:

* **Context preservation**: The app renders alongside the conversation that created it, so you can iterate ("make the table sortable") and immediately see the result in place.
* **Sandboxed and secure**: The interface runs in a host-controlled sandboxed iframe that can't access the surrounding page, so previews stay safe to render.
* **Bidirectional**: The rendered app can call back through the Builder MCP for fresh data, and your prompts can push updates into the running preview.

You'd still get the editor and deployed links; the in-chat render is an additional way to review before you open Superblocks.

## Governed by default

Prototypes built directly in AI tools tend to hardcode credentials and reinvent auth and permissions app by app, which becomes a security risk and tech debt as they multiply. Superblocks applies governance at the platform level rather than per app: connected integrations, authentication, RBAC, and policies are managed centrally, so a change made once applies to every app. Apps that come in through the Builder MCP inherit that same model automatically.

* **Identity-aware**: The MCP uses your identity, resolved through your SSO provider, and maps it to your permissions in Superblocks so builders only do what their role allows.
* **RBAC and integrations**: Imported apps are rewritten to use your connected [integrations](/integrations/overview) and platform-managed [authentication and RBAC](/admin/org-administration/rbac) instead of hardcoded credentials.
* **Security and policy agents**: Publishing runs security agent scans and policy agents, and every app keeps native version control and one-click deploy.

## Supported platforms

| Platform            | Availability             |
| ------------------- | ------------------------ |
| **Claude**          | First platform at launch |
| **Slack**           | Planned                  |
| **ChatGPT / Teams** | Planned                  |

## Builder MCP vs. Admin MCP

Superblocks offers two MCPs: the **Builder MCP** is for building apps, and the [**Admin MCP**](/admin/mcp-server) is for administering the platform.

## Related

<CardGroup cols={2}>
  <Card title="Import an app" icon="file-import" href="/building-with-clark/import-app/index">
    Bring prototypes from Claude, Replit, Lovable, v0, and more into Superblocks today
  </Card>

  <Card title="Admin MCP" icon="plug" href="/admin/mcp-server">
    Connect AI coding agents like Cursor and Claude Code to administer your Superblocks org
  </Card>
</CardGroup>