# HowdyGo MCP Server

> Connect HowdyGo to your AI assistant to find and duplicate demos, edit captured page text, hide or blur elements, and get share links and embed codes.

The HowdyGo MCP server connects your HowdyGo account to Claude, ChatGPT, and
other AI assistants that support the Model Context Protocol (MCP). Once it's
connected, ask your assistant to find a demo in your library or paste its link
into the chat. It can duplicate demos, write step text, edit captured page
content, set up chapters and the end-of-demo CTA, play the demo inline, and
give you a share link or embed code.

The assistant uses the same tools and writing guidelines as [Howdy AI](https://docs.howdygo.com/ai) in
the editor. It reads each step's page, the element that was clicked, and a
screenshot, so it writes about what your product actually does instead of
guessing from the demo's title.

The server URL is:

```
https://app.howdygo.com/api/mcp
```

## Connecting your assistant

When you connect, your assistant sends you to HowdyGo to sign in (or start a
free trial). After signing in, you'll return to your assistant.

The assistant acts as you. It can open only the demos you can open in HowdyGo,
and it can only change demos your [team role](https://docs.howdygo.com/security/team-roles) lets you
edit.

### Claude

Add HowdyGo as a custom connector. It then works in Claude on the web, Claude
Desktop, and Claude in Chrome.

1. Go to **Customize > Connectors**, click **+ Add**, then
   **Add custom connector**.
2. Name it **HowdyGo**, paste the server URL, and click **Continue**.
3. Keep the default sign-in settings and click **Add**.
4. Click **Connect** and sign in to HowdyGo.

On Claude Team and Enterprise plans, an owner adds the connector first from
**Organization settings > Connectors**. Members then find the HowdyGo custom
connector under **Customize > Connectors** and click **Connect**. See Claude's guide to
[custom connectors](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp)
for more detail.

### ChatGPT

Add HowdyGo as a custom MCP server:

1. Go to [chatgpt.com/plugins](https://chatgpt.com/plugins), click **+**, and
   choose **Add custom MCP server**.
2. Name it **HowdyGo**, paste the server URL, and choose **OAuth** for
   authentication.
3. Accept the warning and create the plugin.
4. In a new chat, type `@` and pick **HowdyGo**. Sign in when asked.

> [!WARNING]
> When ChatGPT asks you to sign in to HowdyGo, use **Google** or **Microsoft**.
> A magic link opened from your email doesn't complete the connection in ChatGPT.

### Claude Code

Add the server from your terminal:

```bash
claude mcp add --transport http howdygo https://app.howdygo.com/api/mcp
```

Then run `/mcp` inside Claude Code to sign in.

### Other MCP clients

Any client that supports remote MCP servers over HTTP with OAuth sign-in can
connect. Add the server URL as a remote (HTTP) server and sign in when prompted.

## Finding a demo

Ask your assistant to find a demo by name, folder, or what it explains. For
example:

- "Find my demos about invoicing and show me the matching steps."
- "Find our onboarding demo and give me its embed code."
- "Show me the sandboxes in the Sales folder."

Search covers the interactive demos and sandboxes you can access. It matches
titles, folder names, and written step content, including headings and overlay
text. When step content matches, the result includes the matching step's number
and a text excerpt. Collections are not included in library search.

## Working on a demo

Once you've found a demo, tell your assistant what you want to change. You can
also start by pasting a demo's editor, share, or embed link. For example:

- "Set up this demo: https://app.howdygo.com/edit/…"
- "Rewrite step 4 to focus on how much time this saves."
- "Make the CTA ask people to book a call with our sales team."
- "Turn on autoplay for this demo."

Asking the assistant to "set up", "annotate", or "write" a demo covers the full
setup in one pass:

- Step text for every step
- [Auto-progress](https://docs.howdygo.com/create/auto-progress) on transitional steps, such as
  navigation clicks
- [Chapters](https://docs.howdygo.com/create/checklist) for longer demos
- A descriptive title, if the demo still has a default one
- The end-of-demo CTA and its [background](https://docs.howdygo.com/create/change-cta-background)
- Whether to turn on autoplay

If you ask about a single step, it changes only that step.

Most assistants ask you to approve each change before it runs. Approved changes
apply to the live demo straight away, just like edits made in the editor, and
each one is saved in the demo's [version history](https://docs.howdygo.com/create/version-history).
When it's finished, the assistant gives you the demo's editor link so you can
review the changes.

### What the assistant can change

- Step headings and text
- Button and opt-in labels on [overlays](https://docs.howdygo.com/create/overlays)
- Auto-progress on individual steps
- Chapters
- The demo title
- The end-of-demo CTA and its background
- Autoplay and its speed
- Whether the demo is published
- Text on captured pages
- Whether captured elements are hidden or blurred

Some changes still need the [editor](https://docs.howdygo.com/create/editing-steps): adding, removing,
or reordering steps, moving hotspots, zoom, and media. The assistant sends you
the editor link when you ask for one of these.

### Editing captured page content

Ask your assistant to replace text in the captured interface, such as customer
names, company names, or UI labels. It can also hide or blur elements and
restore elements previously hidden or blurred. For example:

- "Replace Acme with Globex throughout this demo."
- "Blur the customer email addresses on step 3."
- "Restore the revenue card I hid on step 5."

Name the steps or screens you want to change. Some steps share a captured page,
so a page edit can affect more than one step. The assistant reports which steps
changed; open the demo to check the result. If you want to keep the original
content, [duplicate the demo](#duplicating-a-demo) first.

## Duplicating a demo

Ask your assistant to make a copy of an interactive demo or sandbox. For example:

```text
Duplicate this demo so I can personalize a copy for Globex.
```

The copy has "(Copy)" added to its title and keeps the original's content. Your
assistant returns the copy's editor link and can continue editing the copy when
you ask it to. Duplication follows the same [team permissions](https://docs.howdygo.com/security/team-roles)
as the **Duplicate** action in HowdyGo.

## Playing and sharing demos

Ask your assistant to show you a demo and it plays inline in the chat, where you
can click through it. Only published demos can play this way. Sandboxes show a
card that opens them full size.

Your assistant can also get a demo's [share link](https://docs.howdygo.com/distribute/sharing-link) or
[embed code](https://docs.howdygo.com/distribute/embedding), the same ones you'd copy in HowdyGo. Both
use your [custom domain](https://docs.howdygo.com/integrations/custom-domains) if
you've set one up. Sandboxes don't have embed code, so you'll get their share
link instead.

## Recording a new demo

If your assistant can control your browser, such as Claude in Chrome, it can
record a new demo for you with the
[HowdyGo Chrome extension](https://docs.howdygo.com/create/capturing-a-demo). Make sure the extension is
installed and signed in to HowdyGo in the same browser, then describe the flow:

- "Record a demo of creating a new project on app.example.com, then set it up."

The assistant starts the recording, clicks through the flow, stops it, and
waits for the upload to finish. It then sets up the new demo and gives you its
editor and share links. If the extension can't be started from the page, the
assistant asks you to start recording from the HowdyGo extension's toolbar
button, then carries on from there.

## AI usage

The HowdyGo MCP server doesn't count toward your organization's
[AI usage](https://docs.howdygo.com/ai/usage). The writing is done by your own AI assistant, so your
assistant's plan and limits apply instead.
