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

# Quick Start for Users

> A quick guide for getting started with Ultra

Your admin has set up [Ultra](https://ultra.security) for your team. Ultra is a lightweight proxy that sits between your AI client (Claude Desktop, Cursor, VS Code, etc.) and the MCP servers you use every day. It gives your security team visibility into MCP activity without changing how you work.

This guide gets you up and running in under 5 minutes.

## Install Ultra

<Tabs>
  <Tab title="Download from Website">
    Visit [ultra.security](https://ultra.security) and download the installer for your platform. Run the installer and it will automatically detect your AI clients and configure them.
  </Tab>

  <Tab title="Terminal">
    ```bash theme={null}
    curl -sSL https://get.ultra.security/install.sh | sh
    ```

    Then configure your AI client:

    ```bash theme={null}
    ultra install
    ```
  </Tab>
</Tabs>

**Restart your AI client** (Claude Desktop, Cursor, etc.) after installing for Ultra to take effect.

## Connect to Your Team

Your admin will provide you with a link to join your organization's Ultra Hub workspace. Once you receive the invite:

<Tabs>
  <Tab title="Client">
    Ask your AI client:

    * *"Log in to Ultra Hub"*
    * *"Link this gateway to Ultra Hub"*

    Follow the browser prompts to authenticate and join your workspace.
  </Tab>

  <Tab title="Terminal">
    ```bash theme={null}
    ultra login
    ultra link
    ```
  </Tab>
</Tabs>

Once linked, your MCP activity syncs to [Ultra Hub](https://hub.ultra.security) where your admin can see connected gateways, manage servers, and monitor activity across the team.

## Add Your MCP Servers

This is the part that replaces your old MCP setup. Instead of editing JSON config files manually, you add servers through Ultra and it handles configuration, authentication, and transport automatically.

<Tabs>
  <Tab title="Client">
    Ask your AI client to add the servers you need:

    * *"Add the Vanta MCP server"*
    * *"Connect to the GitHub MCP server"*
    * *"Set up the Notion MCP server"*
    * *"Add the Slack MCP server"*

    Your client will search the registry, install the server, and walk you through authentication.

    **Restart your AI client** after adding servers.
  </Tab>

  <Tab title="Terminal">
    ```bash theme={null}
    # Search for a server
    ultra search vanta

    # Add it
    ultra add vanta
    ```

    Ultra will search the registry, test the connection, and prompt for any required authentication (API keys, OAuth, etc.).

    **Restart your AI client** after adding servers.
  </Tab>
</Tabs>

### Popular Server Setup

Select a server to see setup instructions.

<AccordionGroup>
  <Accordion title="Notion">
    Connects your AI client to your Notion workspace for reading and writing pages, databases, and comments.

    <Tabs>
      <Tab title="Client">
        Ask your AI client: *"Add the Notion MCP server"*

        Notion uses OAuth. You will be redirected to Notion in your browser to authorize access to your workspace.
      </Tab>

      <Tab title="Terminal">
        ```bash theme={null}
        ultra add notion
        ```

        Ultra detects Notion's OAuth flow and opens your browser for authorization. Tokens are stored and refreshed automatically.
      </Tab>
    </Tabs>

    <Note>
      You need to be a member of the Notion workspace you want to connect. The OAuth consent screen will show which workspace pages the integration can access.
    </Note>
  </Accordion>

  <Accordion title="Slack">
    Lets your AI client send messages, search conversations, and interact with your Slack workspace.

    <Tabs>
      <Tab title="Client">
        Ask your AI client: *"Add the Slack MCP server"*

        Slack uses OAuth. You will be redirected to Slack in your browser to authorize.
      </Tab>

      <Tab title="Terminal">
        ```bash theme={null}
        ultra add https://mcp.slack.com/mcp --name slack
        ```

        Ultra handles the OAuth flow automatically. Authorize in your browser when prompted.
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="Linear">
    Connects your AI client to Linear for reading and managing issues, projects, and cycles.

    <Tabs>
      <Tab title="Client">
        Ask your AI client: *"Add the Linear MCP server"*

        Linear uses OAuth. Authorize in your browser when prompted.
      </Tab>

      <Tab title="Terminal">
        ```bash theme={null}
        ultra add linear
        ```

        Ultra detects Linear's OAuth flow and opens your browser for authorization.
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="GitHub">
    Gives your AI client access to repositories, issues, pull requests, and code search.

    <Tabs>
      <Tab title="Client">
        Ask your AI client: *"Add the GitHub MCP server"*

        You will be prompted for a **Personal Access Token (PAT)**. Create one at [github.com/settings/tokens](https://github.com/settings/tokens) with the scopes you need (typically `repo` and `read:org`).
      </Tab>

      <Tab title="Terminal">
        ```bash theme={null}
        ultra add github
        ```

        When prompted, enter your GitHub PAT. The token is stored securely in your Ultra config.
      </Tab>
    </Tabs>

    <Tip>
      Use a **fine-grained PAT** scoped to only the repositories you need. This follows the principle of least privilege and is safer than a classic token with broad access.
    </Tip>
  </Accordion>

  <Accordion title="Figma">
    Connects your AI client to Figma for accessing design files, components, and projects.

    <Tabs>
      <Tab title="Client">
        Ask your AI client: *"Add the Figma MCP server"*

        Figma uses OAuth. You will be redirected to Figma in your browser to authorize access.
      </Tab>

      <Tab title="Terminal">
        ```bash theme={null}
        ultra add https://mcp.figma.com/mcp --name figma
        ```

        Ultra handles the OAuth flow automatically. Authorize in your browser when prompted.
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="AWS">
    Gives your AI client access to AWS services, documentation, and infrastructure management.

    <Tabs>
      <Tab title="Client">
        Ask your AI client: *"Add the AWS MCP server"*

        You will need AWS credentials configured on your machine. If you haven't already, set up your AWS credentials before adding this server.
      </Tab>

      <Tab title="Terminal">
        ```bash theme={null}
        ultra add aws
        ```

        The server uses your local AWS credentials. Make sure `aws configure` is set up before adding.
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="Jira">
    Connects your AI client to Atlassian Jira for reading and managing issues, sprints, and projects.

    <Tabs>
      <Tab title="Client">
        Ask your AI client: *"Add the Jira MCP server"*

        You will be prompted for your Jira instance URL and an **API token**. Create one at [id.atlassian.com/manage-profile/security/api-tokens](https://id.atlassian.com/manage-profile/security/api-tokens).
      </Tab>

      <Tab title="Terminal">
        ```bash theme={null}
        ultra add jira
        ```

        When prompted, enter your Jira instance URL and API token.
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="Mintlify">
    Connects your AI client to your Mintlify documentation for searching and reading docs pages.

    <Tabs>
      <Tab title="Client">
        Ask your AI client: *"Add the Mintlify MCP server"*

        You will need your Mintlify project subdomain or API key.
      </Tab>

      <Tab title="Terminal">
        ```bash theme={null}
        ultra add mintlify
        ```

        When prompted, enter your Mintlify project details.
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="Salesforce">
    Gives your AI client access to Salesforce CRM data, objects, and reports.

    <Tabs>
      <Tab title="Client">
        Ask your AI client: *"Add the Salesforce MCP server"*

        Salesforce uses OAuth. You will be redirected to Salesforce in your browser to authorize access to your org.
      </Tab>

      <Tab title="Terminal">
        ```bash theme={null}
        ultra add salesforce
        ```

        Ultra handles the OAuth flow automatically. Authorize in your browser when prompted.
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="Datadog">
    Connects your AI client to Datadog for querying metrics, logs, and monitors.

    <Tabs>
      <Tab title="Client">
        Ask your AI client: *"Add the Datadog MCP server"*

        You will be prompted for your Datadog **API key** and **application key**. Find these in your Datadog org settings under API Keys.
      </Tab>

      <Tab title="Terminal">
        ```bash theme={null}
        ultra add datadog
        ```

        When prompted, enter your Datadog API key and application key.
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="PostgreSQL">
    Gives your AI client read access to a PostgreSQL database for querying tables and schemas.

    <Tabs>
      <Tab title="Client">
        Ask your AI client: *"Add the PostgreSQL MCP server"*

        You will be prompted for your database connection string.
      </Tab>

      <Tab title="Terminal">
        ```bash theme={null}
        ultra add postgres
        ```

        When prompted, enter your PostgreSQL connection string (e.g., `postgresql://user:pass@host:5432/dbname`).
      </Tab>
    </Tabs>

    <Warning>
      Only connect to databases you are comfortable exposing to your AI client. Use a read-only database user when possible.
    </Warning>
  </Accordion>

  <Accordion title="Vanta">
    Lets your AI client interact with your compliance data, controls, and vulnerabilities.

    <Tabs>
      <Tab title="Client">
        Ask your AI client: *"Add the Vanta MCP server"*

        When prompted, authorize through your browser. Vanta uses OAuth, so you will be redirected to Vanta to grant access.
      </Tab>

      <Tab title="Terminal">
        ```bash theme={null}
        ultra add https://mcp.vanta.com/mcp --name vanta
        ```

        Ultra detects Vanta's OAuth requirement and opens your browser to authorize. Once approved, the token is stored automatically.
      </Tab>
    </Tabs>

    <Note>
      You need an active Vanta account with appropriate permissions. If you see an authentication error, check with your Vanta admin that your account has API access enabled.
    </Note>
  </Accordion>

  <Accordion title="Filesystem">
    Gives your AI client read/write access to specific directories on your machine. Useful for letting AI tools work with your project files.

    <Tabs>
      <Tab title="Client">
        Ask your AI client: *"Add the filesystem server for my project files"*

        You will be asked which directories to allow access to. Only grant access to directories you want the AI to read/write.
      </Tab>

      <Tab title="Terminal">
        ```bash theme={null}
        ultra add filesystem
        ```

        When prompted, specify the directory paths you want to allow. The server runs locally and does not require authentication.
      </Tab>
    </Tabs>

    <Warning>
      The filesystem server can read and write files. Only grant access to directories you are comfortable sharing with your AI client. Never point it at your home directory or root.
    </Warning>
  </Accordion>
</AccordionGroup>

<Tip>
  Don't see your server listed? Check [Upstream Servers](/configuration/upstream-servers) for the full configuration guide.
</Tip>

## What's Next

<CardGroup cols={2}>
  <Card title="Upstream Servers" icon="server" href="/configuration/upstream-servers">
    Full guide to server configuration and management
  </Card>

  <Card title="Ultra Hub" icon="tower-control" href="/hub/overview">
    Learn about team management features
  </Card>

  <Card title="Observability" icon="eye" href="/observability/overview">
    Deep dive into traces and audit logs
  </Card>

  <Card title="How It Works" icon="diagram-project" href="/how-it-works">
    Understand the proxy architecture
  </Card>
</CardGroup>