Hosted MCP installer

Install or update Barvinca for Codex.

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

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