Features › Advanced Features
Emergent as an MCP
The Emergent MCP connector lets you build and manage apps directly from any AI you already use. Connect once, then tell Claude or ChatGPT to build something — it will start a real Emergent job, relay the agent's questions back to you, and hand you a live preview link when the app is ready.
Info
Connector URL: https://mcp.emergent.sh/
The trailing slash is part of the URL. Paste it exactly as shown.
What you can do
Once connected, you can say things like:
- "Build me a recipe-sharing app with login and image upload."
- "What's the status of my todo app from yesterday?"
- "Tell the agent to make the dashboard dark-mode by default."
- "Show me the live preview of my latest project."
- "List all the apps I've built this week."
- "Pause the job that's running — I'll come back to it later."
The connector exposes 8 actions to the AI:
| Action | What it does |
|---|---|
create_job | Start a new app build from a plain-language description |
wait_for_job | Wait until the agent asks its first question or finishes |
send_message | Answer the agent, give feedback, or request changes |
list_jobs | List your apps and projects, newest first |
get_job_status | Check what a job is doing and what it last said |
get_recent_trajectories | Read the recent conversation on a job |
get_job_preview | Get the live, browsable URL of a built app |
pause_job | Stop a job's environment to save resources (fully resumable) |
Requirements
Any Emergent Account
Free or paid — the connector works with any Emergent account.
Supported Clients
Claude (claude.ai web and desktop)
ChatGPT (chatgpt.com)
Claude Code (terminal)
Codex CLI (terminal)
Setup
Connect in Claude
Works on claude.ai (web and desktop).
Open Connectors
Go to Settings and click Connectors.
Add the connector
Click Add custom connector. Name it Emergent, paste https://mcp.emergent.sh/, and click Add.
Sign in
Click Connect. Your browser opens the Emergent sign-in page. Log in with your Emergent account.
Approve
Review the consent screen and click Approve. You are returned to Claude, connected.
Start building
In any chat, enable the Emergent connector from the tools (+) menu and start asking.
Info
Claude renders a live job card with an embedded preview while your app builds.
Connect in ChatGPT
Works on chatgpt.com.
Open Apps and Connectors
Go to Settings and click Apps & Connectors.
Enable Developer mode
Under Advanced settings, enable Developer mode. This is required for custom connectors.
Add the connector
Click Create / Add connector, name it Emergent, paste the connector URL, and select OAuth as the authentication method.
Sign in and approve
Sign in on the Emergent page that opens, then click Approve on the consent screen.
Start building
In a new chat, enable the Emergent connector from the tools (+) menu and start asking.
Info
ChatGPT renders a live job card while your app builds.
Connect in Claude Code
Register the server
Run this once in your terminal. The --scope user flag makes it available across every project automatically.
claude mcp add --transport http --scope user emergent https://mcp.emergent.sh/
Authenticate
Inside a Claude Code session, run /mcp, select emergent, and choose Authenticate. Your browser opens the Emergent sign-in and consent flow.
Approve and start
Approve the connection. The session is live. Verify at any time with claude mcp list.
Example prompt:
Create an emergent job that builds a pomodoro timer, then wait for its first question.
Connect in Codex CLI
Register the server
Run this once in your terminal:
codex mcp add emergent --url https://mcp.emergent.sh/
Or add it manually to ~/.codex/config.toml:
[mcp_servers.emergent] url = "https://mcp.emergent.sh/"
Authenticate
codex mcp login emergent
Your browser opens the Emergent OAuth flow. Approve it and the eight Emergent tools appear in Codex's tool list. Verify with codex mcp list.
Info
On older Codex versions, streamable HTTP with OAuth may require adding experimental_use_rmcp_client = true at the top of your config.toml.
How the connection works
The first time you connect, your browser opens the normal Emergent sign-in page and asks you to approve the connection — the same way "Sign in with Google" works for another app. The AI never sees your Emergent password. Your connector token is separate from your account credentials, can be revoked independently, and only works for this connector.
You can disconnect at any time from the same settings screen in Claude or ChatGPT.
Troubleshooting
Make sure you enabled it in the tools (+) menu within the chat. In Claude Code, run /mcp to confirm the connection status shows as active.
Check that the URL ends with a trailing slash: https://mcp.emergent.sh/
Run claude mcp list to confirm the server is registered. If it is, try re-authenticating via /mcp inside a session.
Run get_job_status on the job. The status message will include a billing link to top up and resume.
Getting help
- Discord: discord.gg/VzKfwCXC4A
- Email: support@emergent.sh
