# Cursor

# Connecting Cursor

Use Cursor to ask questions about authorized SiteTrax.io observations and analytics while you work. Cursor connects to the SiteTrax.io MCP server as a remote server, and SiteTrax.io continues to enforce your account’s project access.

## Before you start

Use an active, email-verified SiteTrax.io account with the projects you need, and a current version of Cursor with MCP support. A published Intelligence profile is optional. Sign in to app.sitetrax.io in your default browser with the account you want Cursor to use, because the consent page uses that session.

No API key, token or SiteTrax.io password goes into the Cursor configuration. Cursor registers itself with SiteTrax.io automatically and you approve access on the SiteTrax.io consent page.

## Step 1: Open Cursor’s MCP settings

In Cursor, open **Customize → MCPs** (in the editor: **Cursor Settings → Tools & MCP**). Servers you already use are listed under Connected. Select **New MCP Server**.

[![Cursor MCP settings before SiteTrax.io is added, showing the New MCP Server button](https://docs.sitetrax.io/uploads/images/gallery/2026-11/scaled-1680-/cursor-01-mcp-list-empty.png)](https://docs.sitetrax.io/uploads/images/gallery/2026-11/cursor-01-mcp-list-empty.png)

## Step 2: Add the SiteTrax.io server

Cursor opens your MCP configuration file, `~/.cursor/mcp.json`. To make SiteTrax.io available in only one repository, use `.cursor/mcp.json` in that project instead.

[![Cursor opens an empty mcp.json file beside the MCP settings](https://docs.sitetrax.io/uploads/images/gallery/2026-11/scaled-1680-/cursor-02-new-mcp-server.png)](https://docs.sitetrax.io/uploads/images/gallery/2026-11/cursor-02-new-mcp-server.png)

Add the `sitetrax` entry and save the file. If the file already lists other servers, add the entry alongside them.

```json
{
  "mcpServers": {
    "sitetrax": {
      "url": "https://mcp.sitetrax.io/mcp"
    }
  }
}
```

Use the full endpoint, including `/mcp`. Do not add `headers`, a bearer token or a client secret. After you save, sitetrax appears in the list as *Connecting…*.

[![The saved mcp.json with the SiteTrax.io endpoint, and sitetrax connecting in the MCP list](https://docs.sitetrax.io/uploads/images/gallery/2026-11/scaled-1680-/cursor-03-config-saved.png)](https://docs.sitetrax.io/uploads/images/gallery/2026-11/cursor-03-config-saved.png)

## Step 3: Authenticate

Within a few seconds sitetrax moves to **Needs Attention** with the status *Needs authentication*. Select **Authenticate**.

[![sitetrax listed under Needs Attention with an Authenticate button](https://docs.sitetrax.io/uploads/images/gallery/2026-11/scaled-1680-/cursor-04-needs-auth.png)](https://docs.sitetrax.io/uploads/images/gallery/2026-11/cursor-04-needs-auth.png)

## Step 4: Review and allow access

Your browser opens the SiteTrax.io consent page, *Connect Cursor to SiteTrax.io*. It shows what the connection can do:

- **View shared project data** (read access): project details, detections, equipment history, video metadata and operational analytics within your existing access.
- **Manage your notifications** (action access): create and cancel alerts or scheduled digests sent only to your verified SiteTrax.io email. Each change requires your confirmation.

[![SiteTrax.io consent page titled Connect Cursor to SiteTrax.io, listing read access and notification access](https://docs.sitetrax.io/uploads/images/gallery/2026-11/scaled-1680-/cursor-05-consent-access.png)](https://docs.sitetrax.io/uploads/images/gallery/2026-11/cursor-05-consent-access.png)

Scroll down to **Projects in scope** to check which projects are shared with the signed-in account. If the list is wrong, select **Cancel** and sign in with the correct account. Otherwise, select **Allow access**.

[![Projects in scope section of the consent page with Cancel and Allow access buttons; project names are blurred](https://docs.sitetrax.io/uploads/images/gallery/2026-11/scaled-1680-/cursor-06-consent-allow.png)](https://docs.sitetrax.io/uploads/images/gallery/2026-11/cursor-06-consent-allow.png)

## Step 5: Return to Cursor

The browser shows *Authorization complete!*. If the browser asks whether to open Cursor, select **Open Cursor**; otherwise select **Return to Cursor** or close the tab.

[![Browser tab showing Authorization complete with an Open Cursor prompt](https://docs.sitetrax.io/uploads/images/gallery/2026-11/scaled-1680-/cursor-07-auth-complete.png)](https://docs.sitetrax.io/uploads/images/gallery/2026-11/cursor-07-auth-complete.png)

Back in Cursor, sitetrax is listed under **Connected** with its tools and resources enabled.

[![sitetrax connected in Cursor with 24 tools and 2 resources enabled](https://docs.sitetrax.io/uploads/images/gallery/2026-11/scaled-1680-/cursor-08-connected.png)](https://docs.sitetrax.io/uploads/images/gallery/2026-11/cursor-08-connected.png)

Select sitetrax to see its tools, turn individual tools on or off, or **Logout** to remove Cursor’s sign-in.

[![Configure sitetrax dialog showing the user source, a connected local environment with a Logout button, and the list of SiteTrax.io tools](https://docs.sitetrax.io/uploads/images/gallery/2026-11/scaled-1680-/cursor-09-tools.png)](https://docs.sitetrax.io/uploads/images/gallery/2026-11/cursor-09-tools.png)

## Step 6: Check the connection

Start a new chat in Cursor and ask:

> Using SiteTrax.io, list the projects I can access. Do not create or change anything.

Cursor calls the SiteTrax.io tool and lists your projects. The count should match **Projects in scope** on the consent page and Projects in app.sitetrax.io for the same account. Then request a known equipment observation with its time, timezone, project and record link. A green status alone does not prove that the expected account is connected.

[![Cursor chat answering the project-list prompt using the SiteTrax.io tool; project details are blurred](https://docs.sitetrax.io/uploads/images/gallery/2026-11/scaled-1680-/cursor-10-verify-chat.png)](https://docs.sitetrax.io/uploads/images/gallery/2026-11/cursor-10-verify-chat.png)

## Use the result in your work

Cursor is useful when SiteTrax.io data feeds code, reports or integration work, for example:

> Using SiteTrax.io, show me the fields returned for an asset observation, then draft a CSV export script for yesterday’s gate detections at \[project\]. Do not run it.

Ask Cursor to use SiteTrax.io’s server-side counts and summaries for totals and trends rather than paging through raw records.

## Permissions, disconnecting and troubleshooting

Cursor requests both read access and `sitetrax:notifications:write`. Read access covers authorized queries and notification history. Notification access allows creating or cancelling supported alerts and digests. Confirm the exact proposed notification before creation, and review tool calls before you approve them in Cursor.

Each Cursor sign-in appears as a separate connection under Assistant Connections on the Intelligence page. Disconnecting it there stops Cursor from renewing access, and existing access ends within about an hour. To sign out from Cursor itself, use **Logout** in the sitetrax dialog. See [Account Access and OAuth](https://docs.sitetrax.io/books/ai-integrations/page/account-access-and-oauth).

- **sitetrax stays on Connecting… or shows an error:** confirm the URL is exactly `https://mcp.sitetrax.io/mcp`, then use **Reload** in the sitetrax dialog or restart Cursor.
- **The browser does not return to Cursor:** after *Authorization complete!*, switch back to Cursor manually; the server connects on its own.
- **Wrong or empty project list:** select **Logout** in the sitetrax dialog, sign in to app.sitetrax.io with the intended account, then select **Authenticate** again. Check project sharing if the list is still wrong.
- **Cursor answers without using SiteTrax.io:** confirm sitetrax is connected and its tools are enabled, and ask Cursor explicitly to use SiteTrax.io.

Authorized results are returned to Cursor and the model provider selected in Cursor. See [Troubleshooting Connections](https://docs.sitetrax.io/books/ai-integrations/page/troubleshooting-connections).