AI helpers

Connect Codex, ChatGPT, Claude, or Cursor to StageHand with a personal key.

Connect an AI helper

Use an AI assistant (Cursor, Codex, ChatGPT, Claude, and similar) to help set up StageHand — indexes, lore panels, Flow Builder, and more — on Discord servers where you have Manage Server.

You do not need to install Node.js, host a server, or use staff credentials. StageHand runs a hosted helper at https://mcp.stagehand.quest/mcp; your Discord login (or a personal key) unlocks it.

This helper configures StageHand. It does not run general Discord actions (kick, create channels, etc.). See What the AI helper can (and can’t) do.

1. Open AI helpers

  1. Sign in at stagehand.quest with Discord.
  2. Open Dashboard → Me.
  3. Under AI helpers, optionally pick a default server.

2. Connect your AI app

Cursor (recommended — sign in)

  1. Click Add to Cursor (or install StageHand from the Cursor Marketplace when listed).
  2. Confirm the install prompt in Cursor.
  3. Click Authenticate next to StageHand (if shown).
  4. Sign in on stagehand.quest with Discord and click Allow.

No key paste. A key named like MCP · … may appear under AI helpers so you can revoke access later.

Codex / apps that need a key

  1. Click Create key (shown once, starts with sh_).
  2. Click Copy Codex config and paste into %USERPROFILE%\.codex\config.toml (Windows) or ~/.codex/config.toml (Mac/Linux), then start a new Codex chat.
  3. Or Copy MCP JSON and merge it into that app’s MCP settings.

Claude / ChatGPT / Codex (OAuth)

  1. Prefer the StageHand listing in Claude Connectors or the ChatGPT / Codex plugin directory when available.
  2. Or add the hosted URL https://mcp.stagehand.quest/mcp as a custom MCP / connector (or use Copy OAuth MCP JSON).
  3. Complete Authenticate / sign-in when the app prompts you — same Discord consent page as Cursor.
  4. Fallback: create a key and set Authorization: Bearer sh_… if the app only supports headers.

You should not need to install Node or run npx for these paths.

3. Check that it works

Ask your helper:

Run stagehand_auth_check

You want a successful / “ok” result. Then try something concrete, for example:

Make a forum index for the Characters forum on my server

What you can ask for

Examples once connected:

  • “Make a forum index for the Characters forum”
  • “Build a Flow that runs when someone joins”
  • “Draft a lore panel for our rules channel”

Full list of capabilities and hard limits: What the AI helper can (and can’t) do.

Advanced: run the helper on your computer

Only if you want offline / custom builds: install Node.js 18+ (LTS), then point your app at npx -y mcp-stagehand with env STAGEHAND_API_KEY=sh_…. Details are in the mcp-stagehand package. Most people should use the hosted buttons above instead.

Safety

  • Only connect helpers you trust.
  • Revoke keys (including MCP OAuth keys) you no longer use on Dashboard → Me.
  • The helper cannot manage servers where you don’t have Manage Server.

Help

Stuck? Ask in the support server or see other guides from the docs hub.