# Connect an AI agent

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

The Model Context Protocol (MCP) connects AI agents such as Claude Code, Cursor or Codex to sitebrunch. Your agent then works directly with the data of your projects.

## 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/
```

## OpenAI Codex

Add this entry to the file ~/.codex/config.toml:

```
[mcp_servers.sitebrunch]
url = "https://mcp.sitebrunch.com/"
```

Then start the sign-in:

```bash
codex mcp login sitebrunch
```

## Cursor, Windsurf, Claude Desktop and GitHub Copilot

Add a server with the address **https://mcp.sitebrunch.com/** in the MCP settings of your agent. In Claude Desktop you do this under “Customize” and “Connectors”. 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.

After that, your AI agent can fix audit findings, read the results of the automated check and work on comments.

---

- Previous article: [AI agent (MCP)](https://www.sitebrunch.com/en/help-center/accessibility/ai-agent.md)
- Next article: [Fix audit findings with an AI agent](https://www.sitebrunch.com/en/help-center/accessibility/ai-agent/fix-audit-findings-with-an-ai-agent.md)

## Help Center: contents

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