# Install or update Barvinca for Codex.

Hosted MCP installer



One universal page, with native commands for macOS, Linux, and Windows. The installer registers the hosted MCP endpoint and opens OAuth; it does not download a local Barvinca server or ask for Autodesk credentials.

Choose your operating system

## Install or update Codex first

Barvinca uses the installed Codex CLI. Check the version and apply a supported Codex self-update:

```
codex --version
codex update
```

If Codex is not installed and npm is your package manager:

```
npm install --global @openai/codex
codex login
```

macOS and Linux

## Terminal

Paste one command into Terminal. It works with POSIX `sh` on current macOS and Linux systems.

```
curl -fsSL https://barvinca.com/install/codex.sh | sh
```

[Review shell script](/install/codex.sh)

Windows

## PowerShell

Paste one command into Windows PowerShell. The script uses the installed Codex CLI and opens browser authorization.

```
irm https://barvinca.com/install/codex.ps1 | iex
```

[Review PowerShell script](/install/codex.ps1)

## What the installer does

1.  Finds an installed Codex CLI and verifies that it supports OAuth resource binding.
2.  Adds `https://mcp.barvinca.com/mcp` under the MCP server name `barvinca`, without replacing an unrelated existing entry.
3.  Requests only the default `barvinca.read` scope and opens the Barvinca browser consent flow.
4.  Prints the saved, non-secret server configuration and asks you to restart Codex.

## Prerequisite and safety

**Codex must already be installed and signed in.** Review either hosted script before running it. The installer never asks for an Autodesk access token, refresh token, APS Client Secret, static bearer token, or Barvinca password. OAuth credentials remain managed by Codex.

## Manual setup

If you prefer not to pipe a hosted script into a shell, run the same Codex commands directly:

```
codex mcp add barvinca --url https://mcp.barvinca.com/mcp --oauth-resource https://mcp.barvinca.com/mcp
codex mcp login barvinca --scopes barvinca.read
codex mcp get barvinca --json
```

## Request additional scopes

The installer deliberately requests read-only access. Reconnect explicitly when a reviewed workflow requires another scope:

```
codex mcp logout barvinca
codex mcp login barvinca --scopes barvinca.read,barvinca.write
```

## Update or repair Barvinca

Rerun the same macOS/Linux or Windows installer command whenever Codex has been updated or OAuth needs to be refreshed. A matching entry is preserved and verified. Barvinca is hosted, so there is no local MCP server binary to update.

## Optional Codex plugin

The MCP installer does not install the optional plugin bundle. Install it when you also want Barvinca's packaged Codex guidance:

```
codex plugin marketplace add dmytro-yemelianov/barvinca-codex-plugin
codex plugin add barvinca@barvinca
```

Refresh its Git marketplace snapshot later with:

```
codex plugin marketplace upgrade barvinca
codex plugin list --json
```

## Remove the connection

When you no longer want the server on this machine, run:

```
codex mcp logout barvinca
codex mcp remove barvinca
```

---

Canonical HTML: https://barvinca.com/install/codex