--- title: MCP FAQs and Troubleshooting Guide description: "Timeero MCP FAQ: learn how to connect AI assistants to Timeero's Public API, manage permissions, set up your MCP URL, and troubleshoot common connection issues." --- [Skip to content](https://help.timeero.com/mcp-faqs-and-troubleshooting-guide#main-content) English Show submenu for translations [![logo - 512.png\]](https://help.timeero.com/hs-fs/hubfs/logo%20-%20512.png?width=75&height=75&name=logo%20-%20512.png)](https://timeero.com) Open main navigation Close main navigation - English Show submenu for translations - [Go to timeero.com](https://timeero.com/) [Go to timeero.com](https://timeero.com/) Help Center - There are no suggestions because the search field is empty. 1. [Help Center](https://help.timeero.com/?hsLang=en) 2. [Integrations](https://help.timeero.com/integrations?hsLang=en) 3. [MCP](https://help.timeero.com/integrations?hsLang=en#mcp) # MCP FAQs and Troubleshooting Guide ## Learn the answers to common questions about the MCP and troubleshoot problems you may be experiencing with it.  ### ![Premium Plan](https://help.timeero.com/hs-fs/hubfs/Premium%20Plan.png?width=75&height=46&name=Premium%20Plan.png) ### FAQs ##### Is Timeero MCP the same as the Public API? No. The Public API is the REST API developers use directly. Timeero MCP is a secure bridge that lets AI assistants use that API through natural conversation. ##### What plan do I need? A Timeero plan with Public API access (**Premium** plan). Contact your Timeero account representative if you are unsure. ##### Where do I find my API key? Go to **Integrations → Public API → Configuration**. See also [Public API Integration](https://help.timeero.com/public-api-integration?hsLang=en). ##### What is the Timeero MCP URL? Use [https://mcp.timeero.com/mcp](https://mcp.timeero.com/mcp).     ### Connection and permission FAQs ##### Can I prevent the AI from changing or deleting data? Yes. Leave **Write** and **Delete** unchecked on the authorize screen. To change permissions later in **Claude**, disconnect the Timeero MCP connector and connect again. Claude will ask you to choose permissions and authorize access. For other MCP clients, open [Manage permissions](https://mcp.timeero.com/mcp/permissions), update write/delete access, then reload the MCP tools in your client. ##### I granted write access but the AI still cannot create or update records - Confirm write (and delete, if needed) under Manage permissions. - Start a **new chat** after changing permissions. - Approve any tool confirmation prompts in your AI client. ##### How do I disconnect or rotate access? 1. Revoke or regenerate your Public API key in Timeero under **Integrations → Public API → Configuration**. 2. Remove or reconnect the Timeero connector in your AI client. ### Using the tools ##### Are there date-range limits? Hours and mileage reports cover up to **366 days** per request. Listing schedules and time off is limited to **30 days** per request. Split longer schedule or time-off periods into multiple requests. ##### The AI cannot find an employee or job - Use the exact name as it appears in Timeero, or provide the numeric ID. - Ask the AI to list users, jobs, or groups first, then retry with the exact match. ### Troubleshooting ##### Connector will not authenticate - Confirm the MCP URL is [https://mcp.timeero.com/mcp](https://mcp.timeero.com/mcp). - Paste a freshly copied Public API key with no extra spaces. - Disable browser blockers for the Timeero connect page temporarily. - Try again in a private/incognito window. - Microsoft copilot web([copilot.com](http://copilot.com)) and copilot app that comes with windows 11(consumer app) does not support MCP. Only "Microsoft Copilot Studio" support the MCP.  ##### Tools appear, but every request fails - Your key may have been revoked - generate a new key and reconnect. - Your plan may not include Public API access. - Confirm [https://mcp.timeero.com/mcp](https://mcp.timeero.com/mcp) is online, or contact [api@timeero.com](mailto:api@timeero.com). ##### Who do I contact for support? - API / MCP: [api@timeero.com](mailto:api@timeero.com) - General Timeero support: [Contact Timeero Support](https://help.timeero.com/contact-timeero-support?hsLang=en) - [Getting Started](https://help.timeero.com/getting-started?hsLang=en#main-content) - [First Steps](https://help.timeero.com/getting-started?hsLang=en#first-steps) - [Users](https://help.timeero.com/getting-started?hsLang=en#users) - [Jobs & Tasks](https://help.timeero.com/getting-started?hsLang=en#jobs-tasks) - [Scheduling](https://help.timeero.com/getting-started?hsLang=en#scheduling) - [Company Settings](https://help.timeero.com/company-settings?hsLang=en#main-content) - [Main Settings](https://help.timeero.com/company-settings?hsLang=en#main-settings) - [Break Settings](https://help.timeero.com/company-settings?hsLang=en#break-settings) - [Premium Settings](https://help.timeero.com/company-settings?hsLang=en#premium-settings) - [Billing](https://help.timeero.com/billing?hsLang=en) - [Advanced Tracking Options](https://help.timeero.com/advanced-tracking-options?hsLang=en#main-content) - [Auto Clock In/ Out](https://help.timeero.com/advanced-tracking-options?hsLang=en#auto-clock-in-out) - [Timesheets, Mileage & Location Tracking](https://help.timeero.com/timesheets-mileage-location-tracking?hsLang=en#main-content) - [Time & Mileage page on the Web Portal](https://help.timeero.com/timesheets-mileage-location-tracking?hsLang=en#time-mileage-page-on-the-web-portal) - [Entries Tab on the Mobile App](https://help.timeero.com/timesheets-mileage-location-tracking?hsLang=en#entries-tab-on-the-mobile-app) - [Kiosk App](https://help.timeero.com/timesheets-mileage-location-tracking?hsLang=en#kiosk-app) - [Multi-Level Approvals](https://help.timeero.com/timesheets-mileage-location-tracking?hsLang=en#multi-level-approvals) - [Integrations](https://help.timeero.com/integrations?hsLang=en#main-content) - [Gusto](https://help.timeero.com/integrations?hsLang=en#gusto) - [ADP Workforce Now](https://help.timeero.com/integrations?hsLang=en#adp-workforce-now) - [ADP RUN](https://help.timeero.com/integrations?hsLang=en#adp-run) - [QuickBooks Online](https://help.timeero.com/integrations?hsLang=en#quickbooks-online) - [Zapier](https://help.timeero.com/integrations?hsLang=en#zapier) - [Paychex](https://help.timeero.com/integrations?hsLang=en#paychex) - [Sandata EVV](https://help.timeero.com/integrations?hsLang=en#sandata-evv) - [Paylocity](https://help.timeero.com/integrations?hsLang=en#paylocity) - [Rippling](https://help.timeero.com/integrations?hsLang=en#rippling) - [QuickBooks Desktop](https://help.timeero.com/integrations?hsLang=en#quickbooks-desktop) - [Xero](https://help.timeero.com/integrations?hsLang=en#xero) - [PIMSY](https://help.timeero.com/integrations?hsLang=en#pimsy) - [Paycor](https://help.timeero.com/integrations?hsLang=en#paycor) - [Sage Intacct](https://help.timeero.com/integrations?hsLang=en#sage-intacct) - [Viventium](https://help.timeero.com/integrations?hsLang=en#viventium) - [BambooHR](https://help.timeero.com/integrations?hsLang=en#bamboohr) - [MCP](https://help.timeero.com/integrations?hsLang=en#mcp) - [Reports](https://help.timeero.com/reports?hsLang=en) - [Employee Resources](https://help.timeero.com/employee-resources?hsLang=en#main-content) - [Getting Started](https://help.timeero.com/employee-resources?hsLang=en#getting-started) - [Configure Settings](https://help.timeero.com/employee-resources?hsLang=en#configure-settings) - [Managing Time & Mileage](https://help.timeero.com/employee-resources?hsLang=en#managing-time-mileage) - [Time Off Management](https://help.timeero.com/time-off-management?hsLang=en) - [In-App Messaging](https://help.timeero.com/in-app-messaging?hsLang=en#main-content) - [Message Blasts](https://help.timeero.com/in-app-messaging?hsLang=en#message-blasts) - [Product Updates](https://help.timeero.com/product-updates?hsLang=en) - [Frequently Asked Questions](https://help.timeero.com/frequently-asked-questions?hsLang=en) # Timeero For further assistance, contact our support team: +1 (888) 998-0852 or email us: hello@timeero.com © 2026 by Timeero LLC.