Waymaker Host

Building with Claude Desktop

Learn about Building with Claude Desktop in WaymakerOS.

MCPClaude DesktopAI

The most powerful way to use Waymaker Host is through conversation. Connect the Waymaker MCP server to Claude Desktop and you can build, deploy, and manage infrastructure by describing what you want.

Setup (3 Steps)

1. Create an Access Key

  1. Go to Commander > Settings > Access Keys
  2. Click Create Access Key
  3. Copy the key (starts with wm_sk_ — only shown once)

Your access key carries your identity. It grants the same access you have in the UI — across both Commander and Host. No separate permissions needed.

2. Connect to Claude Desktop

Add Waymaker to your Claude Desktop MCP configuration:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "waymaker": {
      "type": "http",
      "url": "https://mcp.waymakerone.com/mcp",
      "headers": {
        "Authorization": "Bearer wm_sk_your_access_key_here"
      }
    }
  }
}

3. Restart Claude Desktop

Restart Claude Desktop. You should see 111 Waymaker tools available in the tool list — covering both Commander and Host.

The Killer Demo

Here's a conversation that goes from zero to a deployed app with a custom domain:

"Create an app for my customer portal"

Claude creates the app in your organization, links your GitHub repo, and triggers the first build.

"What's the deployment status?"

Claude checks the build pipeline and reports progress.

"Set up portal.acme.com as the custom domain"

Claude initiates domain setup and shows you the DNS records to configure.

"Check if my DNS is ready"

Claude verifies DNS propagation and auto-provisions SSL when ready.

"Set the API_KEY environment variable to sk-abc123"

Claude securely stores the variable. You'll need to redeploy for it to take effect.

"Deploy the latest version"

Claude triggers a new build from the latest commit on your branch.

What Claude Can Do

With the Waymaker MCP tools, Claude can manage the entire platform:

Commander (84 tools)

  • Create and manage tasks, documents, sheets, goals, roles, teams
  • Create webhook connections, map fields to tables, view events
  • Create and manage data tables, query rows
  • Apply leadership frameworks to your organization
  • Search across workspaces
  • Manage org chart and user invitations

Host Apps (11 tools)

  • List, create, update, and delete apps
  • Trigger deployments and check build status
  • View deployment history
  • Upload files directly (Host Direct)

Host Domains (4 tools)

  • Set up custom domains with DNS instructions
  • Verify DNS configuration
  • Check SSL provisioning status
  • Remove custom domains

Host Ambassadors (10 tools)

  • Create serverless functions
  • Deploy to the edge
  • Invoke ambassadors manually
  • View invocation logs
  • Manage environment variables

Host GitHub (3 tools)

  • Check GitHub App installation status
  • Connect and disconnect GitHub accounts

Tips for Effective Conversations

  1. Be specific about names — "Create an app called inventory-dashboard" is better than "create an app"
  2. Reference existing resources — "Deploy the customer-portal app" helps Claude find the right app
  3. Chain operations — "Create an app, set the environment variables, and deploy it" works in one conversation
  4. Ask for status — "Show me all my apps and their deployment status" gives you a quick overview

Example Workflows

Build and Deploy a Marketing Site

"Create an app called landing-page from my repo github.com/acme/marketing, it uses Next.js. Set up www.acme.com as the custom domain."

Create a Scheduled Report

"Create an ambassador called weekly-report that runs every Monday at 9am. Link it to my repo github.com/acme/reports."

Check Everything

"List all my apps and ambassadors with their current status."

Set Up a New Client (Partners)

"Create a workspace called Acme Operations, set up projects for Sales, Marketing, and Product, then apply the OKR Builder framework to define Q2 goals."