Skip to main content

​
New projects

Already have an MCP server? Skip the project scaffold and use sunpeak inspect --server <url> to test it immediately. See sunpeak inspect.
1

Install sunpeak

Requirements: Node.js 20+Install sunpeak globally:
pnpm add -g sunpeak
2

Create a project

Create a new project:
sunpeak new sunpeak-app
3

Develop locally

Navigate to your project and run the development server:
cd sunpeak-app
sunpeak dev
This starts:
  • The MCP App inspector at http://localhost:3000 for local development
  • An MCP server at http://localhost:8000 for testing with real hosts like ChatGPT
Both servers support Hot Module Reload - your changes reflect instantly!
4

Test in a host (ChatGPT)

Run a tunnel to allow ChatGPT to connect to your local MCP server:
# In another terminal, run a tunnel. For example:
ngrok http 8000
You can then connect to the tunnel Forwarding URL at the /mcp path (e.g. https://your-random-subdomain.ngrok-free.dev/mcp) from ChatGPT in developer mode: User > Settings > Apps & Connectors > Create.
5

Build & start for production

Build your resources and tools, then start the production MCP server:
pnpm build && pnpm start
This compiles your tool handlers, Zod schemas, and optional auth from src/server.ts, then starts a production MCP server on port 8000.

Project Scaffold

Explore your new MCP App project.

Deployment Guide

Deploy your app to production.