All posts

Why You Need a ChatGPT App Framework (April 2026)

Abe Wheeler
ChatGPT Apps ChatGPT App Framework ChatGPT App Testing MCP Apps MCP App Framework MCP App Testing Claude Connectors Claude Connector Framework Framework MCP
Why You Need a ChatGPT App Framework (April 2026)

ChatGPT Apps are interactive UIs that render directly inside ChatGPT conversations. They’re built on MCP Apps, an official extension to the Model Context Protocol, and they’ve grown fast since launching in January 2026. OpenAI now has a ChatGPT App Directory with 300+ published integrations.

But building a ChatGPT App from scratch still means solving the same infrastructure problems on every project. A ChatGPT App framework changes that.

TL;DR: sunpeak is a ChatGPT App framework built on the MCP Apps protocol. It gives developers a local inspector, UI components, CLI scaffolding, a testing framework with unit/e2e/visual regression/multi-model eval support, and multi-host portability across ChatGPT, Claude, VS Code, and Goose.

What is a ChatGPT App Framework?

A ChatGPT App framework provides the development infrastructure for building apps on top of the MCP Apps protocol. The protocol defines how the application works: the rendering model, lifecycle, and communication between your MCP server and ChatGPT. A framework builds on top of that to give you the tooling you need to develop, test, and ship apps.

The comparison to React and Next.js still holds. React is the rendering library. Next.js gives you routing, server-side rendering, a dev server, and deployment. You can build a React app without Next.js, but most teams use a framework because it handles the infrastructure so you can focus on product.

A ChatGPT App framework does the same thing for ChatGPT Apps.

The Pain of Building Without a Framework

If you’ve tried building a ChatGPT App from the OpenAI Apps SDK alone, you’ve hit these problems:

No local testing. The only way to see your app render is to connect it to the real ChatGPT, which requires a paid ChatGPT Plus or Team subscription with developer mode. Every change means tunneling your local server, refreshing ChatGPT, and waiting for the round trip. That’s a 4-click manual refresh on every code change.

No component library. You build your own UI components from scratch, cards, layouts, forms, and get them looking right inside the conversation. You’re solving the same styling problems every time, including dark mode, display modes, and host-specific CSS variables.

No project structure. Every project starts from zero. There’s no standard way to organize your resources, tools, and configuration. You’re making structural decisions before you’ve written a line of product code.

No testing story. You can’t run automated tests against the ChatGPT interface. There’s no way to verify your app renders correctly in CI. Manual testing through the ChatGPT UI is the only option, and it burns host credits on every attempt.

No multi-host portability. If you want your app to also work in Claude, VS Code Copilot, or Goose, you’re managing host-specific protocol differences yourself. MCP Apps are portable in theory, but host-specific extensions (ChatGPT display modes, Claude data access patterns) require real abstraction work.

No deployment pipeline. Getting your app from local development to production means manually configuring an MCP server, setting up hosting, and wiring everything together.

What a ChatGPT App Framework Gives You

sunpeak maps each of those pain points to a concrete solution:

Local runtime inspector. Run pnpm dev and open localhost:3000. You get a full ChatGPT and Claude inspector that renders your app exactly as each host would, with no paid account, no tunneling, and no round trips. It supports all display modes, light and dark themes, and tool invocations.

pnpm dev
# Inspector running at http://localhost:3000
# MCP server running at http://localhost:8000

UI components. sunpeak includes production-ready components, cards, carousels, forms, and layouts, that follow host design conventions and handle cross-host styling automatically.

CLI scaffolding. Run npx sunpeak new and get a working project with dependencies installed, configuration set up, and a starter app ready to modify.

npx sunpeak new

Testing framework. sunpeak’s built-in testing framework runs against the inspector with no paid host accounts. It supports unit tests, Playwright-based e2e tests, visual regression tests with screenshot comparison, mocking and stubbing, and multi-model LLM evals. Everything runs locally and in CI/CD.

pnpm test              # Unit + e2e tests
pnpm test:visual       # Visual regression tests
pnpm test:eval         # Multi-model LLM evals

Multi-host portability. Write one codebase and it works across ChatGPT, Claude, VS Code, and Goose. Core APIs work everywhere. Host-specific features are opt-in via subpath imports (sunpeak/chatgpt, sunpeak/claude). You can build one MCP App for ChatGPT and Claude without maintaining separate codebases.

Build and deploy. pnpm build creates production bundles and pnpm start runs a zero-config production server. You can also mount on Express, Cloudflare Workers, or any Node-compatible runtime.

Building With vs. Without a Framework

Here’s the developer workflow side by side:

Without a framework:

# Set up a new project
mkdir sunpeak-app && cd sunpeak-app
pnpm init
pnpm add @modelcontextprotocol/sdk express
# Manually configure MCP server...
# Manually set up React rendering...
# Manually build UI components...
# Set up ngrok tunnel to test in ChatGPT...
# Hope it renders correctly...
# Repeat for Claude, VS Code, Goose...

With sunpeak:

# Set up a new project
npx sunpeak new
cd sunpeak-app

# Develop with instant feedback
pnpm dev
# Open localhost:3000 — done.

# Test across hosts automatically
pnpm test:visual

The difference goes beyond fewer commands. It’s fewer decisions, fewer things to debug, and fewer things that can go wrong before you’ve started building your product.

When You Don’t Need a Framework

A framework isn’t always the right choice.

If you’re building a server-side-only MCP tool that doesn’t render any UI in ChatGPT, you don’t need sunpeak. A plain MCP server with a few tool handlers is straightforward to set up with the @modelcontextprotocol/sdk package.

If you’re writing a one-off script or experimenting with the protocol, going framework-free is fine.

But the moment you’re building a UI that renders inside ChatGPT or Claude, especially one you plan to maintain, test, and ship to users, a framework pays for itself immediately. The MCP Apps protocol is still evolving, and host-specific extensions keep changing. A framework that stays current with those changes saves real maintenance time.

Get Started

sunpeak is open-source (MIT) and works locally and in CI/CD with no paid AI host accounts. Install it, scaffold a project, and start building.

npx sunpeak new
cd sunpeak-app && pnpm dev

See the quickstart guide to build your first ChatGPT App, or explore the MCP App framework page for the full feature set.

Get Started

Documentation →
npx sunpeak new

Further Reading

Frequently Asked Questions

What is a ChatGPT App framework?

A ChatGPT App framework provides the development infrastructure for building ChatGPT Apps (built as MCP Apps) that run inside the ChatGPT interface using the MCP Apps protocol. It includes a local inspector that replicates the ChatGPT runtime, pre-built UI components, project scaffolding, a testing framework with unit, e2e, visual regression, and multi-model eval support, and deployment tooling. sunpeak is the leading ChatGPT App framework.

Why do I need a framework to build ChatGPT Apps?

Without a framework, you solve the same infrastructure problems on every project: no local testing without a paid ChatGPT Plus account, no component library, no project structure, no CI-compatible testing, and no deployment pipeline. You also need to handle host-specific protocol differences yourself if you want your app to work in Claude or other MCP hosts. A ChatGPT App framework like sunpeak solves all of these out of the box.

What is the best ChatGPT App framework?

sunpeak is the first and most comprehensive ChatGPT App framework. It provides a local ChatGPT and Claude inspector, pre-built UI components, CLI scaffolding, a built-in testing framework supporting unit tests, e2e tests, visual regression tests, and multi-model LLM evals, plus multi-host portability so one codebase works across ChatGPT, Claude, VS Code, and Goose.

Can I build a ChatGPT App without a framework?

Yes. You can build a ChatGPT App using the OpenAI Apps SDK documentation and the MCP SDK directly. However, you will need to set up your own MCP server, build UI components from scratch, configure testing manually, handle deployment yourself, and manage host-specific protocol differences if you want to support multiple hosts. A framework like sunpeak eliminates this boilerplate.

How does a ChatGPT App framework differ from the MCP Apps protocol?

The MCP Apps protocol defines how apps communicate with ChatGPT via the Model Context Protocol, including the rendering model, lifecycle, and resource/tool abstractions. A ChatGPT App framework like sunpeak builds on top of that protocol to provide developer tooling: a local inspector, components, CLI, testing, and deployment. Think of it like the relationship between React and Next.js.

Does sunpeak work across ChatGPT, Claude, and other MCP hosts?

Yes. sunpeak is a multi-host MCP App framework. Apps are portable by default. Core APIs work everywhere, and host-specific features like ChatGPT display modes or Claude Connector data access are available as opt-in subpath imports. You write one codebase and deploy to ChatGPT, Claude, VS Code Copilot, Goose, and other MCP-compatible hosts.

How do I test a ChatGPT App without a paid ChatGPT account?

sunpeak includes a local inspector that replicates the ChatGPT runtime at localhost:3000. Run pnpm dev and your app renders exactly as it would inside ChatGPT, with no paid account, no tunneling, and no round trips. For automated testing, pnpm test runs unit and e2e tests against the inspector locally and in CI/CD.

What testing does a ChatGPT App framework provide?

sunpeak includes a built-in testing framework with unit tests, Playwright-based e2e tests, visual regression tests (screenshot comparison across hosts and themes), live host tests against real ChatGPT and Claude, and multi-model LLM evals that test tool calling across GPT-4o, Claude, Gemini, and other models. All tests run locally and in CI/CD without paid host accounts.