# Quick start

Use this checklist to confirm the extension is installed, connected to a model provider, and ready to analyse HTTP traffic.

## Before you start

Make sure you have:

* Burp Suite Professional 2026.4 or later.
* The jar file.
* Your licence details.
* Either a cloud provider API key or a local/self-hosted provider endpoint.

## 1. Load the extension

1. Open Burp Suite Professional.
2. Go to `Extensions`.
3. Click `Add`.
4. Select the jar file.
5. Confirm that the `BurpGPT Pro` menu appears.

For the full installation guide, see [Installation](/getting-started/installation.md).

## 2. Activate your licence

Open `BurpGPT Pro -> Licence`, then activate your licence with the key from your purchase email.

After activation, the `BurpGPT Pro` tab, scan action, and `AI Chat` editor are available in Burp Suite.

For the full activation guide, see [Activate your licence](/getting-started/activate-your-licence.md).

## 3. Configure a model provider

Go to `Provider settings`, then choose one provider path:

* For hosted APIs, see [Use supported cloud-based model providers](/how-to/use-supported-cloud-based-model-providers.md).
* For Ollama or self-hosted endpoints, see [Use supported local model providers](/how-to/use-supported-local-model-providers.md).

Enter the provider, base URL, API key if required, model name, timeout, and request parameters.

## 4. Test the provider

Click `Test request` before scanning or chatting.

If the test fails, check Burp's `Logger` tab for the provider request and response. See [Test and validate model provider settings](/how-to/test-and-validate-model-provider-settings.md) for details.

## 5. Analyse traffic

Choose the workflow that matches your task:

* Use `AI scanner` for active scan checks.
* Right-click a request and select `Extensions -> BurpGPT Pro -> Scan with AI (results in Target -> Site map)` for targeted manual analysis.
* Open the `AI Chat` editor tab to ask follow-up questions about selected traffic.

See [Analyse HTTP traffic](/how-to/analyse-http-traffic.md) and [Use AI Chat](/how-to/use-ai-chat.md) for the full workflows.

## 6. Review the output

For scan-based workflows, the extension creates `Information`-level issues named *GPT-generated insights*.

For chat workflows, responses appear in the `AI Chat` editor history.

Always manually validate AI-generated results before relying on them in a security report.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.burpgpt.app/getting-started/quick-start.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.