> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aurora.build/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Integrations

> Use Aurora from Claude, Claude Code, Cursor, Windsurf, and any MCP-compatible tool

Aurora works as a **Model Context Protocol (MCP)** server, which means you can build and deploy projects directly from your favorite AI tools without ever opening the Aurora website.

## What you can do via MCP

From any connected tool, you can:

* Create new projects from a prompt
* List and open existing projects
* Read, write, and edit project files
* Deploy to production
* Check deployment status

All through natural conversation with your AI assistant.

## Supported tools

<CardGroup cols={2}>
  <Card title="Claude" icon="message-bot">
    Anthropic's AI assistant on claude.ai — add Aurora as a connected integration.
  </Card>

  <Card title="Claude Code" icon="terminal">
    Anthropic's CLI tool for developers — connect Aurora as an MCP server.
  </Card>

  <Card title="Cursor" icon="arrow-pointer">
    AI-native code editor — add Aurora to your MCP server configuration.
  </Card>

  <Card title="Windsurf" icon="water">
    Codeium's AI editor — connect via MCP settings.
  </Card>
</CardGroup>

## Setup

Aurora uses **OAuth discovery**, so setup is the same across all platforms — just provide the server URL and authorize when prompted.

### Aurora MCP server URL

```
https://mcp.aurora.build/mcp
```

<Note>
  You'll need an Aurora account. If you don't have one yet, you'll be prompted to sign up during the OAuth flow.
</Note>

### Claude (claude.ai)

<Steps>
  <Step title="Open Claude settings">
    Go to **Settings > Integrations** in Claude.
  </Step>

  <Step title="Add integration">
    Click **Add MCP Server** and paste the Aurora server URL.
  </Step>

  <Step title="Authorize">
    You'll be redirected to Aurora to authorize the connection. Click **Authorize** to grant Claude access to your projects.
  </Step>

  <Step title="Start building">
    Ask Claude to create a project. For example: *"Create a task manager app with drag and drop."*
  </Step>
</Steps>

### Claude Code (CLI)

<Steps>
  <Step title="Add the server">
    Run the following command to add Aurora as an MCP server:

    ```bash theme={null}
    claude mcp add aurora --transport http https://mcp.aurora.build/mcp
    ```
  </Step>

  <Step title="Authorize">
    The first time you use an Aurora tool, you'll be prompted to authenticate via your browser.
  </Step>

  <Step title="Start building">
    Use Aurora tools directly in your Claude Code session:

    ```
    Create a new Aurora project called "my-dashboard" with a weather widget and dark mode
    ```
  </Step>
</Steps>

### Cursor

<Steps>
  <Step title="Open MCP settings">
    Go to **Cursor Settings > MCP** or open `.cursor/mcp.json` in your project.
  </Step>

  <Step title="Add the server">
    Add Aurora to your MCP configuration:

    ```json theme={null}
    {
      "mcpServers": {
        "aurora": {
          "url": "https://mcp.aurora.build/mcp"
        }
      }
    }
    ```
  </Step>

  <Step title="Authorize">
    When you first interact with Aurora through Cursor, you'll be prompted to authorize via OAuth.
  </Step>
</Steps>

### Windsurf

<Steps>
  <Step title="Open MCP settings">
    Go to **Windsurf Settings > MCP** or edit your MCP configuration file.
  </Step>

  <Step title="Add the server">
    Add Aurora to your configuration:

    ```json theme={null}
    {
      "mcpServers": {
        "aurora": {
          "serverUrl": "https://mcp.aurora.build/mcp"
        }
      }
    }
    ```
  </Step>

  <Step title="Authorize">
    Authorize via the OAuth prompt on first use.
  </Step>
</Steps>

## Available MCP tools

Once connected, Aurora exposes the following tools to your AI assistant:

| Tool                    | Description                                   |
| ----------------------- | --------------------------------------------- |
| `create_project`        | Create a new project from a description       |
| `list_projects`         | List all your projects                        |
| `get_project`           | Get details about a specific project          |
| `read_file`             | Read a file from a project                    |
| `write_file`            | Create or overwrite a file                    |
| `edit_file`             | Make targeted edits to an existing file       |
| `delete_file`           | Remove a file from a project                  |
| `get_file_tree`         | View the project's file structure             |
| `deploy`                | Deploy the project to production              |
| `get_deployment_status` | Check the status of a deployment              |
| `chat`                  | Send a message to Aurora's AI to make changes |

## Tips

<Tip>
  **Use `chat` for complex changes.** While `write_file` and `edit_file` let your AI assistant modify files directly, the `chat` tool sends your request to Aurora's AI which understands your project's full context and can make coordinated changes across multiple files.
</Tip>

<Tip>
  **Combine with other tools.** MCP connections work alongside your existing workflow. Use Aurora to scaffold and deploy while using your local editor for fine-tuning.
</Tip>

## Revoking access

To disconnect an MCP integration, go to **Settings** in Aurora and click **Revoke** next to the integration you want to remove.

## Troubleshooting

<AccordionGroup>
  <Accordion title="OAuth prompt not appearing">
    Make sure your browser allows pop-ups from aurora.build. Some tools open the OAuth flow in a new tab or browser window.
  </Accordion>

  <Accordion title="Connection timeout">
    Verify you can reach `https://mcp.aurora.build` in your browser. If you're behind a corporate firewall or VPN, you may need to allowlist the domain.
  </Accordion>

  <Accordion title="Tools not showing up">
    Restart your AI tool after adding the MCP server. Some tools require a reload to discover new MCP servers.
  </Accordion>

  <Accordion title="Permission denied errors">
    Your OAuth token may have expired. Remove and re-add the MCP server to re-authorize.
  </Accordion>
</AccordionGroup>