Managing AI Assistants

Users can connect an AI assistant such as Claude, ChatGPT, or Cursor to Hinsley through MCP. The assistant then reads, and with write access changes, the data that the user can see. This page covers the settings that account admins use to control these connections. To connect an assistant yourself, see Connecting AI Assistants.

Everything an assistant reads from Hinsley goes to that assistant's AI provider, for example Anthropic for Claude or OpenAI for ChatGPT. That provider's terms and data policies apply to it.

Turn On AI Assistant Access

AI assistant access needs a paid plan. Only account admins can change this setting.

  1. Click your avatar in the top-right corner. In the Account Admin section, click Settings.
  2. Under AI Assistant Access, select who can connect an assistant:
    • Disabled - No one can connect an assistant. This is the default.
    • Admins only - Only account admins can connect an assistant.
    • Everyone - Every user on the account can connect an assistant.
  3. Click Save.

When you set Disabled, Hinsley disconnects every assistant that your account's users connected. If you turn access on again later, each of them must connect their assistant again. The same happens to an analyst when you change the setting to Admins only, and to an admin who stops being an admin. API tokens that users created for AI tools are revoked too.

A collaborator from another account who works on your analyses connects through their own account. While your setting is not Everyone, their assistant cannot reach your analyses. When you set Everyone again, it can reach them again without a new connection.

If the account moves to the free plan, connected assistants stop working.

Limit Which Assistants Can Connect

By default, Allowed AI Assistants is set to All assistants, and any assistant can connect. To allow only some assistants:

  1. Click your avatar. In the Account Admin section, click Settings.
  2. Under Allowed AI Assistants, select Only allowlisted assistants.
  3. Under Allowlisted assistants, tick each assistant that you allow, such as Claude or ChatGPT.
  4. To allow an assistant that is not in the list, enter it under Other Allowed Assistants, one per line. Enter the web address that the assistant returns to after it connects, such as assistant.example.com, or the link of a desktop app, such as myapp://.
  5. Click Save. The list must hold at least one assistant.

When you save the list, Hinsley disconnects each assistant that is not on it. Users then see This assistant is not allowed when they try to connect one.

Hinsley identifies an assistant by the address it returns to, not by its name, because an assistant chooses its own name. Cursor and Visual Studio Code return to an address on the user's own computer, and Hinsley cannot tell which app on the computer received it. So when you allow Cursor or Visual Studio Code, you also allow other tools on the user's computer, such as Claude Code.

Claude allows the Claude web and desktop apps, which return to claude.ai or claude.com. Claude Code signs in on the user's computer, so it needs Tools on the user's computer.

The list also applies to collaborators from other accounts: their assistants can reach your analyses only if your list allows them. The list does not apply to an API token that a user gives to a tool.

If you select All assistants again, Hinsley keeps the list but does not apply it. The list is applied again if you select Only allowlisted assistants. Assistants that the list disconnected do not come back: their users must connect them again.

Block AI Assistants From One Analysis

An account admin can keep every AI assistant away from any analysis in the account:

  1. Click your avatar, click Team in the Account Admin section, and then click Analyses in the sidebar.
  2. Click Block next to the analysis, then confirm.

The creator of an analysis can also block it from the analysis's Settings. See Keep Assistants Away From One Analysis.

A blocked analysis, and its questions, scenarios, drivers, and evidence, are hidden from every assistant at once, including the assistants of collaborators from other accounts. To allow assistants again, click Unblock.

Monitor Assistants in Your Account

Click your avatar, click Team in the Account Admin section, and then click AI Assistants in the sidebar. The Settings button on this page opens the settings above.

  • Connections lists each connected assistant with its user, access level, the date it connected, when it was last active, and when it expires. This includes API tokens that users created for AI tools. Click Disconnect to stop one at once. For an API token, Disconnect revokes all of that user's AI assistant tokens. Below the list, History shows the latest connections, disconnections, and setting changes.
  • Activity lists each request that an assistant made in the last 90 days: the user, the assistant, the tool it used, and the IDs of the records that it asked for and received. Filter by user, tool, or record ID, and click Export CSV to download the list.

A connection ends 90 days after the user connected it, or sooner if the assistant does not use Hinsley for 30 days.