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

# Connect to Claude

> Add Aeris as a custom connector in Claude Desktop, then ask about your ad performance in plain language. ~60 seconds.

Add Aeris as a custom connector in Claude, then ask about your ad performance in plain language. Takes about 60 seconds.

Claude runs inside Aeris. Once you connect, you can ask Claude about every platform Aeris is connected to (Google Ads, Meta, Microsoft, GA4, and more) — no dashboards, no exports.

<Note>
  **You'll need a paid Claude plan** (Pro, Team, or Max). The free plan doesn't support custom connectors.
</Note>

## Fastest path

The **Open Claude** button on your [Connections page](https://tryaeris.ai/connections) opens Claude at the exact right screen — no clicking through Settings. That's the path this guide follows. Prefer to do it manually? Skip to [Manual setup](#manual-setup).

## Your connector URL

You'll need this when Claude asks for the MCP server URL.

```text theme={null}
https://mcp.tryaeris.ai/mcp
```

## Add Aeris as a connector

<Steps>
  <Step title="Fill in the details">
    Claude opens directly at the **Add custom connector** modal. Enter:

    * **Name** — `Aeris`
    * **Remote MCP server URL** — `https://mcp.tryaeris.ai/mcp`

    <Frame>
      ![Add custom connector modal with Aeris and the MCP URL filled in](https://tryaeris.ai/docs/mcp/claude/step-1-details.png)
    </Frame>
  </Step>

  <Step title="Hit Add">
    After filling both fields, click **Add** at the bottom-right of the modal.

    <Frame>
      ![Add button highlighted at the bottom of the modal](https://tryaeris.ai/docs/mcp/claude/step-2-confirm.png)
    </Frame>
  </Step>

  <Step title="Connect">
    Click **Connect** on the new Aeris connection.

    <Frame>
      ![Aeris row in the connector list with the Connect button](https://tryaeris.ai/docs/mcp/claude/step-3-connect.png)
    </Frame>
  </Step>

  <Step title="Sign in with Aeris">
    Claude opens the Aeris authorization page. If you're already signed in on tryaeris.ai, you'll land straight on the consent screen. If not, you'll be asked to sign in first, then bounced right back.

    Review the scopes Claude is asking for (**Read** and **Draft** by default; the **Apply** scope stays behind a per-action approval), then click **Allow Claude to connect**.

    <Frame>
      ![Aeris consent screen showing Read, Draft, and Apply scopes](https://tryaeris.ai/docs/mcp/claude/step-4-consent.png)
    </Frame>
  </Step>

  <Step title="Done">
    You'll see a green **Connected to Aeris** toast in Claude. The connector now lists every tool Claude can call — reporting, AEO, campaign drafting, and more.

    <Frame>
      ![Connected to Aeris toast with the full tool permissions list visible](https://tryaeris.ai/docs/mcp/claude/step-5-done.png)
    </Frame>
  </Step>
</Steps>

## Try it

Start a **new chat** in Claude and ask for what you want:

<Tip>
  Show me the last 30 days of Google Ads spend and break it down by campaign.
</Tip>

Claude uses Aeris tools to answer — real numbers, real chart, right in the chat.

<Warning>
  Always start a **new chat** after connecting or reconnecting. Existing chats won't pick up the connection.
</Warning>

## What Claude can do (by default)

* **Read** — pull KPI reports, campaign performance, connected ad platforms, and AEO audits.
* **Draft** — prepare campaigns and optimizations for you to review. Nothing is applied until you approve it inside Aeris.
* **Apply** — off by default. When Claude proposes an action that would spend money or change a live campaign, Aeris will ask you to approve **per action**, not up front.

You can revoke this connection anytime from your Aeris account.

If you don't have access to the **Open Claude** button — signed out, on a different device, or you found this page through search:

1. Go to [claude.ai](https://claude.ai), click your profile avatar at the **bottom-left**, then **Settings**.
2. Open the **Connectors** tab → click **Customize**.
3. Click the **+** button next to Connectors — that opens the same modal shown in Step 1 above. Continue from there.

## Troubleshooting

<AccordionGroup>
  <Accordion title="&#x22;Failed to register with Aeris login service&#x22;">
    Claude's Dynamic Client Registration call couldn't reach our OAuth server. Delete the connector, restart Claude, and re-add it. If it still fails after one retry, email us at [support@tryaeris.ai](mailto:support@tryaeris.ai) — include the reference id Claude shows (`ofid_...`).
  </Accordion>

  <Accordion title="Consent page opens but shows an empty workspace picker">
    You're signed into Aeris on a different browser than the one Claude used for the auth popup. Sign in on the browser Claude used, then click **Connect** again.
  </Accordion>

  <Accordion title="Charts show the numbers but no image">
    Charts arrive as inline PNGs. If your Claude client is older than the 2025-06-18 protocol version, upgrade Claude Desktop and reconnect.
  </Accordion>
</AccordionGroup>

## Next steps

<CardGroup cols={2}>
  <Card title="Connect to ChatGPT" icon="robot" href="/chatgpt">
    Same power, different assistant.
  </Card>

  <Card title="FAQ" icon="circle-question" href="/faq">
    Plans, security, revoking, changing workspace.
  </Card>
</CardGroup>

Questions? [support@tryaeris.ai](mailto:support@tryaeris.ai).