How to connect an AI assistant through an MCP client

To optimize your work with the system and quickly get the information you need, you can connect an AI assistant to HURMA via an MCP client. This allows the agent to work directly with your internal data: candidates, vacancies, or employees.

This functionality is available only with a plan that includes API v3 functionality, since MCP is based on the API.

To upgrade your plan, you can contact your personal manager or email [email protected]

Creating an MCP client in the HURMA system

To enable the tool and generate a link for the AI agent, follow these steps:

By default, users with the “Administrator” role can create an MCP client.

1. Go to the system settings, open the “For developers” section, and click the “Add” button and select the “MCP client” section;

2. Enter a connection name (any name, at least one character); the “Description” field is optional.

3. Information access settings: select the checkboxes for the data you allow the AI agent to read when generating responses. At least one checkbox must be selected to save the connection successfully.

4. Sensitive fields: you can grant access to some or all sensitive fields for employees and candidates, or select none.

The agent has read-only access and cannot modify or create these fields.

5. Employee access: you must select the employees who will be granted access to this connection.

Even if you are the author of this MCP connection, you still need to add yourself to this access table.

After saving, you will be able to see the created connection in the profile menu. You can create as many connections as needed and copy their URL (by clicking the connection name or opening the client settings) for further use in external agents.

In HURMA, you can track active connections. If you or other employees have successfully connected via an AI agent, the system will display the status "Connected".

Connecting to AI agents (Claude, ChatGPT, Grok)

To integrate HURMA with artificial intelligence, copy the URL of your MCP client by clicking the client name or your profile icon.

You must log in to the AI agent using the same email address that is used for your HURMA account.

Some AI clients require a paid plan or a separate mode to add MCP connectors (for example, ChatGPT's developer mode). Check your AI tool's requirements separately.

Connecting in Claude

1. Click the profile menu and select “Settings” (Settings);

2. Go to the “Connectors” section, click the “Add” button, and select “Add custom connector”;

3. Enter any name (you can use the same name as in HURMA), paste the copied URL, and click “Add“.

Connecting to ChatGPT

You need to enable developer mode to connect. This is required to establish the connection correctly and access the necessary features.

Then follow these steps to connect successfully:

1. Click the profile menu and select “Settings”;

2. Go to “Plugins” - “Browse plugins”;

3. Click the “+” icon - “Create app“, enter a name, and paste the URL from your clipboard;

Connecting in Grok

1. Go to “Plagins” and select “Connectors”;

2. Click “New connector” and be sure to select the “Custom” type;

3. Enter a name, paste the URL, click the “Attach connector” button, and wait a few seconds for the connection to be established.