Integration · Developer tools

Connect Claude & ChatGPT to BugBug

Ask your AI which BugBug tests failed last night, or have it start a suite run against your staging URL. It can read test runs step by step with errors and screenshots, list suites and run profiles, and create or update tests and suites. You get answers about your test results without opening the dashboard.

Connect BugBug free

Free plan, no credit card. Takes about a minute.

Try asking

“Which tests failed in the last suite run?”
The AI lists recent suite runs, opens the latest one and shows each test's result, with the failed ones first.
“Run the Checkout suite against https://staging.example.com.”
It finds the suite, starts a cloud run with that base URL and reports the status when you ask.
“Why did the Login test fail?”
It reads the test run with its step results and errors, and lists the screenshots captured during the run.

What your AI can do

Run tests and suites

Start cloud runs of single tests or whole suites, with a run profile, base URL and variables, and stop them if needed.

Results and screenshots

Read test and suite runs with step results, errors and captured screenshots, filtered by status or date.

Tests and suites

Search tests and suites, browse folders, run profiles and variables, and create or update tests and suites.

“Show me every test in the Payments folder with its last result.”
It finds the folder and searches its tests with the latest run result included.
“Create a suite called Smoke with the Login and Signup tests.”
It looks up the run profiles and the two tests, then creates the suite with the profile you choose.
“Stop the suite run that is still going.”
It finds the running suite run and stops it.

79 tools for BugBug

These tools are switched on when you connect. You can switch any of them off, or require your approval before it runs.

create_componentChanges dataCreate a new component. Search components first to avoid duplicates. API summary: Creating a component.
create_folderChanges dataCreate a new folder. Required: name or kind. Search folders first to avoid duplicates. API summary: Create a folder.
create_groupChanges dataCreate a new group. Required: test id. Search groups first to avoid duplicates. API summary: Creating a group.
create_projectChanges dataCreate a new project. Required: file. Search projects first to avoid duplicates. API summary: Check whether a project ZIP is importable (stateless).
create_project_v2_tests_import_check_createChanges dataCreate a new project. Required: file. Search projects first to avoid duplicates. API summary: Check whether a test YAML or ZIP is importable (stateless).
create_reference_screenshotChanges dataCreate a new reference screenshot. Required: step id or screenshot. API summary: Create visual regression reference screenshot.
create_resolveChanges dataCreate a new resolve. Required: type. API summary: Resolve visual regression review.
create_stepChanges dataCreate a new step. API summary: Creating a step.
create_suiteChanges dataCreate a test suite with a `name`, a `run_profile_id` and the `tests` it should include.
create_testChanges dataCreate a new, empty test with a `name`, optional notes and folder.
create_test_componentChanges dataCreate a new test. Search tests first to avoid duplicates. API summary: Insert a component into a test by test ID.
create_variableChanges dataCreate a new variable. Required: key or type. API summary: Create variable.
delete_folderDeletesPermanently delete a folder by folder id. Destructive action; may require approval. API summary: Delete folder.
delete_groupDeletesPermanently delete a group by group id. Destructive action; may require approval. API summary: Removing a group.
delete_reference_screenshotDeletesPermanently delete a reference screenshot by reference screenshot id. Destructive action; may require approval. API summary: Delete visual regression reference screenshot.
delete_stepDeletesPermanently delete a step by step id. Destructive action; may require approval. API summary: Removing a step.
delete_testDeletesPermanently delete a test by test id. Destructive action; may require approval. API summary: Retrieve a test by its ID and remove it.
delete_unitDeletesPermanently delete a unit by unit id. Destructive action; may require approval. API summary: Removing a suite.
detach_test_componentChanges dataUnlink a test (test id). API summary: Unlink a component from a test by test ID.
download_junit_xml_reportList junits. API summary: Download JUnit XML report.
download_projectDownload the document for a project. API summary: Download project backup.
export_projectsExport projects. API summary: Export project as ZIP.
get_config_statusGet the current status of a config. API summary: API status probe.
get_folderGet one folder by folder id. API summary: Get folder by ID.
get_groupGet one group by group id. API summary: Retrieving group by ID.
get_profileGet one profile by profile id. API summary: Retrieving profile by ID.
get_reference_screenshotGet one reference screenshot by reference screenshot id. API summary: Retrieve visual regression reference screenshot.
get_stepGet one step by step id. API summary: Retrieving step by ID.
get_steprunGet one steprun by steprun id. API summary: Retrieve step run details.
get_suiteGet one suite by `unit_id`, including its tests and settings.
get_suite_runGet full details of a suite run by `suiterun_id`, including the result of each test.
get_suite_run_statusGet the current status of a suite run by `suiterun_id`.
get_testGet one test by `test_id`, including its steps and settings.
get_test_exportGet one export for a test by fmt. API summary: Export test as YAML or ZIP.
get_test_runGet full details of a test run by `testrun_id`, including step results and errors.
get_test_run_statusGet the current status of a test run by `testrun_id` (running, passed, failed).
get_testrun_debug_artifactGet one debug artifact for a testrun by artifact type. API summary: Retrieve test run debug artifact by kind.
get_variableGet one variable by variable key. API summary: Retrieve variable.
list_component_usagesList usages for a component. API summary: Retrieving component usage.
list_foldersList test or suite folders, filtered by `kind`, name `query` or parent folder.
list_ipsList ips. API summary: IP addresses list.
list_junitsList junits. API summary: Download report.
list_projectsList the BugBug projects the token can see, optionally filtered by name with `query`.
list_projects_2List projects for a project. API summary: List project backups.
list_projects_v2_projects_settings_listList projects. API summary: Retrieving project settings.
list_projects_v2_projects_settings_list_2List projects for a project. API summary: Retrieving project settings.
list_projects_v2_settings_listList projects. API summary: Retrieving project settings.
list_reference_screenshotsList reference screenshots. Optional filters: step id. Results are paginated. API summary: List visual regression reference screenshots.
list_run_profilesList the project's run profiles. Use a profile id as `run_profile_id` when running tests or suites.
list_suite_runsList suite runs, filtered by `suite_id`, `status` or start date range.
list_suiterun_debug_artifactsList debug artifacts for a suiterun. API summary: List suite run debug artifacts.
list_suiterun_screenshotsList screenshots for a suiterun. API summary: Get suite run steps screenshots.
list_suitesList test suites, optionally filtered by name with `query`. Set `latest_run` to include each suite's last run.
list_test_run_screenshotsList the screenshots captured during a test run by `testrun_id`.
list_test_runsList test runs, filtered by `test_id`, `status` or start date range.
list_testrun_debug_artifactsList debug artifacts for a testrun. API summary: List test run debug artifacts.
list_testrun_logsList logs for a testrun. API summary: Download test run logs.
list_v1sList v1s. API summary: Get YAML JSON Schema.
list_variablesList the project's variables that tests can use.
run_project_import_from_a_previously_validated_uploadChanges dataCreate a new project. Required: upload id. Search projects first to avoid duplicates. API summary: Run project import from a previously validated upload.
run_suiteChanges dataStart a cloud run of a whole suite by `suite_id`; optional `base_url`, `run_profile_id` and variables. Check progress with get_suite_run_status.
run_testChanges dataStart a cloud run of one test by `test_id`; optional `run_profile_id` and variables. Check progress with get_test_run_status.
search_companiesSearch companies by ordering or query. Use this to find existing companies before creating a new company. Results are paginated. API summary: Retrieving organizations list.
search_componentsSearch components by folder id, no folder, ordering or query. Use this to find existing components before creating a new component. Results are paginated. API summary: Retrieving components list.
search_groupsSearch groups by folder, folder id, no folder, ordering or query. Use this to find existing groups before creating a new group. Results are paginated. API summary: Retrieving groups list.
search_testsSearch tests by name (`query`) or folder. Set `latest_run` to include each test's last run result.
search_treesSearch trees by kind, ordering, parent id or query. Use this to find existing trees before creating a new tree. Results are paginated. API summary: Get folder tree.
stop_suite_runChanges dataStop a running suite run by `suiterun_id`.
stop_test_runChanges dataStop a running test run by `testrun_id`.
submit_projectVisible to othersValidate a project. Has effects visible outside this system. API summary: Validate project ZIP and prepare upload.
update_folderChanges dataUpdate an existing folder identified by folder id. Only the fields you pass are changed. API summary: Update folder (rename or move).
update_groupChanges dataUpdate an existing group identified by group id. Only the fields you pass are changed. API summary: Partially updating a group.
update_reference_screenshotChanges dataUpdate an existing reference screenshot identified by reference screenshot id. Only the fields you pass are changed. API summary: Update visual regression reference screenshot.
update_stepChanges dataUpdate an existing step identified by step id. Only the fields you pass are changed. API summary: Partially updating a step.
update_suiteChanges dataChange a suite's name, notes, tests or run settings by `unit_id`.
update_testChanges dataRename a test or change its notes, folder or screen size by `test_id`.
update_test_step_positionChanges dataUpdate an existing test identified by test id. API summary: Move a step to a different position or group.
update_variableChanges dataUpdate an existing variable identified by variable key. Only the fields you pass are changed. API summary: Partially update variable.
upload_testChanges dataImport a test. API summary: Import test from YAML or ZIP.

Set up in three steps

1
Pick the app
Create a free HeyMyApps account and choose BugBug from the app list.
2
Paste your key
Paste your BugBug project API token. In BugBug, open the Integrations page, choose the API tab and copy the project API token. The token belongs to one project, and BugBug's Public API needs a paid BugBug plan.
3
Add the link to your AI
You get a personal MCP link. Add it to Claude, ChatGPT or Cursor:
1. Click your name, then Settings › Connectors › Add custom connector.
2. Paste your link as the Remote MCP server URL.
3. Switch it on from the + menu in a chat.

Questions

What can the AI do in BugBug?

It can read projects, tests, suites, folders, run profiles, variables, test runs, suite runs and run screenshots. It can start and stop test and suite runs in the cloud, create empty tests and new suites, and update the name, notes, folder or settings of tests and suites.

Does the AI see my BugBug API token?

No. Your BugBug token is encrypted at rest and never shown to the AI. After you save it, it is not shown again, not even to you. The AI only sees the results of the tools it calls.

Can I control what the AI is allowed to do?

Yes. You choose which tools are switched on, so you can start with results only. Starting or stopping runs and changing tests or suites can require your approval before they run. Every tool call is logged.

Does it work with ChatGPT?

Yes. In ChatGPT go to Settings › Apps & Connectors › Advanced and turn on Developer mode, then add your HeyMyApps link. Developer mode needs a paid ChatGPT plan: Plus, Pro, Business or Enterprise. The same link also works in Claude (Settings › Connectors › Add custom connector), Cursor and other MCP clients.

What does it cost?

HeyMyApps has a free plan with no credit card required. Paid plans bill per completed task. You also need your own BugBug account, and BugBug's Public API needs a paid BugBug plan.

Can the AI record test steps?

No. The AI can create a new, empty test with a name, notes and folder, and change a test's settings. Steps are recorded in BugBug itself. The AI can read a test's existing steps and run it.