# Connect your own AI agent

> How to connect Claude Code, Codex, Cursor, Windsurf, GitHub Copilot and other AI agents to sitebrunch.

sitebrunch is an MCP server. MCP (Model Context Protocol) is an open standard that lets AI agents reach other services. This is how you connect any agent that supports MCP servers over HTTP, including the one in your code editor.

## Requirements

- You have a sitebrunch account and access to at least one project.

- You use an AI agent that supports MCP servers over HTTP.

## The configuration in the dashboard

In the **“Account Settings”** you find the section **“AI Agent Connection”**. Copy the configuration for your agent there. The server address is always the same:

```
https://mcp.sitebrunch.com/
```

## Claude Code

Run this command in your terminal:

```bash
claude mcp add --transport http sitebrunch https://mcp.sitebrunch.com/
```

If you already connected sitebrunch in Claude and sign in to Claude Code with the same Claude account, sitebrunch is already there.

## OpenAI Codex

Run this command in your terminal:

```bash
codex mcp add sitebrunch --url https://mcp.sitebrunch.com/
```

## Cursor, Windsurf and GitHub Copilot

Add a server with the address **https://mcp.sitebrunch.com/** in the MCP settings of your agent. The ready-made configuration to copy is in your account settings. In GitHub Copilot the tools only work in agent mode.

## Sign in and choose the access

The first time your agent uses sitebrunch, your browser opens. You sign in with your sitebrunch account and choose what the agent may do:

- **“Read only”**: The agent sees projects, test results, comments and statistics. It changes nothing.

- **“Read and write”**: The agent can also document fixes, start scans, reply to comments and mark them as done.

The access applies to all projects you have access to. After that, the connection stays in place. To change the access, connect the agent again and pick the other option.

> **Tip:** First tell your agent which project to work with, for example: “Work with the sitebrunch project for my website.” It then selects the project itself.

## For an audit: agent-browser

If your agent should test your website for WCAG, it needs a browser and subagents. Claude Code and Codex can do both. Install agent-browser once so up to 3 subagents test at the same time:

```bash
npm install -g agent-browser && agent-browser install
```

The full setup with the start prompt is in [Test with an AI agent](/en/help-center/ai-agent/accessibility/test-with-an-ai-agent).

## End the connection

To end the connection, remove sitebrunch in the MCP settings of your agent. In Claude Code run:

```bash
claude mcp remove sitebrunch
```

To disconnect every agent at once, open **“Account Settings”**, go to **“AI Agent Connection”** and click **“Disconnect all agents”**. The agents lose access within a minute.

## What sitebrunch stores

sitebrunch only stores what your agent writes through the connection: findings, replies to comments, notes on fixes and chart notes. Your conversation with the agent stays with your agent.

If something does not work, read [Solve problems with the AI agent](/en/help-center/ai-agent/set-up/solve-problems-with-the-ai-agent).

---

- Previous article: [Connect to ChatGPT](https://staging.frontend.sitebrunch.de/en/help-center/ai-agent/set-up/connect-to-chatgpt.md)
- Next article: [Example prompts](https://staging.frontend.sitebrunch.de/en/help-center/ai-agent/set-up/example-prompts.md)

## Help Center: contents

- [Accessibility](https://staging.frontend.sitebrunch.de/en/help-center/accessibility.md)
  - [Getting started](https://staging.frontend.sitebrunch.de/en/help-center/accessibility/getting-started.md)
    - [Create a project](https://staging.frontend.sitebrunch.de/en/help-center/accessibility/getting-started/create-a-project.md)
    - [Set up WCAG monitoring](https://staging.frontend.sitebrunch.de/en/help-center/accessibility/getting-started/set-up-wcag-monitoring.md)
    - [Check a PDF](https://staging.frontend.sitebrunch.de/en/help-center/accessibility/getting-started/check-a-pdf.md)
  - [WCAG monitoring](https://staging.frontend.sitebrunch.de/en/help-center/accessibility/wcag-monitoring.md)
    - [The monitoring overview](https://staging.frontend.sitebrunch.de/en/help-center/accessibility/wcag-monitoring/the-monitoring-overview.md)
    - [Add pages to monitoring](https://staging.frontend.sitebrunch.de/en/help-center/accessibility/wcag-monitoring/add-pages-to-monitoring.md)
    - [Email notifications](https://staging.frontend.sitebrunch.de/en/help-center/accessibility/wcag-monitoring/email-notifications.md)
    - [What the automated check tests](https://staging.frontend.sitebrunch.de/en/help-center/accessibility/wcag-monitoring/what-the-automated-check-tests.md)
  - [Audits](https://staging.frontend.sitebrunch.de/en/help-center/accessibility/audits.md)
    - [Create an audit](https://staging.frontend.sitebrunch.de/en/help-center/accessibility/audits/create-an-audit.md)
    - [Complete a testing step](https://staging.frontend.sitebrunch.de/en/help-center/accessibility/audits/complete-a-test-step.md)
    - [The audit report](https://staging.frontend.sitebrunch.de/en/help-center/accessibility/audits/the-audit-report.md)
    - [Create a re-audit](https://staging.frontend.sitebrunch.de/en/help-center/accessibility/audits/create-a-re-audit.md)
- [User Experience](https://staging.frontend.sitebrunch.de/en/help-center/user-experience.md)
  - [Getting started](https://staging.frontend.sitebrunch.de/en/help-center/user-experience/getting-started.md)
    - [Set up a project](https://staging.frontend.sitebrunch.de/en/help-center/user-experience/getting-started/set-up-a-project.md)
    - [Install the snippet](https://staging.frontend.sitebrunch.de/en/help-center/user-experience/getting-started/install-the-snippet.md)
    - [From install to first visit](https://staging.frontend.sitebrunch.de/en/help-center/user-experience/getting-started/from-install-to-first-visit.md)
    - [Read the weekly overview](https://staging.frontend.sitebrunch.de/en/help-center/user-experience/getting-started/read-the-weekly-overview.md)
  - [Metrics](https://staging.frontend.sitebrunch.de/en/help-center/user-experience/metrics.md)
    - [The Metrics overview](https://staging.frontend.sitebrunch.de/en/help-center/user-experience/metrics/the-metrics-overview.md)
    - [Filter and compare](https://staging.frontend.sitebrunch.de/en/help-center/user-experience/metrics/filter-and-compare.md)
    - [Pages and sections](https://staging.frontend.sitebrunch.de/en/help-center/user-experience/metrics/pages-and-sections.md)
    - [Analyze campaigns](https://staging.frontend.sitebrunch.de/en/help-center/user-experience/metrics/analyze-campaigns.md)
  - [Conversions](https://staging.frontend.sitebrunch.de/en/help-center/user-experience/conversions.md)
    - [Set up events and goals](https://staging.frontend.sitebrunch.de/en/help-center/user-experience/conversions/set-up-events-and-goals.md)
    - [The Conversions overview](https://staging.frontend.sitebrunch.de/en/help-center/user-experience/conversions/the-conversions-overview.md)
    - [Analyze interactions](https://staging.frontend.sitebrunch.de/en/help-center/user-experience/conversions/analyze-interactions.md)
    - [Create a funnel](https://staging.frontend.sitebrunch.de/en/help-center/user-experience/conversions/create-a-funnel.md)
  - [Journeys](https://staging.frontend.sitebrunch.de/en/help-center/user-experience/journeys.md)
    - [Journeys at a glance](https://staging.frontend.sitebrunch.de/en/help-center/user-experience/journeys/journeys-at-a-glance.md)
    - [See where visits go](https://staging.frontend.sitebrunch.de/en/help-center/user-experience/journeys/see-where-visits-go.md)
    - [Create a route](https://staging.frontend.sitebrunch.de/en/help-center/user-experience/journeys/create-a-route.md)
    - [Read backwards from a goal](https://staging.frontend.sitebrunch.de/en/help-center/user-experience/journeys/read-backwards-from-a-goal.md)
  - [Live Heatmaps](https://staging.frontend.sitebrunch.de/en/help-center/user-experience/live-heatmaps.md)
    - [Live Heatmaps at a glance](https://staging.frontend.sitebrunch.de/en/help-center/user-experience/live-heatmaps/live-heatmaps-at-a-glance.md)
    - [Read clicks](https://staging.frontend.sitebrunch.de/en/help-center/user-experience/live-heatmaps/read-clicks.md)
    - [Scroll depth and devices](https://staging.frontend.sitebrunch.de/en/help-center/user-experience/live-heatmaps/scroll-depth-and-devices.md)
    - [Filter by source and goal](https://staging.frontend.sitebrunch.de/en/help-center/user-experience/live-heatmaps/filter-by-source-and-goal.md)
- [AI agent (MCP)](https://staging.frontend.sitebrunch.de/en/help-center/ai-agent.md)
  - [Set up](https://staging.frontend.sitebrunch.de/en/help-center/ai-agent/set-up.md)
    - [Connect to Claude](https://staging.frontend.sitebrunch.de/en/help-center/ai-agent/set-up/connect-to-claude.md)
    - [Connect to ChatGPT](https://staging.frontend.sitebrunch.de/en/help-center/ai-agent/set-up/connect-to-chatgpt.md)
    - [Connect your own AI agent](https://staging.frontend.sitebrunch.de/en/help-center/ai-agent/set-up/connect-your-own-ai-agent.md) (this article)
    - [Example prompts](https://staging.frontend.sitebrunch.de/en/help-center/ai-agent/set-up/example-prompts.md)
    - [Solve problems with the AI agent](https://staging.frontend.sitebrunch.de/en/help-center/ai-agent/set-up/solve-problems-with-the-ai-agent.md)
  - [Accessibility](https://staging.frontend.sitebrunch.de/en/help-center/ai-agent/accessibility.md)
    - [Fix audit findings with an AI agent](https://staging.frontend.sitebrunch.de/en/help-center/ai-agent/accessibility/fix-audit-findings-with-an-ai-agent.md)
    - [Read the results of the automated check](https://staging.frontend.sitebrunch.de/en/help-center/ai-agent/accessibility/read-the-results-of-the-automated-check.md)
    - [Test with an AI agent](https://staging.frontend.sitebrunch.de/en/help-center/ai-agent/accessibility/test-with-an-ai-agent.md)
    - [Work on comments with an AI agent](https://staging.frontend.sitebrunch.de/en/help-center/ai-agent/accessibility/work-on-comments-with-an-ai-agent.md)
    - [Start scans and query results](https://staging.frontend.sitebrunch.de/en/help-center/ai-agent/accessibility/start-scans-and-query-results.md)
  - [User Experience](https://staging.frontend.sitebrunch.de/en/help-center/ai-agent/user-experience.md)
    - [Query analytics and conversions](https://staging.frontend.sitebrunch.de/en/help-center/ai-agent/user-experience/query-analytics-and-conversions.md)
    - [Add notes to the charts](https://staging.frontend.sitebrunch.de/en/help-center/ai-agent/user-experience/add-notes-to-the-charts.md)
