RC
0/21
AUDIO READY — click anywhere to start
SECTION_21

Connecting External AI Assistants via MCP

Connect external AI assistants like ChatGPT, Claude, and Cursor to Caffeine via the hosted MCP connector.

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:

Caffeine MCP connector URL
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':

Cursor mcpServers JSON
{
  "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.

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:

Copy & paste quick start prompt
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]

The connector URL is identical for all six assistants. You do not need to configure per-assistant variants — the same https://mcp.caffeine.ai/mcp works in ChatGPT, Claude Desktop, Cursor, VS Code with GitHub Copilot, OpenAI Codex, and Perplexity. If you use multiple assistants, add the same connector in each.

[OAUTH MUST COMPLETE IN THE BROWSER]

The OAuth flow always opens a browser window at caffeine.ai — even when you add the connector in a desktop app like Claude Desktop or Cursor. Do not close the browser window until you have confirmed authorization. The assistant detects completion automatically and shows the connector with tool count.

// 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
Next Section