Anthropic Clients¶

Claude adds the Qualytics MCP server as a custom connector. The steps are the same in Claude Desktop and in Claude on the web, and the connector is available in both once it is added.

On a Free, Pro, Max, or Ultra plan

You add the connector to your own account. The Free plan allows one custom connector.

1. Go to Customize > Connectors.
2. Click Add custom connector.
3. Enter a name, such as Qualytics, and the MCP server URL: https://your-qualytics-instance.qualytics.io/api/mcp/.
4. Leave the OAuth client ID and secret empty. If the dialog asks how people sign in, choose Sign in now, and for OAuth client, choose Register automatically.
5. Click Add.
6. When Claude opens the Qualytics authorization page in your browser, paste your Qualytics API token and approve the access.

On a Team or Enterprise plan

An Owner adds the connector once for the organization, and each member then connects with their own Qualytics API token. On Enterprise plans, a member whose custom role can manage the organization's libraries can also add it.

1. As an Owner, go to Organization settings > Connectors.
2. Select Add, then Custom. If Claude asks for the connector type, choose Web.
3. Enter the MCP server URL: https://your-qualytics-instance.qualytics.io/api/mcp/. Leave the OAuth client ID and secret empty.
4. Click Add.
5. Each member goes to Customize > Connectors, finds the Qualytics connector with the Custom label, and clicks Connect.
6. On the Qualytics authorization page, the member pastes their own Qualytics API token and approves the access.

Use Qualytics in a chat

Click + in the chat input, select Connectors, and turn the Qualytics connector on for that conversation. Review each tool approval request before you allow it, and use Always allow only for tools you trust.

Authentication settings cannot be changed after the connector is added. To change them, remove the connector and add it again.

Claude Code adds the Qualytics MCP server from the command line.

1. Register the server with the HTTP transport:

   claude mcp add --transport http qualytics https://your-qualytics-instance.qualytics.io/api/mcp/
   

2. Start Claude Code and run /mcp. Select the Qualytics server and follow the browser sign-in. You can also run claude mcp login qualytics from your shell.

3. On the Qualytics authorization page, paste your Qualytics API token and approve the access. Claude Code stores and refreshes the MCP tokens on its own.
4. Run claude mcp list to confirm the server shows as connected.

Do not add an Authorization header with your API token. Qualytics only accepts the browser authorization.

Choose where the server is saved

Add --scope to the claude mcp add command to choose where the configuration lives.

A project-scoped server holds only the URL, never a token, so each person authorizes with their own API token. Claude Code asks each person to approve a project-scoped server before it uses it.