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

# Setup

> Connect your MCP client to Promptwatch using OAuth or an API key

<AccordionGroup>
  <Accordion title="Claude">
    <Steps>
      <Step title="Open Connectors">
        In Claude, go to **Customize → Connectors** (available in both Claude web and Claude Desktop).
      </Step>

      <Step title="Find Promptwatch in the directory">
        Click **Browse** to open the connector directory. In the search field, search for **Promptwatch**.
      </Step>

      <Step title="Connect and authorize">
        Click **Connect**. You'll be redirected to Promptwatch to set permissions. Choose which organization and projects it can access, then click **Accept**. You'll be redirected back to Claude, now connected.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Claude Code CLI">
    <Tabs>
      <Tab title="OAuth (recommended)">
        <Steps>
          <Step title="Add the server">
            ```bash theme={null}
            claude mcp add --transport http promptwatch https://server.promptwatch.com/mcp
            ```

            Do not pass `--header`. That would use API key auth and skip the OAuth flow.
          </Step>

          <Step title="Authenticate">
            Inside a Claude Code CLI session, run:

            ```
            /mcp
            ```

            Select `promptwatch`, choose **Authenticate**, and complete the Promptwatch consent page in your browser.
          </Step>

          <Step title="Verify">
            ```bash theme={null}
            claude mcp list
            ```

            The server should show as **Connected**.
          </Step>
        </Steps>
      </Tab>

      <Tab title="API key">
        <Steps>
          <Step title="Get your API key">
            Go to **Settings → API Keys** in your [Promptwatch dashboard](https://app.promptwatch.com), click **Create API Key**, and copy it.
          </Step>

          <Step title="Add the server">
            ```bash theme={null}
            claude mcp add --transport http promptwatch https://server.promptwatch.com/mcp \
              --header "Authorization: Bearer YOUR_API_KEY"
            ```

            Replace `YOUR_API_KEY` with the key from step 1.
          </Step>

          <Step title="Verify">
            ```bash theme={null}
            claude mcp list
            ```

            The server should show as **Connected**.
          </Step>
        </Steps>
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="OpenAI Codex (app)">
    <Steps>
      <Step title="Get your API key">
        Go to **Settings → API Keys** in your [Promptwatch dashboard](https://app.promptwatch.com), click **Create API Key**, and copy it.
      </Step>

      <Step title="Open MCP settings">
        In the left sidebar, click **Plugins**, then select the **MCPs** tab. Open the settings (gear) icon and add a server to reach the **Connect to a custom MCP** form.
      </Step>

      <Step title="Add the Promptwatch server">
        Fill in:

        * **Name:** `Promptwatch`
        * **Type:** `Streamable HTTP`
        * **URL:** `https://server.promptwatch.com/mcp`
      </Step>

      <Step title="Add authorization">
        Under **Headers**, click **+ Add header** and enter:

        * **Key:** `Authorization`
        * **Value:** `Bearer YOUR_API_KEY`

        Replace `YOUR_API_KEY` with your Promptwatch API key, then click **Save**.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Cursor">
    <Steps>
      <Step title="Get your API key">
        Go to **Settings → API Keys** in your [Promptwatch dashboard](https://app.promptwatch.com), click **Create API Key**, and copy it.
      </Step>

      <Step title="Install automatically">
        Click the button below. Cursor opens an install dialog. Replace `YOUR_API_KEY` with your key, then click **Install**:

        [![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](cursor://anysphere.cursor-deeplink/mcp/install?name=promptwatch\&config=eyJ1cmwiOiJodHRwczovL3NlcnZlci5wcm9tcHR3YXRjaC5jb20vbWNwIiwiaGVhZGVycyI6eyJBdXRob3JpemF0aW9uIjoiQmVhcmVyIFlPVVJfQVBJX0tFWSJ9fQ==)
      </Step>

      <Step title="Or configure manually">
        Add to `.cursor/mcp.json`:

        ```json theme={null}
        {
          "mcpServers": {
            "promptwatch": {
              "url": "https://server.promptwatch.com/mcp",
              "headers": {
                "Authorization": "Bearer YOUR_API_KEY"
              }
            }
          }
        }
        ```
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Other MCP clients">
    Any MCP-compatible client can connect using:

    ```
    URL:           https://server.promptwatch.com/mcp
    Transport:     Streamable HTTP
    Authorization: Bearer YOUR_API_KEY
    ```

    If your client does not support remote HTTP servers, use the `mcp-remote` proxy:

    ```json theme={null}
    {
      "mcpServers": {
        "promptwatch": {
          "command": "npx",
          "args": [
            "-y",
            "mcp-remote",
            "https://server.promptwatch.com/mcp",
            "--header",
            "Authorization: Bearer YOUR_API_KEY"
          ]
        }
      }
    }
    ```
  </Accordion>
</AccordionGroup>

## Start using it

Once connected, ask your AI assistant questions like:

* *"How visible is my brand in AI search results?"*
* *"Which sources are LLMs citing when they mention us?"*
* *"Compare our AI visibility against competitors"*
* *"What content gaps should I address?"*
* *"How much traffic are we getting from AI tools?"*
* *"Generate a blog post for prompt X using persona Y"*