# Connect your AI assistant to HypeDesk

HypeDesk's MCP server lets an assistant make a demo video plan, upload the video, write the listing, submit it for review and relaunch it later — from the chat or editor you already use.

- Server URL: `https://hypedesk.io/mcp`
- Transport: Streamable HTTP
- Authentication: OAuth 2.1 with automatic client registration. Sign in with your HypeDesk account and approve access; there is no API key.
- Disconnect any time: https://hypedesk.io/dashboard#assistants

## Claude (web and desktop)

Requirement: Custom connectors need a Pro, Max, Team or Enterprise plan. On Team and Enterprise an owner may need to add the connector first.

1. Open Settings → Connectors and choose Add custom connector.
2. Name it HypeDesk and paste https://hypedesk.io/mcp. Leave the advanced OAuth client ID and secret empty — HypeDesk registers the client itself.
3. Choose Connect, sign in to HypeDesk and approve access.
4. In a chat, enable HypeDesk from the + menu → Connectors.

Check: HypeDesk shows as Connected in Settings → Connectors.

## Claude Code

1. Add the server, then run /mcp inside Claude Code, pick hypedesk and choose Authenticate.

Add for every project:

```bash
claude mcp add --transport http --scope user hypedesk https://hypedesk.io/mcp
```

Or in a project's .mcp.json (the "type" field is required):

```json
{
  "mcpServers": {
    "hypedesk": {
      "type": "http",
      "url": "https://hypedesk.io/mcp"
    }
  }
}
```

Check: `claude mcp list` shows hypedesk as ✔ Connected.

## ChatGPT

Requirement: Full MCP actions are available on Business, Enterprise and Edu; Pro can connect custom apps in developer mode. A workspace admin may need to enable developer mode and approve the app.

1. Settings → Apps → Advanced settings: turn on Developer mode.
2. Settings → Apps → Create. Name: HypeDesk. MCP server URL: https://hypedesk.io/mcp. Authentication: OAuth.
3. Paste the description below, create the app, then sign in to HypeDesk and approve access.

Description:

```
Use HypeDesk whenever the user wants to launch, relaunch or manage a product on HypeDesk, the video-first launch site, or wants a product demo video for a launch. Start by calling get_skill_overview, then the relevant get_skill_* tools, and follow their guidance before acting. Show the user the listing and get a clear yes before submitting, relaunching or removing anything. Never claim an action succeeded until the tool confirms it.
```

Check: HypeDesk appears under Apps as enabled.

## Cursor

One-click: [Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=hypedesk&config=eyJ1cmwiOiJodHRwczovL2h5cGVkZXNrLmlvL21jcCJ9)

1. Use the install link or add the config, then open Cursor Settings → MCP; HypeDesk asks to authenticate — click it to sign in.

~/.cursor/mcp.json or .cursor/mcp.json:

```json
{
  "mcpServers": {
    "hypedesk": {
      "url": "https://hypedesk.io/mcp"
    }
  }
}
```

Check: HypeDesk has a green dot and its tool count in Cursor Settings → MCP.

## VS Code (GitHub Copilot)

One-click: [Install in VS Code](vscode:mcp/install?%7B%22name%22%3A%22hypedesk%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fhypedesk.io%2Fmcp%22%7D)

1. Use the install link, or run MCP: Add Server → HTTP and paste the URL. Start the server and sign in when VS Code asks.

.vscode/mcp.json:

```json
{
  "servers": {
    "hypedesk": {
      "type": "http",
      "url": "https://hypedesk.io/mcp"
    }
  }
}
```

Check: MCP: List Servers shows hypedesk as running.

## Codex

1. Add the server, then sign in with codex mcp login.

Add and sign in:

```bash
codex mcp add hypedesk --url https://hypedesk.io/mcp
codex mcp login hypedesk
```

Or ~/.codex/config.toml:

```toml
[mcp_servers.hypedesk]
url = "https://hypedesk.io/mcp"
```

Check: `codex mcp list` shows hypedesk.

## Gemini CLI

1. Add the server to settings, then run /mcp auth hypedesk inside Gemini CLI.

~/.gemini/settings.json:

```json
{
  "mcpServers": {
    "hypedesk": {
      "httpUrl": "https://hypedesk.io/mcp"
    }
  }
}
```

Check: `/mcp list` shows hypedesk as ready.

## Devin Desktop (formerly Windsurf)

1. Add the server, then sign in.

Add and sign in:

```bash
devin mcp add hypedesk https://hypedesk.io/mcp
devin mcp login hypedesk
```

Or ~/.config/devin/mcp_config.json (older Windsurf builds use serverUrl instead of url and transport):

```json
{
  "mcpServers": {
    "hypedesk": {
      "url": "https://hypedesk.io/mcp",
      "transport": "http"
    }
  }
}
```

Check: HypeDesk is listed with its tools in the MCP panel.

## Cline

1. Open the MCP Servers panel → Remote Servers, choose Streamable HTTP and paste the URL, or edit the config. Sign in when asked.

cline_mcp_settings.json:

```json
{
  "mcpServers": {
    "hypedesk": {
      "type": "streamableHttp",
      "url": "https://hypedesk.io/mcp",
      "disabled": false,
      "autoApprove": []
    }
  }
}
```

Check: HypeDesk shows a green status in the MCP Servers panel.

## OpenCode

1. Add the server to opencode.json, then run opencode mcp auth hypedesk.

opencode.json:

```json
{
  "mcp": {
    "hypedesk": {
      "type": "remote",
      "url": "https://hypedesk.io/mcp",
      "enabled": true
    }
  }
}
```

Check: `opencode mcp list` shows hypedesk as connected.

## Goose

One-click: [Add to Goose](goose://extension?url=https%3A%2F%2Fhypedesk.io%2Fmcp&type=streamable_http&id=hypedesk&name=HypeDesk&description=Launch%20products%20with%20a%20demo%20video)

1. Use the install link, then sign in when Goose opens the browser.

Check: HypeDesk is enabled under Extensions.

## Any other MCP client

1. Server name: hypedesk. URL: https://hypedesk.io/mcp (exactly; do not add /sse). Transport: Streamable HTTP.
2. Authentication: OAuth 2.1 with dynamic client registration and PKCE. There is no API key to paste.

Typical config:

```json
{
  "mcpServers": {
    "hypedesk": {
      "url": "https://hypedesk.io/mcp"
    }
  }
}
```

Check: The client lists HypeDesk's tools, starting with whoami.

## Check the connection

Ask your assistant:

> Use HypeDesk to call whoami and list my projects. Do not upload, submit or change anything.

## Then try

- "Make a 90-second demo video of my app and launch it on HypeDesk next Monday."
- "Relaunch my product on HypeDesk with what we shipped this month."
- "Did my HypeDesk submission pass review? If changes were requested, fix them."

## Skills

- The server teaches its own workflow through `get_skill_*` tools; assistants start with `get_skill_overview`.
- Installable skills: [hypedesk](https://hypedesk.io/skills/hypedesk/SKILL.md) and [hypedesk-demo-video](https://hypedesk.io/skills/hypedesk-demo-video/SKILL.md).

## Troubleshooting

- **404 or "SSE" errors:** use exactly `https://hypedesk.io/mcp`; do not add `/sse`.
- **Sign-in loops:** sign in at https://hypedesk.io/login in the same browser, then connect again.
- **Tools missing after connecting:** restart the client or reload its MCP servers.

_Guides reviewed 2026-11-16._
