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.
Partly in the app today. Items marked Planned are not built yet.
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
-
Open AI assistants
Sign in to os.construction and choose Account > AI assistants (
/account/ai-assistants). -
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.
-
Follow the steps for your assistant
The page shows the exact URL or configuration for Claude, ChatGPT, Claude Code, Cursor, VS Code and the
osccommand, 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.
- 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.
- Name it
os.constructionand paste the server URL. Keep the authentication options Claude detects. - Choose Connect, sign in to os.construction and choose Allow access.
Claude web, Desktop and mobile share this connection.
- In ChatGPT, open Settings > Apps. If your plan requires it, turn on developer mode under the advanced settings.
- Create an app, name it
os.construction, paste the server URL and choose OAuth. - Sign in to os.construction when prompted and choose Allow access.
claude mcp add --transport http os-construction https://app.os.construction/mcpThen 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.
-
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.
-
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.
-
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
- MCP workflows: what to ask once you are connected.
- MCP permissions and troubleshooting: scopes, denials and revocation.
- Set up the CLI preview: the
osccommand for scripts and terminal agents.
Keep exploring
Related across os.construction
- GlossaryAPI (Application Programming Interface)A defined way for software systems to request and exchange data with each other without manual export and import.
- GlossaryModel Context Protocol (MCP)An open protocol that lets an AI application discover and call tools and read data from other systems through a standard connector.
- BlogConnecting an AI assistant to your construction data: a permissions-first checklistAI assistants can now read and act on project records through connectors such as the Model Context Protocol. Before you connect one to RFIs, commitments or AP, decide whose credential it uses, what it can see, whether it can write, who approves, and how you'll know what it did.
- DocsSet up the MCP previewConnect an MCP client to os.construction with the hosted server or the local connector, and register hosted clients as an operator.
- DocsWork with the MCP previewUse discovery, schemas, bounded reads, and reviewed writes to work with construction records through the local MCP preview.
- Blogos.construction is open for trialsThe app is live at app.os.construction. Start a 14-day free trial: project management and project financials today, with separate company accounting workflows and planned AI agents. Here's exactly what's live and what isn't.
Was this helpful?
Run it on your own project.
Start a 14-day free trial. Want a say in what ships next? Join the founding program.
14-day free trial. Pricing for paid plans isn't set yet. Talk to us. Already have an account? Sign in →