# MCP Connector Quickstart

Connect WebWork to your AI assistant in a couple of minutes. The steps below use Claude as the example.

- **Connector URL:** `https://mcp.webwork-tracker.com/mcp`


## Connect via the connector directory (recommended)

Once WebWork is listed in your AI client's connector directory, this is the way to connect — and the path for everyone:

1. Open **Settings → Connectors**.
2. Browse or search the directory for **WebWork**.
3. Click **Connect**, sign in with your WebWork account when prompted, and approve the requested permissions.
4. Done — your assistant can now use WebWork tools. You can set per-tool permissions (allow / ask / never) under the connector.


The directory uses WebWork's official, approved credentials, so there is nothing extra to configure.

## Custom connector (approved credentials only)

For early access before the directory listing, or for clients that connect by URL (such as Cursor or VS Code), WebWork can be added as a custom connector using the connector URL above.

For security, the connector accepts only **approved OAuth clients** — a custom connection works only with the OAuth credentials WebWork issues for it, and other client credentials are rejected. If you need a custom connection, contact [support](https://support.webwork-tracker.com) to request approved credentials.

## Try it

Ask your assistant:

- "List my WebWork workspaces."
- "List the projects in my workspace."
- "What are the open tasks in my project?"
- "Start the timer for Alex."
- "Give me the tracked-hours report for last week."


The assistant calls `list_workspaces` first to find your workspace, then `list_members` to resolve a person by name, and so on — you do not need to provide ids yourself.

## Permissions

The connector acts as you and only within your role (workspace Owner or Executive Manager). Write and admin tools change data; destructive tools ask for confirmation first. You can disconnect at any time to revoke access.

## Troubleshooting

- **"Not connected" again after a while** — your session token expired or was revoked; reconnect to continue.
- **Authorization failed** — confirm your account is a workspace Owner or Executive Manager with a verified email. For a custom connection, also confirm you are using the approved OAuth credentials WebWork issued (other clients are rejected by design).
- **A tool returns a permission error** — that action is outside your role, and the error is surfaced as-is.


## Learn more

- [Introduction](/mcp-connector) — what the connector is and what it can do.
- [Privacy Policy](https://www.webwork-tracker.com/mcp-connector-privacy)
- Support: [support.webwork-tracker.com](https://support.webwork-tracker.com)