> ## 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.

# Overview

> Install Unblocked MCP to give Claude Code, Cursor, Codex, Copilot, and other coding agents context from pull requests, docs, issues, and messaging threads.

Unblocked MCP gives your coding agents access to organizational context they can't get from code alone — pull request history, messaging threads, issue trackers, documentation, and more. One install works across all your tools.

The [Unblocked CLI](/unblocked-cli/cli-overview) runs the MCP server. The same context is also available as standalone [`context-*` commands](/unblocked-cli/cli-query) you can run directly or wire into scripts and CI.

If you are deciding between MCP, the CLI, and the REST API, see [Programmatic access to Unblocked](/programmatic-access).

## Prerequisites

Before you start, confirm that:

* Your team is set up in Unblocked. If it isn't, [get started](https://getunblocked.com/dashboard/get-started).
* You have an Unblocked license. If your team approves licenses manually, [request one](/request-license).
* You're on macOS or Linux. On Windows, follow the [install guide for your app](#install-for-a-specific-app) instead.
* The coding agents you want to use are installed. The installer sets up only the agents it finds.

## Install

<Steps>
  <Step title="Run the installer">
    Run the following command to install Unblocked MCP:

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

    The script downloads the Unblocked CLI and sets up your supported agents.

    <Note>
      The install script supports macOS and Linux. On Windows, follow the [install guide for your app](/unblocked-mcp/mcp-overview#install-for-a-specific-app).
    </Note>

    It sets up each supported agent it finds, such as Claude Code, Cursor, OpenCode, and Windsurf. It also installs [skills](https://github.com/unblocked/skills): prompts that teach your agents how to use Unblocked.
  </Step>

  <Step title="Sign in to Unblocked">
    The installer opens your browser to sign in. If sign-in doesn't start or fails, run `unblocked auth`.
  </Step>

  <Step title="Restart your agent">
    Restart your IDE or agent so it loads the Unblocked MCP configuration. Sessions you opened before installing can't use Unblocked.
  </Step>

  <Step title="Check the connection">
    Open your agent's MCP settings and check that `unblocked` is connected and its tools are listed. In Claude Code, run `/mcp`.
  </Step>

  <Step title="Ask a question">
    For example:

    > Use Unblocked to find the most recent pull request that changed our authentication code.

    Your agent should call `context_research` and cite pull requests or discussions.
  </Step>
</Steps>

## Install for a specific app

Use these guides to install Unblocked in ChatGPT, on Windows, or without the installer.

<CardGroup cols={3}>
  <Card title="ChatGPT" icon="https://mintcdn.com/unblocked/phpLVz7etHB72l5O/img/openai.svg?fit=max&auto=format&n=phpLVz7etHB72l5O&q=85&s=6a1b36030be3c976561d515519c34a20" href="/unblocked-mcp/install-chatgpt" width="24" height="24" data-path="img/openai.svg" />

  <Card title="Claude Code" icon="https://mintcdn.com/unblocked/phpLVz7etHB72l5O/img/claude.svg?fit=max&auto=format&n=phpLVz7etHB72l5O&q=85&s=61767d661d32b3cff74050394fc7d115" href="/unblocked-mcp/install-claude-code" width="24" height="24" data-path="img/claude.svg" />

  <Card title="Claude Desktop" icon="https://mintcdn.com/unblocked/phpLVz7etHB72l5O/img/claude.svg?fit=max&auto=format&n=phpLVz7etHB72l5O&q=85&s=61767d661d32b3cff74050394fc7d115" href="/unblocked-mcp/install-claude-desktop" width="24" height="24" data-path="img/claude.svg" />

  <Card title="Codex" icon="https://mintcdn.com/unblocked/phpLVz7etHB72l5O/img/openai.svg?fit=max&auto=format&n=phpLVz7etHB72l5O&q=85&s=6a1b36030be3c976561d515519c34a20" href="/unblocked-mcp/install-codex" width="24" height="24" data-path="img/openai.svg" />

  <Card title="Cursor" icon="https://mintcdn.com/unblocked/phpLVz7etHB72l5O/img/cursor.svg?fit=max&auto=format&n=phpLVz7etHB72l5O&q=85&s=2219c66b06e4d68a2e2cf4ca797a80d4" href="/unblocked-mcp/install-cursor" width="24" height="24" data-path="img/cursor.svg" />

  <Card title="JetBrains IDEs" icon="https://mintcdn.com/unblocked/phpLVz7etHB72l5O/img/jetbrains.svg?fit=max&auto=format&n=phpLVz7etHB72l5O&q=85&s=535b323e1877af59c739986db3dea0e0" href="/unblocked-mcp/install-jetbrains" width="24" height="24" data-path="img/jetbrains.svg" />

  <Card title="OpenCode" icon="https://mintcdn.com/unblocked/phpLVz7etHB72l5O/img/opencode.svg?fit=max&auto=format&n=phpLVz7etHB72l5O&q=85&s=13a5957abfcc2dd3f85e030b5bc3b66a" href="/unblocked-mcp/install-opencode" width="24" height="24" data-path="img/opencode.svg" />

  <Card title="VS Code" icon="https://mintcdn.com/unblocked/phpLVz7etHB72l5O/img/vscode.svg?fit=max&auto=format&n=phpLVz7etHB72l5O&q=85&s=b6a69e312bf6b81647bc5af04583278d" href="/unblocked-mcp/install-vscode" width="24" height="24" data-path="img/vscode.svg" />

  <Card title="Windsurf" icon="https://mintcdn.com/unblocked/phpLVz7etHB72l5O/img/windsurf.svg?fit=max&auto=format&n=phpLVz7etHB72l5O&q=85&s=b3169bd6cd734eb591c4aae7af95353e" href="/unblocked-mcp/install-windsurf" width="24" height="24" data-path="img/windsurf.svg" />

  <Card title="Other clients" icon="puzzle-piece" href="/unblocked-mcp/install-other" />
</CardGroup>

## Give your agent organizational context

After you install Unblocked, your agent can pull in context from PRs, messaging platforms, issue trackers, and documentation. Depending on your agent and its configuration, it may call these tools on its own or when you ask it to use Unblocked.

| Tool | What it does |
| - | - |
| `context_research` | Multi-source research across code, PRs, docs, issues, and messaging — returns a synthesized answer with citations |
| `context_get_urls` | Fetches the content behind one or more URLs your agent encounters or you provide |

<Note>
  These two tools replaced the earlier five-tool MCP surface (`unblocked_context_engine`, `research_task`, `data_retrieval`, `historical_context`, and `link_resolver`) in April 2026. If a prompt or configuration still uses the old tool names, change them to `context_research` or `context_get_urls`. Tools and their descriptions may change again.
</Note>

<CardGroup cols={2}>
  <Card title="Context research" icon="magnifying-glass" href="/unblocked-mcp/mcp-context-research" />

  <Card title="Context get URLs" icon="link" href="/unblocked-mcp/mcp-context-get-urls" />
</CardGroup>

## Troubleshooting

* **Claude Code shows `unblocked` as failed or not authenticated:** check whether the project's `.mcp.json` defines its own `unblocked` server. That entry replaces your user configuration. Check its command or URL before you trust it: a `.mcp.json` from a repository you don't control can impersonate Unblocked and receive the context your agent sends. To fix it, remove the project entry or point it at the official server.
* **A custom MCP client fails OAuth with `invalid_redirect_uri`:** Unblocked hasn't allowed that client's callback URL yet. [Contact us](https://getunblocked.com/dashboard?showIntercom=true) with the client name so we can add it.
* **Answers are thin or missing sources:** check that your team's [data sources](/data-sources/data-sources-overview) are connected. Newly connected sources may still be indexing.

## Enterprise Managed Authorization

Organizations using Claude with Okta can configure the Unblocked connector so members connect through their organization’s identity provider instead of completing a separate Unblocked browser sign-in. This setup requires Okta SSO and [user and group provisioning](/team-settings/sso/okta#user-and-group-provisioning).

Follow the [Claude + Okta setup instructions](/unblocked-mcp/enterprise-managed-authorization/claude-okta).