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

# Installation

> Install Superdata in Codex, Claude, or another compatible MCP client.

Superdata runs as a hosted MCP service. Choose the setup that matches your
client; every connection uses the same Superdata account and intelligence-credit
allowance.

## Before you begin

You need an approved Superdata account and access to the **Connections** page.
Interactive clients can use browser sign-in. CI, scripts, and clients without
OAuth support can use an API key.

<CardGroup cols={2}>
  <Card title="Codex" icon="bot" href="/connections/codex">
    Install the Superdata plugin and authenticate with browser sign-in.
  </Card>

  <Card title="Claude" icon="sparkles" href="/connections/claude">
    Install Superdata in Claude Desktop, Cowork, or Claude Code.
  </Card>

  <Card title="Other MCP clients" icon="plug" href="/connections/other-mcp-clients">
    Connect a compatible Streamable HTTP client to the hosted endpoint.
  </Card>

  <Card title="API keys" icon="key-round" href="/connections/api-keys">
    Create and manage credentials for non-interactive connections.
  </Card>
</CardGroup>

## Connection details

| Setting                        | Value                          |
| ------------------------------ | ------------------------------ |
| Transport                      | Streamable HTTP                |
| MCP endpoint                   | `https://api.superdata.so/mcp` |
| Interactive authentication     | OAuth browser sign-in          |
| Non-interactive authentication | Bearer API key                 |
| Required permission            | `mcp:use`                      |

## Verify the installation

Restart or reload your client after setup, then ask it to list the Superdata
tools. A working connection exposes:

* `superdata_search_companies`
* `superdata_search_people`

Continue to [First query](/first-query) once both tools are visible.

<Warning>
  Never paste an API key or OAuth token into a chat, screenshot, source file, or
  URL. Use your client's secure credential storage or an environment variable.
</Warning>