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 API key
Create your own key in Admin — see API Keys. A key acts as whoever created it, so never use a key someone else made for you.
- Go to admin.waymakerone.com/api/keys
- Click Create API Key and tick the permissions Claude will need
- Copy the key (starts with
wm_sk_— only shown once)
The key acts as you, with your access. The permissions you tick decide which tools Claude is offered — a read-only key sees no write tools. What each permission covers is in the developer docs: Authentication.
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_api_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."