Skip to content
/
Quickstart
Last updated

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

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 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