Building with Claude Desktop
Learn about Building with Claude Desktop in WaymakerOS.
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
- Go to Commander > Settings > Access Keys
- Click Create Access Key
- 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
- Be specific about names — "Create an app called inventory-dashboard" is better than "create an app"
- Reference existing resources — "Deploy the customer-portal app" helps Claude find the right app
- Chain operations — "Create an app, set the environment variables, and deploy it" works in one conversation
- 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."