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

# Install: Claude Code

## Quick install (macOS)

Run the following command to install Unblocked MCP:

```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}
curl -fsSL https://getunblocked.com/install-mcp.sh | bash
```

This will download the Unblocked CLI and configure your supported tools and agents automatically.

<Note>
  The install script is currently supported on macOS only. Windows and Linux users should use the manual install instructions below.
</Note>

## Marketplace

<Steps>
  <Step title="Add the Unblocked marketplace">
    Run the following command in Claude Code:

    ```
    /plugin marketplace add unblocked/skills
    ```
  </Step>

  <Step title="Install the Unblocked plugin">
    Run `/plugin`, go to the **Discover** tab, select the Unblocked plugin, and install it.
  </Step>

  <Step title="Authenticate">
    After installation, authenticate via OAuth when prompted.
  </Step>
</Steps>

<Note>
  You may need to run `/reload-plugins` or restart Claude Code for skills to appear after installation. This is a temporary requirement.
</Note>

## Manual install (macOS, Windows, Linux)

You can connect Claude Code to remote Unblocked MCP with the following command line:

```bash theme={null}
claude mcp add -s user --transport http unblocked https://getunblocked.com/api/mcpsse
```

After connecting to Unblocked MCP, you will need to log in to Unblocked via OAuth:

1. Launch Claude Code
2. Run `/mcp`
3. Select `unblocked` -- this should be shown with a label `disconnected`
4. Claude Code will launch a browser to log in to Unblocked

## Headless Automation

You can install Unblocked MCP for use in headless automation scenarios, such as within GitHub Actions, by using Personal or Team API Tokens.

<Tabs>
  <Tab title="Personal Access Token">
    <Steps>
      <Step title="Create the API Token">
        In the [Unblocked web app](/using-unblocked/on-the-web), click on **Settings** --> **API Tokens**.

        In the **Personal API Tokens** section, click on **Create Token**.

        <img src="https://mintlify.s3.us-west-1.amazonaws.com/unblocked/img/personal-token-1.png" alt="Personal Token[]" />
      </Step>

      <Step title="Configure the API Token">
        Fill out the token name.  You can also limit the data sources that the token will have access to in the list under **Data Sources**.

        <img src="https://mintlify.s3.us-west-1.amazonaws.com/unblocked/img/personal-token-2.png" alt="Personal Token[]" />
      </Step>

      <Step title="Copy the API Token">
        Copy the resulting API token.

        <img src="https://mintlify.s3.us-west-1.amazonaws.com/unblocked/img/personal-token-3.png" alt="Personal Token[]" />
      </Step>

      <Step title="Install Unblocked MCP">
        You can install the tools into Claude Code with the following command:

        ```
        claude mcp add -s user --transport http secure-server https://getunblocked.com/api/mcpsse --header "Authorization: Bearer unb_token"
        ```

        or by editing the `~/.claude.json` file:

        ```json theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}
        {
        "mcpServers": {
          "unblocked": {
            "type": "http",
            "url": "https://getunblocked.com/api/mcpsse",
              "headers": {
                "Authorization": "Bearer unb_token"
              }
            }
          }
        }
        ```

        <Tip>
          Be sure to replace `unb_token` with the token you generated above.
        </Tip>
      </Step>
    </Steps>
  </Tab>

  <Tab title="Team Access Token">
    <Warning>
      This connection method uses an API token that gives access to every document in your Unblocked team's data sources. If your team has connected sensitive data, such as private Slack channels, the MCP tools will potentially return this data in its queries.
    </Warning>

    <Steps>
      <Step title="Create the API Token">
        In the [Unblocked web app](/using-unblocked/on-the-web), click on **Settings** --> **API Tokens**.

        In the **Team API Tokens** section, click on **Create Token**.

        <img src="https://mintlify.s3.us-west-1.amazonaws.com/unblocked/img/team-token-1.png" alt="Team Token[]" />
      </Step>

      <Step title="Configure the API Token">
        Fill out the token name.  You can also limit the data sources that the token will have access to in the list under **Data Sources**.

        <img src="https://mintlify.s3.us-west-1.amazonaws.com/unblocked/img/team-token-2.png" alt="Team Token[]" />
      </Step>

      <Step title="Copy the API Token">
        Copy the resulting API token.

        <img src="https://mintlify.s3.us-west-1.amazonaws.com/unblocked/img/team-token-3.png" alt="Team Token[]" />
      </Step>

      <Step title="Install Unblocked MCP">
        You can install the tools into Claude Code with the following command:

        ```
        claude mcp add -s user --transport http secure-server https://getunblocked.com/api/mcpsse --header "Authorization: Bearer unb_token"
        ```

        or by editing the `~/.claude.json` file:

        ```json theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}
        {
        "mcpServers": {
          "unblocked": {
            "type": "http",
            "url": "https://getunblocked.com/api/mcpsse",
              "headers": {
                "Authorization": "Bearer unb_token"
              }
            }
          }
        }
        ```

        <Tip>
          Be sure to replace `unb_token` with the token you generated above.
        </Tip>
      </Step>
    </Steps>
  </Tab>
</Tabs>