Glossa
Getting started

Connect ChatGPT to a local workspace

Install Glossa, add it to ChatGPT, then pair the computer that will expose your project.

1. Install

Requires Node.js 22.9 or newer.

npm install --global @ariobarin/glossa

2. Add Glossa to ChatGPT

  1. In ChatGPT web, use Developer Mode to create a custom MCP app.
  2. Name it Glossa and use this MCP server URL:
https://mcp.glossa.sh/mcp
  1. Choose OAuth, then Scan Tools. Complete authorization, wait for the scan, then Create.

Review permissions and requested actions.

3. Start and pair a workspace

Open a terminal in your project folder and run:

glossa

The first time a computer runs Glossa, it shows a short pairing code. Enter it on the Glossa control panel and sign in to the account that should own the computer. On a headless or SSH-only machine, redeem the printed code from any other device. Glossa then stores only the computer's revocable device credential. It does not retain your Google or Auth0 refresh token.

Keep the terminal open after pairing. Later glossa runs on that computer reuse the device pairing without user sign-in. Run glossa unpair to revoke the computer before pairing it with another Glossa account.

Glossa starts with workspace access: ChatGPT can read and edit the selected project, but cannot run commands. system access is optional and unsandboxed; commands inherit the account's environment, credentials, filesystem permissions, and network access. Review security before enabling it.

4. Test it

Select Glossa in a new chat and send:

Use Glossa to list my connected workspaces and report each access profile.

If your workspace appears, you're connected.

Having trouble? Visit support.