AI apps & access tokens
Bring HireMike into the AI app you already use. Ask questions about your jobs and candidates in plain language, such as “Which candidates for my barista job are ready for review?” You choose the access: start with viewing information, then add permission to help with drafts, candidate updates or offer questions when you’re ready.
Go to Account → Security → Access tokens to connect an app and manage its access. Connections start with read-only access. Choose any additional permissions when you connect.
How it works
The app uses HireMike as you. It receives a permitted subset of your company's data, described below, rather than everything visible in the dashboard. Each change it makes to a candidate shows in HireMike with your name and the app's name.
There are two ways to connect:
- Connect the app (recommended). You add HireMike to the app, sign in to HireMike and choose Connect. Sign in through your browser, without copying a secret key.
- Make an access token. A token is a secret key for a tool that runs on your own computer, for example a developer tool. Most people do not need one.
Both ways appear in the same list, under Account → Security → Access tokens. You can disconnect each one there at any time.
What an AI app can read
- Your jobs: title, status, description, interview questions, knockout questions, scoring criteria and settings.
- Your candidates: name, stage, star, scores, your rating, key dates and stage history.
- The candidates who wait for your review: each deadline, and what HireMike does at it (an invitation or a rejection).
- AI interview results: how the interview ended, its length, the overall score and the score for each criterion. Also HireMike's written assessment: strengths, concerns and a summary.
- Scheduled interviews: the time, the length and the format.
- The questions that candidates asked about an offer, and your answers.
- Your credit balance, your prices, and what each job cost.
- Your Apply by Email settings: whether it is on, the company address and the permitted senders.
The app can sort a job's candidates as the board does: best score, newest, oldest or name. It can filter them by status, stage, star, score and the date they applied. It can find a candidate by part of their name, with 2 letters or more. It cannot search by email address or phone number.
The hiring reads exclude structured candidate email and phone fields, CV text, interview video and meeting links. Stored interview questions and answers are available with read access. Requested interview text is shared with the connected AI provider and may include personal information or contact details volunteered during answers. The app cannot read your private notes. Separate permission lets it create file links; see Links to a CV or an interview video.
Comparing interview answers
Ask: “Compare how these candidates answered the troubleshooting questions, quote the relevant answers, and explain the differences.” Your AI app can read interview questions and answers for candidates you can access. This uses ordinary read access, including existing valid read-only connections; it does not require Allow changes, hiring decisions or file links.
The app can list an application's interview sessions and select one. The session used for HireMike's assessment may differ from the latest attempt. Quotations should identify the candidate, interview session and recorded turn so you can check the evidence in the dashboard's existing transcript viewer.
Long transcripts arrive in pages. Each retrieval freezes the currently stored turns; the app follows the continuation until it has read the entire snapshot. If the interview continues, a fresh retrieval includes newer turns. Finishing the pages does not mean the interview finished or every planned question was answered. Continuations expire after one hour; start a fresh retrieval if one expires.
An unavailable transcript says “No interview transcript is available for this session.” An active interview says “This interview is still in progress. The transcript may be incomplete.” Failed and timed-out interviews retain their recorded state and any stored text. No missing questions, answers or timestamps are invented. Removing the member's access or revoking the connection prevents further reads, including later pages.
What an AI app can change
By default, an app reads only. It can make changes only if you tick the box when you connect it or make the token:
| Change | Can you undo it? |
|---|---|
| Star or unstar a candidate | Yes. Click the star again. |
| Add a note to a candidate | Yes. Delete the note on the candidate's profile. |
| Mark a new candidate as reviewed | No. They stay in Reviewed; there is no return-to-New action. |
| Create a draft job | Yes. Delete the draft. |
| Edit a draft job: the title, description, interview questions, knockout questions, scoring criteria, pass mark, interview type (AI or human-led) and instant start | Yes. Edit it again. |
| Add one knockout question or interview question to a draft job | Yes. Remove it in the dashboard. |
| Suggest interview questions and scoring criteria for a draft job | Nothing to undo. The app shows you the suggestions and saves nothing. |
| Switch Apply by Email on or off | Yes. Switch it back. The app cannot change the permitted senders. |
An app can edit job content only while the job is a draft. It cannot edit a published or closed job.
Use the dashboard to change AI CV screening, invitation holds, review deadlines or notification recipients. The app cannot change these settings, even on a draft.
Keep these tasks in the dashboard:
- Candidate emails and hiring decisions need their separate permissions and an approved preview, as explained below.
- Manage candidate deletion, email corrections and note deletion in HireMike.
- Publish jobs from the dashboard. An app can close a job only as part of completing a hire, with hiring permission.
- Manage credit, billing, team membership and sign-in settings in HireMike.
Each change to a candidate shows on their history with a name such as "Jane Smith via Claude (MCP connector)". Each note has the same author name.
Answers to candidates' questions
Replies are a separate permission. Tick Allow replies to candidates when you make a token, or Reply to offer questions when you connect an app. Then the app can answer a candidate's question about their offer.
You get a chance to check the wording before the candidate receives it. Answers are sent by email, so take a moment to review the preview:
- It writes the answer and shows you the email. Nothing is sent yet.
- It sends the email only after you say yes to that exact text. If the text changes, it must show you the new text first.
The preview normally lasts 15 minutes. If it expires, ask the app for a new preview before you approve the send.
Keep answers focused on the candidate’s question. Email addresses, phone numbers and links need to be removed before sending through an AI app. The answer shows on the candidate's profile like an answer you send from the dashboard.
Hiring decisions
HireMike can let an app take hiring steps for you. When connecting an app, choose Take hiring actions; when creating an access token, choose Allow hiring decisions. The box shows only when HireMike has switched this feature on for your account.
With it, the app can do these steps:
| Step | Does it email the candidate? | Can you undo it? |
|---|---|---|
| Rate a candidate (1 to 5) | No. | Yes. Rate again. |
| Record the candidate's answer to an offer, when they told you directly | No. | No. |
| Cancel a rejection whose email has not gone yet | No. | Reject again. |
| Record your own interview as completed or a no-show | No. | No. |
| Reject a candidate, with the email now, in 48 hours or in 7 days | Yes. | Until a delayed email goes, cancel the rejection. |
| Send an offer, or change an offer that the candidate has not answered | Yes. | Withdraw the offer. |
| Withdraw an offer | Yes. | No. |
| Send a held interview invitation now | Yes. | No. |
| Invite a rejected candidate again | Yes. | Reject again. |
| Send the interview invitation or the booking link again | Yes. | Nothing to undo. |
| Book, move or cancel your own interview with a candidate | Yes. | Move or cancel it. |
| Complete a hire | Only if you ask it to reject the other candidates. | No. |
Each step that emails a candidate works in two parts:
- The app shows you the email, and what else changes. Nothing changes yet.
- The app takes the step only after you say yes. If the email or the candidate changed since, it must show you the new email first.
The preview normally lasts 15 minutes. If it expires, ask for a new preview and check it again.
A few tips for reviewing these steps:
- A rejection with a delay. The candidate's booked interviews are cancelled at once. If you cancel the rejection before its email goes, HireMike restores a future booking only if its slot still has capacity. Check the candidate's History and arrange a new time if restoration failed.
- Complete hire. You cannot undo a hire. The app rejects the other candidates only if you ask it to. Before it does, it tells you how many candidates get a rejection email.
- An offer. The app uses the terms that you give it. Your email address is the contact in the offer. For offer terms entered through an AI app, leave out email addresses, phone numbers and links; your account email provides the contact address.
- Your own interview. The app uses one of your meeting types (Calendar → Meeting types) for the video link or the address. It cannot type a link itself.
- Steps that invite candidates to AI interviews can lead to paid usage. The app shows the interview price first. Sending an invitation does not itself charge your wallet; completed interviews incur the charge. Each token has a daily limit for these invitation steps.
Links to a CV or an interview video
HireMike can let an app make a link to a candidate's CV or interview video for you. When connecting an app, choose Share CV and video links; when creating an access token, choose Allow file links. The box shows only when HireMike has switched this feature on for your account.
- A link works for up to 2 hours. Check the expiry returned with the link.
- By default, only a signed-in member of your company can open it. The app passes the link to you.
- Some HireMike services can allow anyone with the link to open the file, including the AI app. Check the access returned with the link before you share it. Ask support if you are unsure which access your service allows.
- The link stops at once if you revoke it, if the token is revoked, if you leave the account, or if the candidate is deleted.
- Each link, and each time someone opens it, shows on the candidate's history.
- The link opens the original CV or recording, not a redacted version. Those files can contain contact details or other personal information even though the structured hiring tools omit those fields. An expiry or revocation stops future access through HireMike; it cannot remove a copy someone already downloaded.
Candidates are told that you can use an AI app to help you review them: on the application form, in the interview's recording consent and in the Help Centre for candidates.
Questions about how HireMike works
The app can ask HireMike's help bot how HireMike works. For example: "How do I set an invitation hold?" It is the same bot as the help bubble in HireMike, and it answers from this Help Centre.
- Every connection can ask, read-only connections too.
- HireMike help processes and stores your question and the answer. HireMike does not send your name or email address with the question.
- Keep questions general and free of personal details. Email addresses, phone numbers and links are refused before they reach the help service.
- Help answers explain the product. They cannot raise support tickets, contact anyone or collect a support request.
- The help bot's AI writes each answer, and it can make an error. Before an important step, read the Help Centre page that the answer is about.
- An answer can take up to a minute.
- You can ask a related product question in the same conversation for 30 minutes after the last answer. After that, start a new question.
Connect an AI app
In HireMike, go to Account → Security → Access tokens → Connect an AI app.
Copy the server address shown on the setup page, along with the instructions for your app. Production uses https://mcp.app.hiremike.cc/mcp; a development service can show a different address and a Development beta warning. Development and production jobs and candidates are separate. A localhost address cannot be reached by cloud apps.
Then choose ChatGPT, Claude or Another app.
Look for Remote MCP or Streamable HTTP in your app’s connection options, with OAuth for browser sign-in. These let you connect by signing in to HireMike. Your app's plan or workspace rules may limit custom connections. The remote connection needs no download or secret key.
Add HireMike in ChatGPT
- Open ChatGPT's plugins.
- Choose Add → Add custom MCP server. Some accounts show Apps instead of Plugins.
- Name it HireMike.
- Paste the server address from HireMike's setup page.
- Choose OAuth. Leave optional client credentials blank.
- Read ChatGPT's notice and confirm it. Choose Create as a plugin, then connect your HireMike account.
If you cannot add a custom server, check your plan or ask your workspace admin.
Add HireMike in Claude
- Open Claude's connectors.
- Choose Add custom connector. Some layouts put this under Add or Settings → Connectors.
- Enter the name and server address from HireMike's setup page.
- Leave optional OAuth client credentials blank. Add the connector, then choose Connect.
If Claude says your connector limit is reached, remove an unused connector or check your plan.
Add HireMike in another app
- In the AI app, add a remote MCP server.
- If the app asks for a connection type, choose Streamable HTTP or Remote MCP server.
- Enter the server address copied from your HireMike setup page (
https://mcp.app.hiremike.cc/mcpfor production). - Choose OAuth or browser sign-in. Do not add an access token or an
Authorizationheader.
An app that supports only local MCP servers cannot use the remote address.
Approve access and try your first question
- The app opens HireMike in your browser. Sign in if HireMike asks you to.
- The Connect page shows the requesting app, your company and the signed-in account. Check the return address and continue only if you recognise it and started the connection yourself. The requesting app supplies its own name.
- Leave Additional permissions unchecked for read-only access. Choose Manage drafts and candidates only if the app needs to make changes.
- Enable the separate reply, hiring or file-link permissions only when needed. Open Permission and connection details for the full scope and expiry information.
- Choose Connect to approve the selected access.
- Return to your app and select HireMike in the chat's tools.
- Ask: "List my HireMike jobs."
You can also ask: "Which candidates for my barista job need my review?" or "What is my HireMike credit balance?"
Check Account → Security → Access tokens after your first question:
| Status | What to do |
|---|---|
| Access approved | Return to the AI app and finish setup. |
| Ready for first use | Select HireMike in the app and ask your first question. |
| Connection tested | HireMike completed a tool request from the app. |
Choose Cancel to stop. No access is granted.
The connection shows in Access tokens with the name "app name (MCP connector)". It normally lasts up to 90 days; check the period shown when you connect. It expires after 7 days without use. If it expires, connect the app again.
Reconnecting an existing app connection can replace its earlier access when setup succeeds. If you add a separate connection in the app, revoke the old one in HireMike. Other apps and team members keep their connections.
Make an access token
- Go to Account → Security → Access tokens.
- In Token name, type a name that tells you where you use the token. For example: "Claude Desktop on my laptop".
- In Expires after, select 7 days, 30 days, 90 days, 180 days or 1 year. The default is 90 days.
- To let the token make changes, tick Allow changes. To let it answer candidates' questions, tick Allow replies to candidates. If you see them, Allow hiring decisions and Allow file links add those permissions.
- Click Create token.
- Copy the token (it starts with
hmpat_). HireMike shows it one time only. If you lose it, revoke it and make a new one.
Keep the token secret, like a password. Anyone who has it can use HireMike as you, within the limits on this page.
Use an access token with a local MCP client
Most customers can use Connect an AI app, with no installation or access token to manage.
If your team uses an approved local tool, your technical contact can help connect it using a token from Account → Security → Access tokens. Follow that tool’s setup instructions and use a token from the same HireMike service as your jobs and candidates.
For a local HireMike MCP connection, the two settings are:
| Setting | What to enter |
|---|---|
HM_MCP_BASE_URL |
Your HireMike application address, such as https://app.hiremike.cc, without /mcp. |
HM_MCP_TOKEN |
The full access token you copied when creating it. |
A local access token is separate from the browser sign-in used by remote AI apps. Use browser sign-in for the remote connector address rather than pasting a token there.
Treat the token like a password. Keep it in the tool’s private settings and revoke it in HireMike if it is lost or shared. If you’re unsure which connection your app needs, ask your technical contact or HireMike support.
Check the connection and start using it
Ask the app: "List my HireMike jobs." A working connection returns the jobs that you can see in the dashboard.
You can then try requests such as:
- "Which candidates wait for my review?"
- "Show the scores for the candidates for the barista job."
- "Star Alex Chen." This needs Allow changes.
- "Draft an answer to this candidate's offer question." This needs Allow replies to candidates.
For a complete list, ask the app to fetch every page. Candidate lists and review queues return up to 100 people per page. Upcoming interviews return 50 per page. A first page is not necessarily the whole list.
The app should show a preview before any step that emails a candidate. Check the candidate, the email and the other effects before you approve it.
If HireMike tools do not appear, restart the app and check the connection address. For a local tool, ask your technical contact to check its setup.
The Access tokens list
Each row helps you recognise a connection: its name, a short token prefix, creation and expiry dates, last use, and status and permission badges.
| Badge | Meaning |
|---|---|
| Active | It works. |
| Access approved | You approved access. The app has not collected its connection credentials yet. |
| Ready for first use | The app collected its credentials. No successful tool call has been recorded yet. |
| Connection tested | The app completed a successful tool call. |
| Not connected yet | You chose Connect, but the app did not finish the connection yet. If it does not finish within 15 minutes, the connection fails and HireMike removes the row. |
| Expired | Its time ran out. It does not work. |
| Revoked | You revoked it. It does not work. |
| Revoked by the connected app | The app asked HireMike to revoke its access. |
| Replaced by a new connection | You approved a new connection for the same app. |
| Expired: connection inactive | The connection went unused for 7 days. Connect the app again. |
| Revoked: password changed | You changed or reset your password. |
| Revoked: member removed | The owner removed you from the account. |
| Revoked: account deletion | The owner asked to delete the account. |
| Read only | It reads, and makes no changes. |
| Can make changes | It can also make the changes in the table above. |
| Can reply to candidates | It can also answer candidates' questions, after you approve each email. |
| Can take hiring steps | It can also take the hiring steps above, after you approve each email. |
| Can make file links | It can also make 2-hour links to a CV or an interview video. |
A token with more than one permission has one badge for each.
To change a token’s permissions or expiry, revoke it and create a replacement with the settings you need.
Disconnect an app or revoke a token
Click Revoke on the row. The app stops working at once.
Revoke access in HireMike even if you already disconnected in the AI app. Some apps, including Claude, do not tell HireMike when you disconnect there.
HireMike also revokes tokens and connections automatically:
- Change or reset your password: all your tokens and connections stop.
- The owner removes you: all your tokens and connections stop.
- The owner asks to delete the account: every member's tokens and connections stop. If the account is restored, the tokens stay revoked. Make new ones.
Each member has their own tokens. You see and revoke only yours.
Limits
These are the usual limits. Your HireMike service can set different limits. Follow any wait time in the error message.
- 10 working tokens and connections for each member.
- 10 new tokens or connections for each member in one hour.
- 120 requests each minute for each token, and 30 changes, replies or hiring steps each minute.
- 10 suggestions for a draft job each hour for each token.
- 20 steps that start an AI interview each day for each token.
- 30 file links each hour for each token.
- 20 help questions each hour for each token.
If an app reaches a limit, it must wait. It gets a message that tells it so.
Connecting, refreshing and revoking access also have protective limits. If your AI app receives a temporary rate-limit message, let it wait for the indicated retry time. This does not mean your password or access token is wrong. During a temporary service interruption, try again later. If revoking access receives a temporary error, retry it; that error does not confirm that access has been revoked. You can also revoke the connection from HireMike's account settings.
Text that candidates wrote
AI apps can help you explore applications and prepare next steps, with your judgement at the centre of the process.
Candidate names, application content and questions are information to review, not instructions for the app to follow. The same care applies to AI-written assessments and help answers. HireMike labels this material so the app can distinguish it from your requests, although AI can still make mistakes.
Check proposed actions just as you would check work prepared by a colleague. Candidate changes appear in History, and the tables above explain which can be reversed. Before an email-producing action, review the candidate, wording and other effects in the preview. HireMike requires the app to fetch that preview; take the opportunity to read it before approving the action.
If something does not work
- The app says it is read only. You connected it without Manage drafts and candidates. Revoke it and connect it again with the box ticked.
- The app says it may not reply to candidates. You connected it without Reply to offer questions. Revoke it and connect it again with that box ticked, or send the answer from the dashboard.
- The app says it may not take hiring steps. You connected it without Take hiring actions, or HireMike has not switched the feature on for your account. Take the step in the dashboard.
- The app says the help conversation has ended. More than 30 minutes went by after the last answer. Ask again, and put all the details in one question.
- The app says the help bot is not available, or did not answer in time. Try again, or ask the question in the help bubble in HireMike. Contact support if the problem continues.
- The app says it may not put contact details in a help question. The question contained a candidate's email address, a phone number or a link. Ask it again in general words.
- The app says its preview is out of date. The email, or the candidate, changed after the app showed you the email. Ask it for a fresh preview, then review the updated email before approving.
- The app says it cannot mark a candidate as reviewed. Only a candidate in the New column can be marked reviewed. A candidate who is still in HireMike's automatic steps has no column yet.
- The app says it cannot edit the job. The job is published or closed. An app edits draft jobs only.
- A local tool will not start. Ask the person who set it up to check the installation and connection settings. You can still use Connect an AI app for a supported remote app.
- The remote connection fails before HireMike asks you to approve. Check that the server address is
https://mcp.app.hiremike.cc/mcpand that your app supports remote MCP with browser sign-in. Contact support if the problem continues. - The app shows the wrong jobs or company. Revoke the connection and connect again with the correct HireMike account. Check the company on the approval page.
- The app says HireMike refused the token. The connection may have expired or been revoked. Disconnect HireMike in the app, then connect it again. For an access token, make a new one.
- The app says two-factor setup is necessary. Your company requires two-factor authentication. Set it up in HireMike first. See Company, account, team & email templates.
Related: Company, account, team & email templates · Managing candidates · Creating a job