Integrations with HQ Overview

Tinnacity HQ connects to third-party systems through the Integrations page in Company Settings. This article explains how to access integrations, what types are available, how to connect them from the Tinnacity side, and how to manage personal API tokens.

Click the appropriate link to jump to a section:

• How do I access the Integrations page?
• What integrations are available?
• How do I connect an integration?
• What are Personal API Tokens and how do I create one?
• How do I manage or revoke API tokens as an admin?

Accessing Integrations

Integrations are managed from Company Settings, which is accessed through your profile dropdown menu. NOTE: Only Account Owners and users with the appropriate permissions can view and manage integrations

1. Click on your name in the top-right corner of HQ.
2. Select [Company Settings].
3. In the left sidebar, click [Integrations].

Available Integrations

The Integrations page displays all available integrations as cards. Use the filter chips at the top to view All, Available, or Connected integrations.

Tinnacity currently supports the following integrations:

NOTE: If an integration you need is not listed, email Tinnacity Support at help@tinnacity.com to request it.

TIP: Telematics data (GPS and meter readings) syncs overnight on a daily basis. If recent GPS coordinates are available for a piece of equipment, the Service app will display a location icon in the Equipment card within the Work Order Details screen. The technician selects the icon and then the location of the equipment will be provided — helping technicians navigate directly to the equipment.

Connecting an Integration

The connect flow differs depending on the type of integration.

Telematics and Parts Integrations

These integrations require API credentials obtained from the third-party provider.

1. On the Integrations page, click [Connect] on the integration you want to add.
2. Review the Overview, Categories, and Permissions shown on the integration's detail page.
3. Click [Help Documentation] to open the third-party provider's guide for obtaining your API credentials.
4. Return to HQ and enter your credentials in the Client ID and Secret fields.
5. Click [Verify Credentials] to confirm your credentials are valid.
6. Click [Save].

NOTE: Each integration's Help Documentation link walks you through the steps required on the provider's side (such as locating your Client ID in your GemOne account). Contact the third-party provider's support team if you need help with their side of the setup.

AI Integrations (Claude and ChatGPT)

AI integrations are enabled at the company level first, then each user connects their own account individually.

To enable an AI integration for your company:

1. On the Integrations page, click [Connect] on Claude or ChatGPT.
2. Toggle [Enable (integration name) for this company] to on.
3. Click [Save].

Connecting Claude

Once enabled, a Connect Claude section appears on the HQ Integrations page with a Claude Desktop configuration code block. NOTE: An HQ Account Owner must first complete the steps below. Afterwards, other other users only need to search for the Tinnacity MCP in Claude and connect it.

1. In Claude Desktop, click your name (bottom-left), then [Settings], then [Developer], then [Edit Config], and open the claude_desktop_config.json file.
2. Back in HQ's Connect Claude section, click the copy button on the Claude Desktop configuration box.

3. Paste the code into the config file. If the file already has other content in it, merge the new code in rather than overwriting it. TIP: You can screenshot the other content in the config file and give it to Claude along with the Claude Desktop Configuration from HQ and prompt claude to combine them so you can copy and paste back into the file.
4. Save the file, then fully restart Claude Desktop.
5. When prompted, log in with your Tinnacity HQ username and password.

Once connected, Claude has read-only access to your HQ data — work orders, equipment, productivity, invoices, customers, and more — and can generate custom reports on demand.

NOTE: The Tinnacity MCP is read-only. For Claude to create, update, or delete anything in HQ (like updating a work order or creating a quote), install the Claude in Chrome extension. Adding a Global Instruction in Claude Desktop (Settings > Claude > Global Instructions) telling Claude to try the MCP first and fall back to Claude in Chrome for write actions keeps the two working together automatically.

Connecting ChatGPT

Once enabled, individual users can connect their own ChatGPT account to Tinnacity via OAuth from their personal account settings. Each user's access is scoped to their own Tinnacity permissions and can be revoked at any time.

Custom MCP

Custom MCP allows your team to connect a custom MCP client — such as a self-hosted AI tool — to Tinnacity's read-only MCP server.

1. On the Integrations page, click [Connect] on Custom MCP.
2. Toggle [Enable Custom MCP] to on.
3. Click [Save].

Once enabled, each OAuth client you register receives a unique Client ID that users enter when connecting their custom MCP client.

Personal API Tokens

Personal API tokens allow individual users to access the Tinnacity API or MCP server programmatically. Each token acts as the user who created it and is scoped to that user's permissions.

To create a personal API token:

1. Click your name in the top-right corner of HQ.
2. Select [My Profile].
3. Click [Security] in the left sidebar.
4. Scroll to the API tokens section and click [+ Create token].
5. Enter a name for the token.
6. Select an expiration period: 30 days, 90 days, 180 days, or 365 days.
7. Click [Create token].
8. Copy and store your token immediately — it will not be displayed again after you leave this page.

IMPORTANT: Treat your API token like a password. Do not share it or store it in an unsecured location. If a token is compromised, revoke it immediately from the same Security page.

Managing Tokens

Account Owners can view and revoke all active personal API tokens across the company.

1. Click your company name in the top-right corner and select [Company Settings].
2. In the left sidebar, click [Security].
3. Scroll to the API tokens section to see all active tokens.
4. Click [Revoke] next to any token to deactivate it immediately.

NOTE: Revoking a token will immediately disconnect any application or integration using that token. Let the token owner know before revoking so they can create a replacement if needed.