Skip to main content

Connecting Definely to Claude

Set up Definely's MCP connector in Claude, for administrators and individual users, including the Cowork plugin, mobile use and Claude-specific troubleshooting.

For what the connector does, the full list of tools, and general troubleshooting, see Definely's MCP Connector.

Requirements

  • An active Definely licence

  • A Definely account with valid credentials (the email address associated with your Definely licence)

  • Claude access, via Claude.ai (web), Claude Desktop, or the Claude mobile app

How to Connect: For Administrators

The Definely Connector in the Claude Connector store is configured for the UK region by default. In the future, this will be updated to automatically store documents in the region where your Definely tenant is located. In the meantime, please use the appropriate section below for your location.

Enabling document uploads (required, all regions)

When you upload a document through the Definely Connector, Claude passes the file directly to your organisation's Definely storage bucket. If your organisation's Claude network policy blocks that host, uploads fail with an error such as host_not_allowed for an amazonaws.com address, or documents appear to upload but never process.

The upload address is specific to your Definely tenant, so you only need to allow your own bucket rather than all of Amazon S3. Contact your Definely account manager or Definely support to get the upload hostname for your tenant.

A Claude Owner or Admin needs to allow this once:

  1. Go to claude.ai/settings/capabilities (searching "code execution" in the settings search jumps you there).

  2. In the Code execution section, make sure Allow network egress is turned on.

  3. Open the Domain allowlist dropdown. If it is set to Package managers only, individually added domains will not take effect: switch to a mode that permits added domains, or All domains if your security policy allows.

  4. Add your tenant's upload hostname (provided by Definely) to the allowlist. If your allowlist still contains the older s3.amazonaws.com entry, you can remove it once the new entry is in place.

  5. Save.

  6. Start a brand-new conversation and retry the upload. Network policy is fixed when a session starts, so existing conversations will not pick up the change.

This is a one-time organisation-level setting. Individual users do not need to do anything.

MCP Connector (UK)

Adding Definely to your organisation's connector catalogue ensures it appears in every user's connector list automatically, without them needing to search the store.

  1. Go to Admin Settings → Connectors

  2. Click Browse connectors

  3. Find Definely in the catalogue

  4. Click Add to your organisation

Once added, all users in your organisation will see Definely in their personal connector list. Each user still needs to click Connect and sign in with their own Definely credentials (see the For Users section below).

MCP Connector (US)

For US-based customers, an organisation admin needs to add Definely as a custom connector and deploy it to their Claude users.

  • In the Claude admin console, go to Connectors

  • Click the + button and select Add custom connector

  • Enter the following details:

    • Name: Definely US

    • URL: https://mcp.us.definely.com

  • Click Add

  • Deploy the connector to the relevant users in your organisation

Once deployed, individual users will see Definely US in their connector list and can sign in with their Definely email credentials. The connector is then available across all their Claude sessions, including on mobile.

MCP Connector (other regions)

For customers outside the UK and US, contact your Definely account manager to confirm the correct connector URL, then follow the same custom connector steps as above.

Definely Plugin (Cowork)

The Definely Plugin adds pre-built Skills (guided workflows for common tasks like proofreading, issues lists, and structural reviews) on top of the connector's tools. It is currently only available in Claude Cowork on Desktop.

To deploy the plugin to your organisation:

  1. Obtain the Definely Plugin file (.zip) from your Definely account manager

  2. Open Claude Desktop and go to Organisation settings → Plugins

  3. Click Add plugins and select Upload a file

  4. Upload the Definely Plugin .zip file

  5. Set the installation preference for the plugin:

  • Installed by default: automatically installed for all users (users can uninstall)

  • Available for install: listed in the plugin catalogue for users to install themselves

  • Required: automatically installed for all users and cannot be uninstalled

  • Not available: hidden from the catalogue (useful for staging)

Enterprise admins can also override installation preferences for specific groups, for example auto-installing the plugin for the Corporate team while making it optional for others.

How to Connect: For Users

MCP connector

  1. Open Claude (desktop, web, or mobile app)

  2. Go to Customise → Connectors

  3. Find Definely in the connector list

  4. Sign in with your Definely email credentials

  5. Once connected, all Definely tools are immediately available in your Claude conversations

Tip: You only need to connect once. After signing in, the connector is available across all your Claude sessions, including on mobile.

Definely Plugin

Note: The Definely Plugin must be enabled by your IT team and is currently only available in Claude Cowork.

  1. Open Claude (desktop) and navigate to Cowork.

  2. Go to Customise → Organisation Plugins.

  3. Click the + button, then under Plugins → Your Organisation, select Definely.

  4. If you don't see Definely listed under Your Organisation, contact your IT team.

  5. Click Install.

The skills in the plugin take care of the upload and preparation steps for you in the background.

If you want to use Definely Skills in Claude chat, you need to manually add the skills. Contact your IT team to get the Definely skills.

Using the Connector on Mobile

The Definely Connector works on the Claude mobile app (iOS and Android). This means you can review documents, run issues lists, and generate reports on the go, without needing your laptop.

Example scenario: You are on a train heading home. A senior partner emails you asking for a review of a contract. You open the Claude mobile app, upload the document from the email attachment, and ask for an issues list. Within seconds you have a structured report you can share back.

If you also have a Gmail or Outlook connector enabled in Claude, you can ask Claude to read the email directly and combine the instructions from the email with the Definely analysis, all from your phone.

Combining with Other Claude Connectors

The Definely Connector becomes even more powerful when used alongside other Claude connectors:

  • Gmail / Outlook: ask Claude to read an email from a colleague, extract their instructions, and combine them with a Definely issues list or proof report

  • Google Drive: point Claude at a folder in your Drive and run bulk Definely analysis across all documents in it

  • Other integrations: any connector available in Claude can be combined with Definely in a single conversation

Tips for Using Definely in Claude

  1. Combine with Claude's drafting ability: after Definely identifies an issue, ask Claude to suggest revised drafting.

  2. Use it on mobile: the Connector works on the Claude mobile app, so you can review documents on the go.

  3. Combine connectors: if you have Gmail or Google Drive connected, you can pull in email instructions or process entire folders alongside Definely analysis.

For tips that apply in any assistant, see Definely's MCP Connector.

Troubleshooting

host_not_allowed for an amazonaws.com address, or documents upload but never process Your Claude network policy is blocking the upload host. Check that your tenant's upload hostname is on the allowlist (an older s3.amazonaws.com entry no longer covers it). See Enabling document uploads above. Remember to retry in a new conversation.

Definely is missing from my connector list Ask your Claude admin to add Definely to your organisation's connectors (UK) or deploy the custom connector (US and other regions), as described above.

For all other issues (licensing, permissions, authentication, tools not appearing), see the troubleshooting section in Definely's MCP Connector.

Related Articles
Did this answer your question?