Connect Claude (MCP)

v1

Drop one config block into Claude Desktop or Claude Code and Claude can read, create, update, and publish your processes on your behalf — same permissions as your login, nothing more.

Step 1 — Mint an API key

Go to /account/api-keys and create a personal key. Copy the plaintext — it's shown once and never again.

Heads up. Personal keys act as you and can only touch your personal processes. To have Claude edit your organization's processes, mint an org key at /org/<slug>/api-keys. Members without admin permission must request one — an owner/admin approves.

Step 2 — Install the MCP server

We publish an npm package that exposes the API as MCP tools. Add it to your Claude config.

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json on macOS (or %APPDATA%\Claude\claude_desktop_config.json on Windows) and add: 

{
  "mcpServers": {
    "whatstheprocessfor": {
      "command": "npx",
      "args": ["-y", "@whatstheprocessfor/mcp"],
      "env": {
        "WTPF_API_KEY": "wtpf_your_key_here"
      }
    }
  }
}

Claude Code

From your terminal, run:

claude mcp add whatstheprocessfor \
  -- npx -y @whatstheprocessfor/mcp \
  --env WTPF_API_KEY=wtpf_your_key_here

Replace wtpf_your_key_here with the plaintext key you just copied. Restart Claude.

Step 3 — Verify it's working

In any Claude conversation, ask: "Run the whoami tool from whatstheprocessfor." You should get back your user id and — if it's an org key — your org name. If you see an auth error, check your API key and reload Claude.

Available tools

Tool Purpose
whoami Confirm the key is working and show who it acts as.
list_processes Page through your processes. Filter by visibility or title.
get_process Fetch a single process with its full step list.
create_process Create a new process. Validates URLs + plan limits automatically.
update_process Update any field on an existing process; snapshots the previous version.
publish_process Mark a process as published. Optionally change visibility at the same time.
delete_process Permanently delete a process. Requires a key with the processes:delete scope.

Troubleshooting

  • 401 Missing or invalid API key. Your key was revoked or mistyped. Mint a fresh one at /account/api-keys.
  • 403 Missing required scope. The key doesn't have the scope this tool needs. Mint a new key with the right scope (read/write/delete).
  • 429 Rate limit exceeded. You hit your per-minute or per-day limit. Wait the number of seconds in retry_after_seconds, or upgrade your plan for higher quotas.
  • Claude doesn't see the server. Restart Claude fully after editing the config. Check that npx -y @whatstheprocessfor/mcp runs cleanly in a terminal.

Not using Claude Desktop / Claude Code?

Any tool that speaks MCP works. For non-MCP clients, hit the REST API directly — see the reference or grab the OpenAPI spec.