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

# Connecting a Client

> Add Ana as an MCP server in Claude, Cursor, Windsurf, ChatGPT, Copilot, or Claude Code, and authorize once over OAuth.

Add Ana's MCP endpoint — `https://app.textql.com/mcp` — to any MCP-compatible client. Each client authorizes once over OAuth, then connects headlessly.

## Setup

<Tabs>
  <Tab title="Claude Web">
    1. Go to **Claude.ai → Settings → Integrations**
    2. Click **Add MCP Server**
    3. Enter `https://app.textql.com/mcp` as the server URL
    4. Name it `ana` and save

    <Frame caption="Setting Up Ana MCP in Claude Web">
      <img src="https://mintcdn.com/textql/4Iwqeoasyp2j84EX/images/mcp/ana-as-mcp-server/setup-in-claude.png?fit=max&auto=format&n=4Iwqeoasyp2j84EX&q=85&s=554c6fbbea9745a3dcf8f1b1b7075ce0" alt="Adding Ana as an MCP server in Claude Web settings" width="3018" height="1552" data-path="images/mcp/ana-as-mcp-server/setup-in-claude.png" />
    </Frame>

    Authorization happens automatically the first time you invoke `ask_question`.
  </Tab>

  <Tab title="Cursor">
    Add Ana to your Cursor MCP configuration. Open (or create) `~/.cursor/mcp.json`:

    ```json theme={null}
    {
      "mcpServers": {
        "ana": {
          "url": "https://app.textql.com/mcp"
        }
      }
    }
    ```

    Restart Cursor. On your first `ask_question` call, Cursor will open a browser window for OAuth authorization.
  </Tab>

  <Tab title="Windsurf">
    Open **Windsurf Settings → MCP Servers** and add a new server:

    ```json theme={null}
    {
      "mcpServers": {
        "ana": {
          "url": "https://app.textql.com/mcp"
        }
      }
    }
    ```

    Save and reload. The first use triggers a one-time OAuth flow in your browser.
  </Tab>

  <Tab title="Claude Code">
    Add Ana as an MCP server in Claude Code settings:

    ```json theme={null}
    {
      "mcpServers": {
        "ana": {
          "url": "https://app.textql.com/mcp"
        }
      }
    }
    ```

    Or run from the CLI:

    ```bash theme={null}
    claude mcp add --transport http ana https://app.textql.com/mcp
    ```

    The first time you use Ana in a session, you'll be prompted to authorize via OAuth.
  </Tab>

  <Tab title="ChatGPT">
    1. Go to **ChatGPT → Settings → Connectors**
    2. Click **Add connector**
    3. Enter `https://app.textql.com/mcp` as the MCP endpoint
    4. Follow the OAuth prompt to authorize

    Once connected, you can ask Ana data questions directly in any ChatGPT conversation.
  </Tab>

  <Tab title="Microsoft Copilot">
    1. Open **Copilot Settings → Extensions → MCP**
    2. Click **Add MCP server**
    3. Enter `https://app.textql.com/mcp`
    4. Complete the one-time OAuth authorization

    Ana will appear as an available tool in your Copilot sessions.
  </Tab>
</Tabs>

## First-Time Authorization

The first time your client calls Ana, you'll be redirected to the TextQL UI to complete a one-time OAuth authorization. This connects your TextQL identity to your MCP client — Ana knows which connectors and Ontology to use for your queries.

<Frame caption="Authorizing TextQL in Claude">
  <img src="https://mintcdn.com/textql/4Iwqeoasyp2j84EX/images/mcp/ana-as-mcp-server/claude-auth.png?fit=max&auto=format&n=4Iwqeoasyp2j84EX&q=85&s=55b7a1479146f18e1e9c616d134e9747" alt="TextQL OAuth authorization screen in Claude" width="3018" height="1470" data-path="images/mcp/ana-as-mcp-server/claude-auth.png" />
</Frame>

After authorization, your client connects headlessly. You won't need to re-authorize unless you revoke access.

Want to expose more than the default tools, or fewer? See [Tool groups & modes](/core/how-it-works/mcp/tool-groups).