Caffeine's hosted MCP connector is a bridge between conversational AI assistants and Caffeine's cloud build environment. It runs at https://mcp.caffeine.ai/mcp and exposes Caffeine's build capabilities as a Model Context Protocol server — without you having to switch apps.
That means: you stay in ChatGPT, Claude, or Cursor, write your message as usual, and the assistant calls Caffeine in the background. You get structured responses, no app context switching, and the entire connection is OAuth-secured — Caffeine authorizes the assistant, never the other way around.
> WHAT IS THE MCP CONNECTOR?
The Model Context Protocol (MCP) is an open standard that lets AI assistants securely access external tools and data sources. Caffeine operates a hosted MCP server at https://mcp.caffeine.ai/mcp. When you add this connector to ChatGPT, Claude Desktop, or Cursor, the assistant can execute Caffeine build actions — list projects, start builds, retrieve transcripts — and show you the results directly in chat.
Why it matters: without the connector you would have to switch to the Caffeine web app for every build action, trigger it there, copy the result, and switch back to your assistant. With the connector everything happens in the same chat window. You get structured responses instead of screenshots, the assistant can chain multiple actions, and the connection is OAuth-secured — Caffeine authorizes the assistant, never the other way around.
// Caffeine launched the MCP connector on June 16, 2026.
> THE CONNECTOR URL
All three walkthroughs below use the same connector URL. Copy it now — you will paste it into every assistant:
https://mcp.caffeine.ai/mcp> CHATGPT — STEP BY STEP
1. OPEN CHATGPT
Open ChatGPT in your browser or app. You need a ChatGPT account — Plus, Team, or Enterprise all work.
2. CLICK + BELOW THE MESSAGE BOX
Below the message input field you see a + icon. Click it to open the connector options menu.
3. CHOOSE 'ADD CUSTOM CONNECTOR'
From the menu choose 'Add Custom Connector'. A dialog opens asking for the connector URL.
4. ENTER THE CONNECTOR URL
Paste the Caffeine MCP connector URL and confirm. ChatGPT recognizes the connector and starts the OAuth flow.
5. COMPLETE OAUTH IN THE BROWSER
A browser window opens at caffeine.ai. Sign in and authorize the connector. Close the window after confirming.
6. VERIFY CONNECTOR WITH TOOL COUNT
Back in ChatGPT the connector appears with the number of available tools. That confirms the connection is live.
7. INVOKE VIA @ MENTION OR + MENU
Mention the connector with @caffeine in a message or pick it from the + menu to trigger an action.
> CLAUDE DESKTOP — STEP BY STEP
1. OPEN SETTINGS
Open Claude Desktop and go to Settings. You find them in the menu or via the gear icon.
2. NAVIGATE TO 'CONNECTORS'
In the settings menu select 'Connectors'. This lists all connected external tools.
3. CLICK 'ADD CUSTOM CONNECTOR'
Click 'Add Custom Connector'. A dialog opens asking for the connector URL.
4. ENTER THE CONNECTOR URL
Paste the Caffeine MCP connector URL and confirm. Claude Desktop starts the OAuth flow in the browser.
5. COMPLETE OAUTH IN THE BROWSER
A browser window opens at caffeine.ai. Sign in and authorize the connector. Close the window after confirming.
6. VERIFY CONNECTOR WITH TOOL COUNT
Back in Claude Desktop the connector is listed with the number of available tools. The connection is live.
7. TEST WITH 'LIST YOUR TOOLS'
Open a new chat and ask Claude: 'List your tools'. The response shows the Caffeine tools — the connector works.
> CURSOR — STEP BY STEP
1. OPEN SETTINGS
Open Cursor and go to Settings. Reach them via the menu or with Cmd/Ctrl+,
2. NAVIGATE TO 'FEATURES'
In the settings menu select 'Features'. This is where Cursor's advanced capabilities are configured.
3. ENABLE MCP
Find the toggle for MCP and enable it. This unlocks support for Model Context Protocol servers.
4. CLICK 'EDIT MCP'
Click 'Edit MCP'. The configuration file opens where you add MCP servers as JSON entries.
5. ADD MCPSERVERS ENTRY
Add an entry under mcpServers that contains the Caffeine connector URL as url. Save the file.
6. FULLY RESTART CURSOR
Quit Cursor completely and reopen it. A simple reload is not enough — the MCP server only loads on a full restart.
7. INVOKE VIA @CAFFEINE MENTION
In the chat window mention the connector with @caffeine to trigger an action. Cursor forwards the call to Caffeine.
> CURSOR MCP CONFIG
The mcpServers entry for Cursor looks like this. Paste it into the MCP configuration file that opens via 'Edit MCP':
{
"mcpServers": {
"caffeine": {
"url": "https://mcp.caffeine.ai/mcp"
}
}
}> WHAT YOU CAN DO ONCE CONNECTED
Once the connector is live, these Caffeine capabilities are available directly in chat:
LIST PROJECTS
Ask the connected assistant to list all your Caffeine projects. You see names, status, and last build time.
START BUILD SESSION
Start a new build session straight from chat. The assistant forwards your prompt to Caffeine and the build begins.
RESUME BUILD SESSION
Resume a paused or interrupted build session. The assistant knows the last state and continues from there.
RETRIEVE SESSION TRANSCRIPTS
Get the full transcript of a past build session displayed — every message, build, and result.
GENERATE PROJECT URLS
Get the web interface URL for a project. The assistant gives you the direct link to the Caffeine builder.
> ASSISTANT COMPARISON — SIX OPTIONS
Six assistants support the Caffeine MCP connector. Three are documented below with full walkthroughs; the other three follow the same pattern — add URL, restart, complete OAuth.
| Assistant | Setup Method | Auth | Status |
|---|---|---|---|
| ChatGPT | Add Custom Connector | OAuth in browser | Full walkthrough |
| Claude Desktop | Connectors → Add Custom Connector | OAuth in browser | Full walkthrough |
| Cursor | Features → MCP → Edit MCP | OAuth in browser | Full walkthrough |
| VS Code with GitHub Copilot | Add URL, restart editor | OAuth in browser | Also supported |
| OpenAI Codex | Add URL, restart | OAuth in browser | Also supported |
| Perplexity | Add URL, restart | OAuth in browser | Also supported |
ChatGPT
- Setup Method
- Add Custom Connector
- Auth
- OAuth in browser
- Status
- Full walkthrough
Claude Desktop
- Setup Method
- Connectors → Add Custom Connector
- Auth
- OAuth in browser
- Status
- Full walkthrough
Cursor
- Setup Method
- Features → MCP → Edit MCP
- Auth
- OAuth in browser
- Status
- Full walkthrough
VS Code with GitHub Copilot
- Setup Method
- Add URL, restart editor
- Auth
- OAuth in browser
- Status
- Also supported
OpenAI Codex
- Setup Method
- Add URL, restart
- Auth
- OAuth in browser
- Status
- Also supported
Perplexity
- Setup Method
- Add URL, restart
- Auth
- OAuth in browser
- Status
- Also supported
> QUICK START PROMPT
Copy this prompt and paste it into your connected assistant. It lists your Caffeine projects and starts a build session in one go:
List my Caffeine projects, then start a new build session for the most recent one. Show me the project name, current status, and the build session URL when it's ready.[ONE URL, SIX ASSISTANTS]
[OAUTH MUST COMPLETE IN THE BROWSER]
// MCP Connector Checklist
- I copied the connector URL https://mcp.caffeine.ai/mcp
- I completed the OAuth flow in the browser at caffeine.ai
- I saw the tool count in the assistant and verified the connection
- I ran a test action (e.g. list projects)
- I had a project URL generated for the web interface
