{"templateId":"markdown","versions":[{"version":"v1","label":"V1 (Deprecated)","link":"/v1/mcp-connector/quickstart","default":false,"active":false,"folderId":"8a5edab2"},{"version":"v2","label":"V2 (Current)","link":"/mcp-connector/quickstart","default":true,"active":true,"folderId":"8a5edab2"}],"sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"MCP Connector Quickstart","description":"Complete REST API V2 documentation for WebWork Tracker. Integrate time tracking, team management, projects, tasks, timesheets, leaves, expenses, and webhooks. OAuth2 authentication, rate limits, pagination, and real-time webhooks support.","llmstxt":{"hide":false,"title":"WebWork Time Tracker API V2","description":"Modern REST API for WebWork Time Tracker","sections":[{"title":"API Reference","description":"All REST API endpoints","includeFiles":["@v2/api.yaml"],"excludeFiles":[]},{"title":"Documentation","description":"Guides and markdown docs","includeFiles":["@v2/**/*.md"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"mcp-connector-quickstart","__idx":0},"children":["MCP Connector Quickstart"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Connect WebWork to your AI assistant in a couple of minutes. The steps below use Claude as the example."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connector URL:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://mcp.webwork-tracker.com/mcp"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"connect-via-the-connector-directory-recommended","__idx":1},"children":["Connect via the connector directory (recommended)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once WebWork is listed in your AI client's connector directory, this is the way to connect — and the path for everyone:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings → Connectors"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Browse or search the directory for ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["WebWork"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connect"]},", sign in with your WebWork account when prompted, and approve the requested permissions."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Done — your assistant can now use WebWork tools. You can set per-tool permissions (allow / ask / never) under the connector."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The directory uses WebWork's official, approved credentials, so there is nothing extra to configure."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"custom-connector-approved-credentials-only","__idx":2},"children":["Custom connector (approved credentials only)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For security, the connector accepts only ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["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 ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://support.webwork-tracker.com"},"children":["support"]}," to request approved credentials."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"try-it","__idx":3},"children":["Try it"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ask your assistant:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["\"List my WebWork workspaces.\""]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["\"List the projects in my workspace.\""]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["\"What are the open tasks in my project?\""]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["\"Start the timer for Alex.\""]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["\"Give me the tracked-hours report for last week.\""]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The assistant calls ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list_workspaces"]}," first to find your workspace, then ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list_members"]}," to resolve a person by name, and so on — you do not need to provide ids yourself."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"permissions","__idx":4},"children":["Permissions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"troubleshooting","__idx":5},"children":["Troubleshooting"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["\"Not connected\" again after a while"]}," — your session token expired or was revoked; reconnect to continue."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["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)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["A tool returns a permission error"]}," — that action is outside your role, and the error is surfaced as-is."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"learn-more","__idx":6},"children":["Learn more"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/mcp-connector"},"children":["Introduction"]}," — what the connector is and what it can do."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.webwork-tracker.com/mcp-connector-privacy"},"children":["Privacy Policy"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Support: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://support.webwork-tracker.com"},"children":["support.webwork-tracker.com"]}]}]}]},"headings":[{"value":"MCP Connector Quickstart","id":"mcp-connector-quickstart","depth":1},{"value":"Connect via the connector directory (recommended)","id":"connect-via-the-connector-directory-recommended","depth":2},{"value":"Custom connector (approved credentials only)","id":"custom-connector-approved-credentials-only","depth":2},{"value":"Try it","id":"try-it","depth":2},{"value":"Permissions","id":"permissions","depth":2},{"value":"Troubleshooting","id":"troubleshooting","depth":2},{"value":"Learn more","id":"learn-more","depth":2}],"frontmatter":{"seo":{"title":"MCP Connector Quickstart"}},"lastModified":"2026-06-25T14:14:12.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/mcp-connector/quickstart","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}