You can now deploy and host ChatGPT Apps on mcp-agent cloud, our MCP-native platform.
No complex infra. No manual setup. Just write your app, connect it, and deploy in minutes.
š¬ What Are ChatGPT Apps
ChatGPT Apps let you create interactive experiences that live inside ChatGPT conversations.
Apps can connect to APIs, databases, or services and respond with in-chat UI elements such as maps, charts, or playlists.
ChatGPT Apps are powered by the Model Context Protocol (MCP), which allows ChatGPT to talk directly to external services through a structured interface.
āļø What is mcp-agent
mcp-agent is an open-source toolkit and hosting platform for developers building MCP servers and ChatGPT Apps.
It helps you:
- Build and run MCP servers locally or in the cloud
- Simplify connection between your ChatGPT App and backend
- Manage deployment, logging, and configuration automatically
In short, mcp-agent is the bridge between your Python app and ChatGPT.
With mcp-agent cloud, you can host your MCP server and get a public endpoint ready for ChatGPT in minutes.
š§ Quick Start: Deploy Your ChatGPT App
TL;DR
- Create an
MCPApp()
in your Python server code - Install the
mcp-agent
library - Deploy with the
mcp-agent
CLI
1ļøā£ Prerequisites
2ļøā£ Install Dependencies
Using uv
(recommended):
uv init
uv sync
Or with pip:
pip install mcp-agent
pip install fastapi
3ļøā£ Create an MCPApp()
MCPApp
is what connects your MCP server to mcp-agent cloud.
Hereās a minimal example:
from mcp_agent.app import MCPApp
from fastmcp import FastMCP # import if your project uses FastMCP
mcp = FastMCP(
name="your-app-name",
message_path="/sse/messages", # aligns with your SSE path
stateless_http=True, # recommended for cloud hosting
)
## Register your MCP server as an mcp-agent App
app = MCPApp(
name="your-app-name",
description="your-app-description",
mcp=mcp,
)
## Your ChatGPT Application code here
These few lines are what make your app discoverable and deployable by mcp-agent cloud.
4ļøā£ Add Deployment Config and Secrets
At your repo root, create two files:
mcp_agent.config.yaml
execution_engine: asyncio
name: "your-app-name"
description: "your-app-description"
logger:
transports: [console, file]
level: info
path: logs/mcp-agent.log
mcp_agent.secrets.yaml
## Optional: include API keys, tokens, or secrets here
5ļøā£ Deploy to mcp-agent Cloud
Using uv
:
uv run mcp-agent login
uv run mcp-agent deploy --no-auth
Or with venv
:
mcp-agent login
mcp-agent deploy --no-auth
Support for OAuth coming soon
After a successful deploy, youāll see a cloud URL like:
https://.deployments.mcp-agent.com/sse
6ļøā£ Connect to ChatGPT
- Enable Developer Mode in ChatGPT
- Go to Settings ā Connectors
- Add your appās cloud URL (make sure it ends with
/sse
)
ChatGPT connects to the
/sse
endpoint, so that suffix is required.
š§° Troubleshooting
404 or Connection Errors:
Make sure your URL ends with /sse
and your appās message_path
is /sse/messages
.
Auth Errors:
If deploy fails, run mcp-agent login
.
If ChatGPT canāt connect, make sure you deployed with --no-auth
for open access.
Debugging:
Use MCP Inspector to test and validate your MCP server locally.
š§© Example Projects
ā¤ļø Wrapping Up
ChatGPT Apps are a new way to create interactive, conversational tools that live right inside ChatGPT.
With mcp-agent cloud, deploying one is as simple as:
mcp-agent deploy --no-auth
And just like that, your ChatGPT App is live and ready for anyone to use.