Quickstart

This guide walks you through deploying an MCP server from a GitHub repository and connecting it to an AI client.

Prefer to have an agent do it? Copy the onboarding prompt and paste it into Cursor, Claude Code, or Codex.

Build and deploy an MCP app to Manufact Cloud for me. 

Follow these in order

0. Ask me what MCP app I want to build. If I'm not sure, propose building the,
    example MCP Apps (widgets) template so I can see one working, and go with,
    that unless I say otherwise. you should always use npx -y create-mcp-use-app@latest {name} --template mcp-apps 
    to scaffold the project.

1. Login to the CLI:
    npx -y mcp-use@latest login

2. Install the mcp-use skill (non-interactive), which will guide you through the rest of the steps.
    npx -y mcp-use@latest skills add

3. Build the server: scaffold with the MCP Apps (widgets) template and,
    implement the tools and widgets we agreed on, following the skill:
    npx -y create-mcp-use-app@latest my-mcp-app --template mcp-apps

4. Deploy. Ask me which GitHub org to use:
    - If I want a Manufact-managed repo (no GitHub setup needed), deploy with:
      npx -y mcp-use@latest deploy --no-github -y
    - If I want it in my own GitHub, ask me which GitHub account/org, make sure
      the mcp-use GitHub App is installed there (open
      https://github.com/apps/mcp-use/installations/new and have me authorize
      it), push the project to a repo in that org, then:
      npx -y mcp-use@latest deploy -y
6. When it is live, give me both:
    - the MCP URL (to connect clients), and
    - the Manufact Cloud dashboard URL for the server, where I can see
      analytics, evals, observability, logs, and more.

Before you start

You need:

• A Manufact Cloud account: the Free plan covers your first server.
• A GitHub repository containing an MCP server. Any framework works, mcp-use, FastMCP, the official MCP SDKs, or a custom Dockerfile.

If you don't have a server yet, you can start from a template or build one with Mango instead, see Creating servers.

1. Create an organization

When you first sign in, the onboarding wizard asks you to create an organization. Organizations own servers, billing, and team members. You can create more organizations later from the organization switcher.

2. Import your repository

1. Go to Servers and click New Server.
2. Choose Import from GitHub.
3. If this is your first deploy, connect the Manufact GitHub App and grant it access to your repository. See GitHub integration for details.
4. Pick the repository you want to deploy.

3. Configure the deployment

On the Configure Deployment screen:

• Branch: the branch to deploy as production (usually main).
• Region: leave on AUTO, or pick US / EU / APAC on the Startup plan and above.
• Environment variables: add any secrets or config your server needs. You can also paste the contents of a .env file to fill them in at once.
• Advanced configuration (optional), set a root directory for monorepos, watch paths, a Dockerfile path, or a framework preset. Manufact auto-detects most setups.

Click Deploy. The pipeline clones your code, analyzes it, builds it, deploys it, and runs health checks before routing traffic to it, you can follow each step live.

4. Get your server URL

Once the deployment is healthy, your server is available at its gateway URL, shown in the header of every server page:

https://<your-slug>.run.mcp-use.com/mcp

Copy it from the URL chip, or customize the slug and add custom domains on the Domains tab.

5. Connect a client

Click Add to client next to the server URL to get one-click installs and ready-made config snippets for Cursor, VS Code, Claude Desktop, Claude Code, Gemini CLI, Codex CLI, and the mcp-use SDKs. See Connecting clients.

You can also test immediately in the dashboard: the Chat tab connects an agent to your server, and Tools, Prompts, and Resources list everything your server exposes.

Next steps