Build & Deploy a Full-Stack App with Claude Code
To deploy a full-stack app built with Claude Code, connect Claude Code to the OSC MCP server and ask it to provision what the app needs. This tutorial provisions a PostgreSQL database and deploys Node.js code from a GitHub repository; S3-compatible object storage (MinIO) is provisioned the same way when your app needs it. The services are standard open source and your code stays in your own git repo.
Go from an idea to a production full-stack application in 15 minutes. Claude Code scaffolds the code, provisions the infrastructure, and deploys everything to Open Source Cloud — all through natural language.
What You'll Learn
Prerequisites
- Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
- OSC MCP server configured (see Getting Started tutorial)
- An authenticated OSC account
- A GitHub account (for deployment)
Step-by-Step Guide
Set Up Your Project
Create a new project directory and start Claude Code:
mkdir my-task-app && cd my-task-app
claudeTip: If you haven't set up Claude Code with OSC yet, follow our Getting Started tutorial first.
Describe Your Application
Tell Claude Code what you want to build. Be specific about the stack and features:
> Build a task tracker application with:
> - React frontend with a clean UI for creating, editing, and completing tasks
> - Express.js API with CRUD endpoints for tasks
> - PostgreSQL database for persistent storage
> - Include user authentication with email/passwordClaude Code will scaffold the entire project — frontend, backend, and database schema — in your project directory.
Create the Database on OSC
Once the code is scaffolded, ask Claude to provision the database:
> Create a PostgreSQL database on Open Source Cloud for this appClaude uses the OSC MCP tools to create a PostgreSQL instance and automatically configures the connection string in your app's environment variables.
Note: Save the database credentials shown by Claude. You'll need them if you want to connect directly via a database client.
Deploy the Backend API
Deploy your Express API as a custom app on OSC:
> Push the code to GitHub and deploy the backend API to Open Source CloudClaude will create a GitHub repository, push your code, and use the OSC MCP tools to deploy it as a Node.js application. You'll get a live API URL.
Deploy the Frontend
Finally, deploy the React frontend pointing to your live API:
> Deploy the frontend to OSC and connect it to the deployed APIClaude configures the frontend with the correct API URL, deploys it to OSC, and returns your production URL. Your full-stack app is now live!
Tip: Ask Claude to set up a custom domain if you want a branded URL for your app.
Your App is Live!
You've built and deployed a complete full-stack application using only natural language. Your task tracker is running in production with a React frontend, Express API, and PostgreSQL database — all on Open Source Cloud.
Already Have the Code Your Agent Wrote?
You do not need to start from step 1. If Claude Code, Cursor or Codex already wrote the app, push it to a git repository and ask your agent to run it on OSC:
> Deploy this repository to Open Source Cloud. Create the database and storage it needs and put the connection strings in a parameter store.The agent creates a PostgreSQL database, adds MinIO object storage if the app stores files, writes DATABASE_URL and the other values into a parameter store, and deploys the code as a My App with a stable HTTPS URL. Node.js, Python, Go, .NET, PHP and WebAssembly are supported. The one change most generated apps need: listen on the port in the PORT environment variable (8080).
Building an MCP server instead of a web app? Follow Deploy an MCP Server on OSC. For the full list of what an agent can provision, see infrastructure for AI agents.
For Agents and Tooling
The machine-readable descriptor for this deploy is served as JSON, so an agent can select it without parsing this page. It names the chain (PostgreSQL, optional MinIO storage, a parameter store, then the My App), the required inputs, and what is and is not yet measured.
/stacks/deploy-agent-written-app.jsonBuilt with This Approach
Streaming Tech TV+
A complete streaming service with 14 OSC services, built in 36 hours by 1 human directing 6 AI agents.
View example →Community Examples
CRM systems, game trackers, medication apps — all built with AI agents and deployed on OSC.
Browse examples →Frequently Asked Questions
How do I deploy a vibe-coded app?
Connect your AI coding tool to the OSC MCP server and ask it to deploy the repository. It creates the database and storage the app needs, keeps the connection strings in a parameter store, and deploys the code as a My App with a stable HTTPS URL. No Dockerfile and no cloud console.
What is vibe deployment?
Vibe deployment is shipping AI-generated code to production infrastructure without manual DevOps work. You describe what you want, the AI writes the code, and the same AI provisions the infrastructure and deploys it.
Can Claude Code deploy my app?
Yes. Connect Claude Code to OSC with one command: claude mcp add --transport http osc https://mcp.osaas.io/mcp. Then ask Claude to deploy your app. Cursor, Codex and other MCP clients use the same MCP URL in their settings.
I already have the code my agent wrote. Do I start over?
No. Push the code to a git repository and ask your agent to deploy it to OSC. The app must read its port from the PORT environment variable (8080). Node.js, Python, Go, .NET, PHP and WebAssembly apps are supported.
Is OSC free to try?
Yes. The Basic tier is free, includes 100 tokens once, and needs no credit card. Paid plans start at 15 EUR per month when you need more capacity.
What Will You Build?
The full OSC service catalog is at your fingertips. Ask Claude Code to build anything — databases, APIs, frontends, pipelines.