Esc

↑↓ move↵ openIndex · Pagefind
Agents / Connect Claude, ChatGPT or Cursor

Connect Claude, ChatGPT or Cursor

Connect an AI assistant to os.construction. Start from Account > AI assistants, which shows the steps that work for your workspace today.

Preview

Partly in the app today. Items marked Planned are not built yet.

On this page

An AI assistant connected to os.construction works as you. It can search the API, read the projects and records you can read and, if you allow it, make changes you could make yourself. Every call is checked against your current company, project and record permissions. The connection never gives an assistant more access than your account has.

Start in the app

  1. Open AI assistants

    Sign in to os.construction and choose Account > AI assistants (/account/ai-assistants).

  2. Check the status badge

    Hosted connection: Preview means you can paste the server URL into Claude, ChatGPT, Cursor or VS Code. Hosted connection: not yet enabled means you use a personal token with the local connector for now.

  3. Follow the steps for your assistant

    The page shows the exact URL or configuration for Claude, ChatGPT, Claude Code, Cursor, VS Code and the osc command, each with a copy button.

Connect with the hosted server

The server URL is https://app.os.construction/mcp. Your assistant opens os.construction in your browser. You sign in, review what the assistant is asking for, and choose Allow access or Deny. Hosted connections are read-only during the preview.

  1. In Claude, open Settings > Connectors and choose Add custom connector. On Team and Enterprise plans an Owner adds it under Organization settings > Connectors, then each member chooses Connect.
  2. Name it os.construction and paste the server URL. Keep the authentication options Claude detects.
  3. Choose Connect, sign in to os.construction and choose Allow access.

Claude web, Desktop and mobile share this connection.

  1. In ChatGPT, open Settings > Apps. If your plan requires it, turn on developer mode under the advanced settings.
  2. Create an app, name it os.construction, paste the server URL and choose OAuth.
  3. Sign in to os.construction when prompted and choose Allow access.
claude mcp add --transport http os-construction https://app.os.construction/mcp

Then run /mcp in Claude Code, choose os-construction and authenticate in your browser.

Add this to ~/.cursor/mcp.json, or to .cursor/mcp.json in a project:

{
  "mcpServers": {
    "os-construction": {
      "url": "https://app.os.construction/mcp",
      "auth": { "CLIENT_ID": "os-construction-cursor" }
    }
  }
}

Open Cursor’s MCP settings, choose Connect and allow access in your browser. Cursor needs the CLIENT_ID line because it does not publish a client identity that os.construction can recognize.

Add this to .vscode/mcp.json, or run MCP: Add Server and choose HTTP:

{
  "servers": {
    "os-construction": { "type": "http", "url": "https://app.os.construction/mcp" }
  }
}

Start the server from the file or the MCP view and allow access in your browser.

Assistants act as agents: they can read and draft or propose changes, and a person approves. Approval, posting, payment, delete and permission changes are refused for any assistant connection or AI assistant token. See MCP permissions.

A connection lasts up to 14 days before your assistant asks you to sign in again. To end one early, open Account > Connected apps and choose Revoke access. If an assistant shows This app is not approved yet, os.construction has not approved that assistant for hosted connections; use the token setup below or contact support.

Connect with a personal token

Use this path while the hosted connection is off, or for assistants that launch a local program.

  1. Create a token

    In Account > AI assistants > Personal API tokens, enter a name such as Claude Desktop on my laptop, keep Read-only (recommended), choose an expiry and choose Create token. Copy the token straight away; it is shown once.

  2. Add the local connector to your assistant

    The connector runs on your computer with Node.js 24 or newer. Put the token in the assistant’s environment settings, never in a chat message.

  3. Restart the assistant and try a read

    Ask it to find the RFI operations and list the first few RFIs in a project you can open.

For Claude Desktop, choose Settings > Developer > Edit config and add:

{
  "mcpServers": {
    "os-construction": {
      "command": "npx",
      "args": ["-y", "@os-construction/cli", "mcp"],
      "env": { "OS_CONSTRUCTION_API_TOKEN": "paste-your-token-here" }
    }
  }
}

Cursor uses the same mcpServers block in mcp.json. For Claude Code:

claude mcp add os-construction --env OS_CONSTRUCTION_API_TOKEN=paste-your-token-here -- npx -y @os-construction/cli mcp

Read-only tokens cannot change records. A Read and write token (which never covers webhooks or company administration) lets the connector make changes only after you set OS_CONSTRUCTION_MCP_ALLOW_WRITES=true, and every change is still limited by your permissions. Tokens expire after 7, 30 or 90 days. Revoke a token from the same page, and note that changing your password or two-factor settings revokes all of your tokens.

Next steps

Keep exploring

Related across os.construction

Run it on your own project.

Start a 14-day free trial. Want a say in what ships next? Join the founding program.

Your role (optional)

14-day free trial. Pricing for paid plans isn't set yet. Talk to us. Already have an account? Sign in →

Ask the OS

Reading this page

Ask anything about this page. Answers use what you're reading as context.

Suggested

    AI · may be imperfect · sample data where shown

    Open file