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

# Connect Oppin to your AI app

> Ask Claude, ChatGPT, Cursor and other apps that support MCP about your AI visibility, using your live Oppin data.

Oppin connects to the AI app you already use through MCP, the standard way AI apps reach outside tools. Once it's connected, you can ask in plain words ("which questions are we losing to competitors?") and the app answers from the same numbers as your dashboard: Brand Strength, share of voice, the AI answers themselves, the sources behind them, the fan-out queries AI runs, and Oppin's recommendations.

With write access it can also tune your tracking for you: add brands, prompts, competitors and brand names, organize topics, and update recommendations. It always shows you the changes and waits for your yes first, and you can undo them.

The connection is available on every plan.

## Connect

**1. Open the Data & MCP page**

In Oppin, click **Data & MCP** in the sidebar. The **MCP** tab opens first.

![The MCP tab of the Data & MCP page, with the Connect Oppin button and the use cases below it](https://mintcdn.com/oppin/F8kBGKCirb1Jf0-M/images/mcp-tab.png?fit=max\&auto=format\&n=F8kBGKCirb1Jf0-M\&q=85\&s=f4dac8c4bdb5fb2eda24aedd7414174f)

**2. Pick your app**

Click **Connect Oppin** and pick the app you use. Each one shows its own steps: a one-click button where the app has one, a command to copy for terminal tools, or the address to paste.

![The Connect Claude step, with the Add to Claude button and four numbered steps](https://mintcdn.com/oppin/F8kBGKCirb1Jf0-M/images/mcp-connect-claude.png?fit=max\&auto=format\&n=F8kBGKCirb1Jf0-M\&q=85\&s=dacc3244c8db70e8aec21242398f128c)

**3. Approve access in Oppin**

Every app sends you to Oppin to approve. Choose the organization and see what the connection will be able to do: read your data and, when your app asks for it, change what you track. Members with view-only access connect read-only.

![The Oppin approval page, listing what the connection can do and the workspaces to choose from](https://mintcdn.com/oppin/F8kBGKCirb1Jf0-M/images/mcp-approve.png?fit=max\&auto=format\&n=F8kBGKCirb1Jf0-M\&q=85\&s=490468fe85b806f3430739192f33fab5)

**4. Ask away**

Start a new chat in your app and turn Oppin on if it asks. Then try: *Using Oppin, how visible are we in AI answers right now?*

The page notices the new connection by itself when you come back to it. For each app's steps, see [Connect your app](https://docs.oppin.ai/mcp/connect.md). Every app uses the same address:

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

An app that cannot sign in that way can use an [API key](https://docs.oppin.ai/api.md#get-a-key) instead, sent as `Authorization: Bearer <key>`. A key created with read and write access can change tracking; a read-only key cannot.

## What it can do

| Ask about | What comes back |
| :- | :- |
| Where you stand | Brand Strength, visibility, share of voice, top-3 rate, sentiment and rank, with the previous period alongside |
| Competitors | Every tracked brand's numbers and how they changed, plus brands AI names that you don't track yet |
| Assistants, countries, topics | Every brand's numbers split by AI assistant, country or topic |
| Individual questions | Question by question: you against each competitor, the leader, the gap |
| The answers themselves | Each AI answer in full, with its citations, your position and tone, and the brands it names |
| Sources | The sites and pages AI reads and cites, your own site's share, and the page text |
| Query fan-out | The fan-out queries AI engines run to build their answers, and whether you surfaced in them |
| Recommendations | Oppin's growth actions, each with its evidence and steps |

**With write access** it can add, edit, stop and delete prompts, switch AI assistants on or off for them, create, rename and remove topics and move prompts between them, tag prompts, have Oppin draft new prompts for your review, add and edit competitors, add the other names AI uses for your brand, update your brand's profile, and mark recommendations done or dismissed. A workspace admin's connection (or a write API key) can also add a new brand, within your plan's brand limit. It never reaches billing, members or API keys.

New prompts are answered within minutes, so you see results in the same conversation. If you add a very large batch at once, some wait for the next daily run; the tool's reply says how many.

## Ready-made commands

Oppin ships [commands](https://docs.oppin.ai/mcp/commands.md) that run a fixed, tested analysis in one step: a weekly pulse, a competitor radar, a content brief, a full brand audit and more. Each can return its result as text, an interactive page, a PDF or slides. Start with **Ideas** (`oppin_ideas`), which lists things to try.

## Access and safety

* **You see the access before you approve.** The approval page lists what the connection gets: reading your data, and changing what you track when your app asks for it. Members with view-only access always connect read-only.
* **Nothing changes without your yes.** Your AI app lists the changes before it makes them, and prompts can only be deleted after they are stopped, so their history is kept.
* **Every change is logged, and most can be undone.** The Data page lists what each connected app changed, with an Undo button, and your app can undo a change too ("undo that"). An undo is refused when someone edited the same thing again since, so it never overwrites later work.
* **A connection belongs to the person who approved it.** If they leave the organization or lose access, it stops working.
* **Disconnect any time.** In Oppin, open **Data & MCP** (the **MCP** tab) and find it under **Connected applications**. Admins see and can disconnect every connection in the organization. See [Troubleshooting](https://docs.oppin.ai/mcp/troubleshooting.md#disconnect-or-start-over).

## Good to know

* **Answers are collected once a day.** A 48-hour window holds few answers, so a trend over a day or two is thin.
* **One connection reads one organization.** Agencies that keep each client as a brand in one organization can ask across all of them.
* **Oppin does not send alerts or run on a schedule.** For a daily check, use your AI app's scheduled tasks.
* **Query fan-out comes from the engines that expose it:** ChatGPT, Perplexity and Claude.

> **[Use cases](https://docs.oppin.ai/mcp/use-cases.md)**
>
> Prompts to paste, from a two-minute pulse to a full brand audit.

> **[Commands](https://docs.oppin.ai/mcp/commands.md)**
>
> The ready-made analyses and their options.

> **[Tools](https://docs.oppin.ai/mcp/tools.md)**
>
> Every tool your app can call, with its arguments.

> **[Troubleshooting](https://docs.oppin.ai/mcp/troubleshooting.md)**
>
> When the app does not use Oppin, cannot change anything, or disagrees with the dashboard.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.