--- title: "How to Deploy a Cursor Project to Hostman App Platform | Hostman Docs" description: "Deploy a Cursor project to Hostman App Platform: creating a GitHub account, generating an access token, connecting GitHub MCP, pushing code, and configuring the app deployment." --- > For the complete documentation index for AI agents, see [llms.txt](https://hostman.com/llms.txt). This guide walks you through taking a project built in Cursor and shipping it to a live URL using Hostman App Platform. So, you've built (or generated) an app in Cursor, but you're not sure how to get it online. The path is straightforward: push your code to GitHub, connect that repository to Hostman, and deploy. Along the way, we'll set up MCP, which lets Cursor talk to your GitHub account directly from the chat. That means creating repositories and pushing code without touching the command line. This guide assumes no prior experience with GitHub or deployment—just follow the steps in order. ## Step 1. Create a GitHub Account You'll need a GitHub account to host your project's code and connect it to Hostman. 1. Go to [github.com](https://github.com/) and click **Sign up**. 2. Sign up with Google, Apple, or an email address—whichever is easiest for you. Once you're done, you'll land on your GitHub dashboard.  ![0902d2f9 709a 41df B496 De8fb6ff0a11.png](https://content.hostman.com/assets/1fb8456b-5bb6-4223-9231-66021cafbf3f.png?width=1999&height=1142) _[GitHub](https://github.com/) Dashboard_ ## Step 2. Generate an Access Token Cursor needs an access token to act on your behalf on GitHub—creating repositories and pushing code. In your GitHub account: 1. Click your profile icon in the top-right corner and select **Settings**. 2. Scroll down in the left sidebar to **Developer settings**, then go to **Personal access tokens** → **Tokens (classic)**. 3. Click **Generate new token**, then **Generate new token (classic)**. GitHub may ask you to re-enter your password at this point—that's expected. ![Image2](https://content.hostman.com/assets/f42a4688-68a3-43ff-a654-b1ed470e8af6.png?width=1999&height=1122) _Creating a token in the [GitHub](https://github.com/) interface_ 4. Under **Note**, give the token a descriptive name, like `Cursor-access`. 5. Under **Expiration**, choose how long the token should last. If you'd rather not deal with this again, select **No expiration**. 6. Under **Select scopes**, check the **repo** box to grant Cursor the necessary permissions. 7. Click **Generate token**. > [!NOTE] > GitHub will show you the token once—copy it and store it somewhere safe. You won't be able to view it again. Treat this token like a password. Don't commit it to your repository or share it publicly. If you think it's been exposed, revoke it at [github.com/settings/tokens](https://github.com/settings/tokens) and generate a new one. ## Step 3. Connect the GitHub MCP Server to Cursor No manual configuration files needed here—you can set up the MCP connection right from Cursor's chat. 1. Open the chat panel in Cursor and send a message like: _Connect the GitHub MCP server. Use this token to authenticate: `YOUR_GITHUB_TOKEN`._ Replace `YOUR_GITHUB_TOKEN` with the token you generated earlier. ![Image5](https://content.hostman.com/assets/d5384672-807e-42be-aa84-cad201ba9246.png?width=1999&height=1207) _Chat window in the [Cursor](https://cursor.com/) interface_ 2. Wait for Cursor to finish setting up the connection, then restart Cursor. From here on, Cursor can create repositories and push files on your behalf whenever you ask it to in chat. ## Step 4. Push Your Project to GitHub Next, create a repository and push your project to it—all from within Cursor. 1. In the chat, ask Cursor to create a repository: _Create a new public GitHub repository for my project._  Cursor will ask for permission to run this action—approve it. ![Scr 20260716 Oueq1](https://content.hostman.com/assets/66573211-e1c7-4f89-9c14-2fa49032c8ad.png?width=2508&height=1524) _Chat window in the [Cursor](https://cursor.com/) interface_ Once the repository is created, you can confirm it exists by checking your repository list on GitHub. 2. Now push your code. In the same chat, send: _Push the project in the current directory to this repository using the GitHub MCP server._  If your code lives in a subfolder rather than the project root, mention that folder explicitly. > [!NOTE] > Be specific about using MCP. If you don't mention it, Cursor may default to a local `git` command instead—which will fail if Git isn't installed or authenticated on your machine. Cursor will again ask for permission before pushing—approve it, then check the repository on GitHub to confirm your files are there. ## Step 5. Deploy the Project on App Platform With your code on GitHub, you're ready to deploy. 1. Open the Hostman dashboard, go to **App Platform**, and click **Create App**. 2. Choose your application type—**Frontend**, **Backend**, or **Docker**—and select the framework your project uses. If you're not sure, ask Cursor to check for you. 3. Connect your repository: - - On the **Repository** step, click the GitHub icon. - Sign in to your account. - Authorize access to your repositories. - Select the repository you want to deploy. If you're already signed in, your repositories will appear right away. If the one you need isn't listed, click **Add Account**, select GitHub again, and grant access. This gives Hostman access to your GitHub repositories and lets you enable auto-deploy, so your app redeploys automatically whenever you push changes. For auto-deploy to work, keep the option **Built by the last executed commit** enabled. 4. Select the commit to deploy (usually there's just one). 5. Choose the region where your app will run. 6. Under **App Settings**, configure your application. You can find the full list of parameters in the docs for [frontend](https://hostman.com/docs/app-platform/frontend-apps/), [backend](https://hostman.com/docs/app-platform/backend-apps/), [Dockerfile](https://hostman.com/docs/app-platform/dockerfile/), and [Docker Compose](https://hostman.com/docs/app-platform/docker-compose/) apps—or ask Cursor what values to use for your setup. 7. Click **Create** and wait for the deployment to finish. ## You’re Live! Once the app is live, open the **Dashboard** tab. The **Domain** field shows the technical domain where your app is running. You can change this to a [custom domain](https://hostman.com/docs/app-platform/managing-apps/#custom-domain) anytime from **Settings**. Going forward, shipping changes is just as simple. Make your edits to the project in Cursor and tell Cursor to commit and push these changes to the repository using the GitHub MCP server. Hostman will pick up the new commit and redeploy automatically.