company logo

Hurma | Help Center

Go to HURMA
Hurma Academy UkraineLinkedinFacebookYouTubeInstagram
All collectionsIntegrations & APIAI Agent IntegrationHow to connect an AI assistant through an MCP client

How to connect an AI assistant through an MCP client

AI assistant

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.

info icon
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:

info icon
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;

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

  1. 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.

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

warning icon
The agent has read-only access and cannot modify or create these fields.
  1. Employee access: you must select the employees who will be granted access to this connection.

info icon
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.

warning icon
You must log in to the AI agent using the same email address that is used for your HURMA account.
info icon
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);

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

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

Connecting to ChatGPT

info icon
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”;

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

  1. 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”;

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

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

What HURMA MCP can do

Once connected, the assistant gets access to tools for reading and analyzing data in the following sections:

Candidates

Find and filter candidates; view profiles, experience, skills, and notes; group by status, source, or job opening

Job openings

Get a list of vacancies by status; view details and pipeline stages; find vacanciea with no active candidates or a long time in a stage

Employees

Search for employees and view their profiles, tenure, and reporting structure - within your access permissions

Absences

View absence requests and approval statuses for a selected period

Analytics

Get summaries and metrics for candidates, jobs, recruiters, and the funnel for quick analysis

warning icon
Initially, all tools work in read-only mode: the assistant finds, compares, and summarizes information, but does not edit or delete anything.

Example prompts

Not sure where to start? Just ask the assistant:

“How can you help me with HURMA?”

Below are examples of real prompts, grouped by task.

Quick overview of the hiring situation

  • “How many open positions do we have?”

  • “How many candidates are under consideration for the Product Manager position?”

  • “Why did we reject Oksana Karpenko ([email protected])?”

  • “How many positions are currently assigned to each recruiter?”

  • “Give me a list of positions that have been open for more than 30 days.”

  • “Which candidate sourcing channels were the most effective in 2026?”

Candidate search

  • “Find all candidates who have worked with React and live in Poltava.”

Analysis and summaries

  • “Which recruiter has the highest rejection rate after the technical interview?”

  • “Analyze how many employees resigned during their probationary period in 2023–2025, and show the ratio (%) compared to those who successfully completed it.”

  • “What is the average length of service of employees by team?”

  • “Prepare a list of questions for candidate Ivan ([email protected]) for the Product Manager position.”

Employee data

  • “Show employees whose birthday is next month.”

  • “Show employees who completed their probationary period in May.”

  • “Give me a list of employees with more than 1 year and 6 months of service in the format: full name, length of service (years, months, days), link to their profile in HURMA.”

  • “Which employees will be absent next week?”

The assistant accesses current HURMA data and returns an answer immediately. The final decision always remains yours.

Did this answer your question?
😞
😐
😁