Skip to main content
WORKWAY
Claude Desktop

Install in Claude Desktop

Complete guide to setting up WORKWAY MCP in Anthropic's Claude Desktop application.

Prerequisites

  • Claude Desktop installed (Download)
  • Node.js 18 or later installed
1

Locate the config file

Claude Desktop stores MCP server configuration in a JSON file.

macOS

~/.config/claude/claude_desktop_config.json

Open Terminal and run: open ~/.config/claude/

Windows

%APPDATA%\Claude\claude_desktop_config.json

Press Win+R, type the path above, and press Enter.

Linux

~/.config/claude/claude_desktop_config.json

File doesn't exist?

Create the directory and file manually. The directory might not exist if you haven't configured MCP servers before.

mkdir -p ~/.config/claude && touch ~/.config/claude/claude_desktop_config.json
2

Add the configuration

Open the config file in your text editor and add the WORKWAY MCP server.

If the file is empty or new:

claude_desktop_config.json
{
  "mcpServers": {
    "workway-construction": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-remote", "https://mcp.workway.co"]
    }
  }
}

If you have existing MCP servers:

Add the workway-construction entry to your existing mcpServers object:

claude_desktop_config.json
{
  "mcpServers": {
    "existing-server": {
      "command": "...",
      "args": ["..."]
    },
    "workway-construction": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-remote", "https://mcp.workway.co"]
    }
  }
}

How it works

The @anthropic/mcp-remote package handles the connection to our MCP server. It's downloaded automatically via npx when Claude starts.

3

Restart Claude Desktop

Completely quit Claude Desktop (not just close the window) and reopen it.

How to fully restart:

  • macOS: Click Claude in the menu bar → Quit Claude, then reopen
  • Windows: Right-click Claude in the system tray → Exit, then reopen
4

Verify the installation

Check that WORKWAY tools are available.

Look for the tools icon

In a new chat, click the hammer icon (🔨) in the message input area. You should see WORKWAY tools listed.

"What WORKWAY construction tools do you have available?"

Ask Claude this to see a list of all available tools.

Troubleshooting

Tools don't appear

  • • Make sure you fully quit and reopened Claude (not just closed the window)
  • • Check for JSON syntax errors in the config file
  • • Verify Node.js is installed: run node --version in Terminal

Connection errors

  • • Ensure you have an internet connection
  • • Check that mcp.workway.co is accessible from your network
  • • Try restarting Claude Desktop again

"npx" not found

  • • Install Node.js from nodejs.org
  • • Make sure Node.js is in your PATH
  • • On macOS, you may need to restart Terminal after installing Node.js