---
title: Connect PromptEye to Claude
description: Add the PromptEye connector to Claude, sign in with your PromptEye account, and ask about your projects in a conversation.
---

The PromptEye connector lets Claude work with your PromptEye data while you talk to it. Instead of opening several pages in the app, you can ask Claude where your brand stands, which competitors are recommended instead of you, or which pages AI assistants cite, and Claude looks it up in your account.

You connect by signing in with your PromptEye account. You do not need an API key, and there is nothing to install.

## Before you start

- A PromptEye account with a verified email address, and at least one project. Without a project, Claude can help you create one, but there is nothing to measure yet.
- A Claude account. The connector works in Claude on the web, Claude Desktop, the Claude mobile apps, and Claude Code.
- On a Claude Team or Enterprise plan, an owner of your Claude organization may need to add the connector before members can use it.

## Connect in Claude

1. In Claude, open **Settings → Connectors**.
2. Find **PromptEye** in the connector directory and choose **Connect**. If it is not listed in your version of Claude, choose **Add custom connector** instead, name it “PromptEye”, and enter `https://mcp.prompteye.com/mcp` as the server URL.
3. Claude opens PromptEye in your browser. Sign in if you are not signed in already.
4. Check the **Authorize application** page and choose **Approve**.

You return to Claude, and the connector shows as connected. Start a new conversation and ask, for example, “Show me my PromptEye projects.”

To connect from Claude Code, run:

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

Then type `/mcp` in Claude Code, choose **prompteye**, and sign in when your browser opens.

## What you approve

The **Authorize application** page shows which PromptEye account you are signed in as, which application is asking, where you will return afterwards, and what you are allowing. Check the account first: Claude will see exactly what this account sees. If it is the wrong one, choose **Use a different account**.

Approving lets Claude:

- **Access your PromptEye data and use its tools on your behalf.** Claude can read the workspaces and projects your account can open, and it can also make changes, such as creating a project, accepting a prompt suggestion, or ordering a content brief.
- **Stay connected without asking you to sign in again**, so you do not have to approve the connection in every conversation.

The approval covers reading and changing together; there is no read-only option. To keep Claude from changing anything, set the PromptEye tools that make changes to require approval, or turn them off, in the connector's settings in Claude. Claude works with the same projects and permissions as your account. If you lose access to a project in PromptEye, Claude loses access to it too. If you choose **Deny**, nothing is shared and you return to Claude without a connection.

## What you can ask

Start by asking Claude what it can do with PromptEye; the answer reflects the tools available in your connection. Some examples:

- “How visible is our brand in AI answers in [project name], and which prompts got worse this month?”
- “Which competitors are recommended instead of us, and which sources do assistants cite for them?”
- “Suggest new prompts for our pricing group and track the best three.”
- “Order a content brief for a prompt where we are never mentioned.”
- “Can ChatGPT's crawler read our product pages? Show errors from the last month.”
- “What does Reach Index mean?” Claude can look up this Help Center too.

If your account has several projects, name the one you mean, or ask Claude to switch to it; Claude works on one project at a time and tells you which. Answers depend on the data in your account. A new prompt is asked as soon as it is added, so its first visibility figures appear shortly after, without waiting for the next scheduled run. Google or traffic figures need those integrations connected to the project in PromptEye.

## When Claude makes changes

Every PromptEye tool tells Claude whether it only reads, changes something, or replaces or removes data, such as replacing the list of brands excluded from competitor rankings. Depending on your Claude settings, Claude asks before running a tool that changes something, and it asks every time before one that replaces or removes data. Changes made through Claude are the same as changes made in the app: everyone with access to the project sees them, and the same plan rules and limits apply. Some things can only be done in the app, such as deleting a prompt or generating the article text from a content brief; Claude tells you when that is the case.

## See or remove the connection

Every app you approved is listed in **Connected apps** on the [Developer page](/help/developer/), with its permissions, when you connected it, and when it was last used.

To stop Claude from reaching your PromptEye data, choose **Disconnect** next to it. Access ends straight away for that connection. If you connected from more than one place, for example Claude on the web and Claude Code, each connection can appear as its own row; disconnect each one you want to stop. Your PromptEye data is not changed, and anything Claude already did stays as it is. To use PromptEye in Claude again, connect again and approve the request.

Removing the connector in Claude's settings stops Claude from using it, but the approval stays in **Connected apps** until you disconnect it there.

## If something goes wrong

- **“This application is not recognized”** or **“This authorization request is invalid or incomplete”**: start the connection again from Claude rather than reopening an old browser tab.
- **“For your security, open this page directly in your browser”**: the sign-in page was opened inside another page. Open the link in a normal browser tab.
- **Claude says it cannot reach PromptEye or asks you to sign in again**: reconnect the connector in Claude's settings. This is also needed if you disconnected Claude in **Connected apps**.
- **Claude sees no projects or the wrong ones**: check which account you approved with in **Connected apps**. Disconnect it, then connect again and choose **Use a different account** on the approval page.
- **Figures are empty**: a newly added prompt is asked straight away, and its answers arrive gradually over the following minutes. Check again a little later; there is no need to wait for the next scheduled run.
- **Claude cannot do what you asked**: some actions exist only in the app. If you think PromptEye should support it, Claude can offer to send a short note to the PromptEye team; it asks you first and sends nothing without your agreement.

## Questions

**Do I still need an API key?** Not for the Claude connector. API keys are for Claude Desktop's downloadable add-on, Looker Studio, and your own tools. Both ways can be used side by side.

**Can my colleagues use my connection?** No. Each person connects Claude with their own PromptEye account and sees their own projects.

**Does PromptEye see my conversations with Claude?** No. PromptEye receives only the requests Claude makes to read or change your PromptEye data. If you agree to send feedback to the PromptEye team through Claude, it sends a short note you approved.
