ChatGPT App TypeScript Template
ChatGPT app template using Pomerium, OpenAI Apps SDK and Model Context Protocol (MCP), with a Node.js server and React widgets.
What is ChatGPT App TypeScript Template?
ChatGPT App TypeScript Template is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to chatgpt app template using pomerium, openai apps sdk and model context protocol (mcp), with a node.js server and react widgets.
ChatGPT app template using Pomerium, OpenAI Apps SDK and Model Context Protocol (MCP), with a Node.js server and React widgets.
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- ChatGPT app template using Pomerium, OpenAI Apps SDK and Mod
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx chatgpt-app-typescript-templateConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use ChatGPT App TypeScript Template
The ChatGPT App TypeScript Template is a complete starter kit for building MCP-powered ChatGPT applications using the OpenAI Apps SDK, a Node.js/Express backend, and React widgets. It integrates Pomerium as an identity-aware proxy for secure authentication, includes a working echo tool with interactive widget rendering, and demonstrates the full MCP Apps flow — from tool invocation to structured content responses and dynamic display modes — so developers can build production ChatGPT connectors on a solid, tested foundation.
Prerequisites
- Node.js 24 or higher (node -v to verify)
- npm 11 or higher (npm -v to verify)
- A ChatGPT account with connector access (ChatGPT Plus or Team)
- Optional: Pomerium for production identity-aware proxy; for local testing, the built-in tunnel via pom.run is sufficient
Clone the template and install dependencies
Clone the repository into your new project directory and install all Node.js dependencies with npm.
git clone https://github.com/pomerium/chatgpt-app-typescript-template your-app
cd your-app
npm installStart the development server
Run the development server, which starts both the Node.js/Express MCP backend and the React widget builder simultaneously.
npm run devCreate a public tunnel for testing
ChatGPT requires a public HTTPS URL to reach your MCP server. Use the built-in pom.run SSH tunnel to expose your local server during development.
ssh -R 0 pom.runConnect ChatGPT to your MCP server
In ChatGPT, go to Settings → Connectors → Add Connector and enter your tunnel URL followed by /mcp (e.g. https://your-tunnel.pom.run/mcp). ChatGPT will discover available tools automatically.
Test the echo tool and customize
Test the included echo tool by sending a message through ChatGPT. Then customize the server by adding your own MCP tools in the Express backend and corresponding React widgets.
npm run inspectChatGPT App TypeScript Template Examples
Client configuration (environment variables)
Create a .env file in the project root with these variables to configure the server for development or production.
{
"NODE_ENV": "development",
"PORT": "8080",
"LOG_LEVEL": "info",
"SESSION_MAX_AGE": "3600000",
"CORS_ORIGIN": "*",
"BASE_URL": ""
}Prompts to try
Test prompts that exercise the included echo tool and its interactive React widget capabilities.
- "echo today is a great day"
- "echo hello world and show it in fullscreen mode"
- "call the echo tool and tell me what structured content it returns"
- "echo this message and then open a link to https://example.com"Troubleshooting ChatGPT App TypeScript Template
npm run dev fails with Node version errors
This template requires Node.js 24 or higher. Run 'node -v' to check your version. Use nvm to install Node 24: 'nvm install 24 && nvm use 24'.
ChatGPT cannot discover tools at the /mcp endpoint
Ensure your tunnel is active and the URL is reachable from the internet. ChatGPT expects the MCP endpoint at <your-url>/mcp. Test the endpoint locally first with 'npm run inspect' using the MCP Inspector UI.
React widgets do not render in ChatGPT
Widgets require the _meta.ui.resourceUri field in the tool response to bind the structured content to a widget. Run 'npm run dev:inline' for a self-contained HTML mode that works better with tunneling setups.
Frequently Asked Questions about ChatGPT App TypeScript Template
What is ChatGPT App TypeScript Template?
ChatGPT App TypeScript Template is a Model Context Protocol (MCP) server that chatgpt app template using pomerium, openai apps sdk and model context protocol (mcp), with a node.js server and react widgets. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install ChatGPT App TypeScript Template?
Follow the installation instructions on the ChatGPT App TypeScript Template GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with ChatGPT App TypeScript Template?
ChatGPT App TypeScript Template works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is ChatGPT App TypeScript Template free to use?
Yes, ChatGPT App TypeScript Template is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.
ChatGPT App TypeScript Template Alternatives — Similar Developer Tools Servers
Looking for alternatives to ChatGPT App TypeScript Template? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up ChatGPT App TypeScript Template in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use ChatGPT App TypeScript Template?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.