Use Bugmole from your AI assistant

Connect Bugmole to the AI assistant you already use. You can then ask it to explore your app, write a test, run it, and explain what failed, all in the conversation.

The assistant signs in as you. It can only see and change the projects you can, with your role in each workspace.

Connect

Use this server URL everywhere:

https://api.bugmole.com/mcp

When you connect, a Bugmole sign-in page opens. It asks you to Allow the assistant; after that you sign in as usual (password, passkey or your company's SSO). The assistant stays connected until you remove it.

ChatGPT

Turn on developer mode. It's in Settings, under the advanced settings for apps and connectors.
Create an app, give it the server URL above, and choose OAuth for sign-in.
Start a chat, enable the Bugmole app, and ask it to test something.

Claude (claude.ai and Claude Desktop)

Open Settings → Connectors → Add custom connector, and paste the server URL above.
Click Connect, then allow access and sign in.
Add the Bugmole skill (below) so Claude follows Bugmole's workflow.

Claude Code

claude mcp add --transport http bugmole https://api.bugmole.com/mcp

Run /mcp in Claude Code to sign in. To use Bugmole on your own machine instead, run bugmole serve in your project and see Bugmole MCP.

Cursor

Add this to .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "bugmole": { "url": "https://api.bugmole.com/mcp" }
  }
}

Open Cursor Settings → MCP, and Cursor opens the same sign-in page the first time it needs to.

Codex CLI

Add this to ~/.codex/config.toml (global) or .codex/config.toml (project):

[mcp_servers.bugmole]
url = "https://api.bugmole.com/mcp"

Codex opens the sign-in page the first time it calls a Bugmole tool in a session.

The Bugmole skill

The skill teaches Claude how to test with Bugmole, in this order:

Explore the app;
plan a flow;
run it;
report what passed, what failed and why.

It works with both the hosted connector and bugmole serve.

Download the Bugmole skill.
Add it to Claude:
- claude.ai and Claude Desktop: upload the zip under Settings → Capabilities → Skills.
- Claude Code: unzip it into ~/.claude/skills/, which creates ~/.claude/skills/bugmole/SKILL.md.

ChatGPT doesn't use skills. The connector gives ChatGPT the same workflow when it connects.

What the assistant can do

Tool	What it does
`list_projects`	Your projects and their environments
`explore_app` / `get_exploration`	Explore a site from its URL and save a test plan for each flow found
`list_journeys`	The user journeys Bugmole knows
`list_test_plans` / `get_test_plan`	Read existing plans and their flows
`save_test_plan`	Check a flow and save it as a plan, for projects whose files Bugmole stores
`run_tests`	Run a plan on Bugmole Cloud or your own workers, in one or more browsers
`get_run` / `list_runs`	Status, the step that failed, and Bugmole's diagnosis

The assistant can't delete projects, manage members, change billing, or read secrets.

A flow never contains real passwords. Flows use {{secret.NAME}}, and your worker fills in the value; see Sample tests.

What it costs

Your assistant's own work doesn't use Bugmole AI credits: reading the app, and writing and fixing flows.
Cloud runs and explorations use your workspace's cloud minutes, the same as starting them from the dashboard.
Failure explanations from Bugmole on cloud runs use AI credits as usual.
Runs on your own workers are free.

See Plans and limits.

Disconnect

Remove the connector in your assistant's settings. A workspace admin who removes you from the workspace also removes the assistant's access to it.