Set up the Kinds MCP server
The Kinds MCP server lets your AI assistant read your Kinds data and take actions for you, using the open MCP standard. You need a Kinds admin account and an AI assistant that supports MCP.
Before you start
- Who switches it on. An account admin. It is included in every account at no extra cost, and it is off until an account admin turns it on.
- Who connects. Any Kinds admin, once it is on. An admin who is limited to certain organizations can connect once it is on for an account they administer. That connection reaches only those organizations, and account-wide information such as billing is not part of it.
- What a connection can do. A connection acts as the person who approved it. It can never see or do more than that person can in Kinds.
When you connect, you choose one of two access levels.
- Read. The assistant can look at your Kinds data and answer questions.
- Read, create and delete. The assistant can also create assignments, send reminders and delete learners. You confirm each action before it runs.
An admin with read-only access in Kinds can only choose Read. The approval screen can narrow what the assistant asked for. It can never widen it.
Step 1: Switch it on for your account
An account admin does this once.
- Sign in to Kinds and open Settings.
- Under Features, open AI assistants.
- Turn on Allow AI assistants.
You can also open the page directly at app.kindssecurity.com/admin/settings/features/ai-assistants.
The same page shows the server address under How to connect, with a Copy address button. Other admins can open the page, but only an account admin can change the switch.
An account admin can also skip this step. If they connect an assistant while the feature is off, the approval screen offers Switch on and continue.
Step 2: Add Kinds to your assistant
Every assistant needs the same server address. The steps below show where to put it.
https://mcp.kindssecurity.com/mcpClaude (web and desktop)
If you are on a Team or Enterprise plan, an Owner of your Claude organization adds Kinds first. Then each person connects with their own Kinds sign-in.
On a Free, Pro or Max plan, or as an individual:
- Go to Customize, then Connectors.
- Select Add, then Add custom connector.
- Enter the name
Kindsand this server address, then select Continue.
https://mcp.kindssecurity.com/mcp - Leave the authentication settings as Claude detects them, then select Add.
- If the connector shows Connect, select it. Sign in to Kinds and approve (Step 3).
- To use it in a chat, select the plus button, then Connectors, and turn Kinds on.
As an Owner on a Team or Enterprise plan:
- Go to Organization settings, then Connectors.
- Select Add, then Custom. Choose Web if Claude asks for the type.
- Enter the name and the server address above, then select Continue.
- Select Add. Each person then goes to Customize, then Connectors, and selects Connect on Kinds.
Source: Anthropic, adding a custom connector.
ChatGPT
Your workspace settings can limit who may add a custom MCP server. If you do not see the option, ask your workspace admin.
- In ChatGPT on the web, go to Plugins (
chatgpt.com/plugins). - Select the plus button, then Add custom MCP server.
- Enter the name
Kinds. - Under Connection, enter this as the Server URL.
https://mcp.kindssecurity.com/mcp - Set authentication to OAuth.
- Read the warning, then select I understand and want to continue.
- Select Create as a plugin.
- Install the plugin, then sign in to Kinds and approve (Step 3).
Source: OpenAI, custom MCP server and connect to ChatGPT. OpenAI has renamed this area more than once, so your menu names may differ.
Claude Code
- In your terminal, add the server.
claude mcp add --transport http kinds https://mcp.kindssecurity.com/mcp - Start Claude Code and run
/mcp. - Select Kinds and follow the steps in your browser to sign in (Step 3).
By default the server is added for you in the current project. Add --scope user to make it available in all your projects.
Source: Anthropic, Claude Code MCP.
Cursor
- Open
~/.cursor/mcp.jsonfor all projects, or.cursor/mcp.jsonin one project. Add Kinds.{ "mcpServers": { "kinds": { "url": "https://mcp.kindssecurity.com/mcp" } } } - Save the file. Open Customize in the sidebar and make sure Kinds is turned on.
- Cursor supports OAuth for remote servers. Follow its sign-in prompt, then approve in Kinds (Step 3).
Source: Cursor, Model Context Protocol.
VS Code
- Open the Command Palette and run MCP: Add Server.
- Choose HTTP, enter the server address, then name it
kinds. - Or add it by hand to
.vscode/mcp.jsonin your workspace.{ "servers": { "kinds": { "type": "http", "url": "https://mcp.kindssecurity.com/mcp" } } } - Run MCP: List Servers, select kinds, then choose Start Server.
- When VS Code asks you to authenticate, a browser window opens. Sign in to Kinds and approve (Step 3).
Source: Visual Studio Code, MCP servers.
Any other MCP client
Use these values.
- Server address: https://mcp.kindssecurity.com/mcp
- Transport: Streamable HTTP
- Sign-in: OAuth
You do not need an API key. The client opens a browser so you can sign in to Kinds.
Step 3: Sign in and approve
After you add the server, your assistant opens a Kinds page in your browser. There is no API key.
- Sign in the way you normally sign in to Kinds: Google, Microsoft, or email with a password or an emailed link. If you do not have a Kinds account yet, select New to Kinds? on the same screen to create one.
- On the Connect an AI assistant screen, check the name of the assistant. When Kinds can verify the assistant, it shows a Verified badge and the assistant’s web address. When it cannot, it says that Kinds has not verified this app and names where approving sends access. Continue only if that is the assistant you are setting up.
- Under What it can do, choose Read, or Read, create and delete. Kinds does not pre-select the access that can make changes.
- Select Allow. Select Deny to cancel.
You are sent back to your assistant. The connection is ready.
Step 4: Try it
Ask your assistant one of these. Four read data.
- “How many of our people are overdue on training, by organization?”
- “Show click rate and report rate for the last six months.”
- “Are we covered for the frameworks we follow? Who is behind?”
- “Is our directory sync healthy? When did it last run?”
Two take action. They need Read, create and delete.
- “Send a reminder to everyone overdue on the password workshop.”
- “Remove the three people who left last week.”
When you ask for an action, this is what happens.
- Kinds works out exactly what would happen: who it reaches, what is sent, and whether it can be undone. Your assistant shows you this preview. Nothing has run yet.
- You confirm in your assistant. For some actions, such as deleting many learners, the preview asks you to type a short phrase.
- Kinds checks that nothing changed since the preview, then runs the action once.
- Kinds records it. Your assistant tells you what was done, and Kinds keeps the same line in its audit trail.
Manage connections
- See what is connected. In Settings, open Features, then AI assistants. The Connections table lists each assistant, its access level, the person who approved it, when it connected and when it was last used. An account admin sees every connection to the account. Other admins see their own.
- Disconnect one assistant. Select Revoke on its row, then confirm. It takes effect immediately. It does not wait for the assistant’s access to expire. The person can connect it again later.
- Change what an assistant can do. Connect it again from your assistant and choose the other access level on the approval screen.
- Switch it off for the whole account. An account admin turns off Allow AI assistants on the same page. Every assistant stops working for that account.
- See what was done. In Settings, open Activity, then Notifications. Each action an assistant takes appears there, with the person, the assistant and what was done.
Kinds can also switch the feature off for everyone.
What it can and cannot do
Your assistant can use more than 50 tools. The list grows over time. It can:
- Read organizations, learners, assignments, overdue learners and results.
- Read the training catalog, phishing results, dashboards and compliance reports.
- Read directory sync status, phishing templates and, for an account admin, the subscription and billing overview.
- With Read, create and delete: create or edit an assignment, send reminders, send the manager digest, change training status, delete or restore learners, and switch Clay on.
It cannot:
- Manage admins or its own access.
- Touch directory or Slack connections, or any password or key.
- Edit workshops.
- Change billing or delete the account.
- Read what learners typed privately.
- Change the audit trail.
- Launch phishing simulations or edit phishing templates.
- Create files to download. Your assistant can read the same information as data and build its own table or spreadsheet from it.
Limits and safety
- Same checks as the app. Every request goes through the permission checks Kinds already uses. A connection can never see or do more than the person who approved it. A change to that person’s role applies on the next request.
- Hourly limits. Each person has an hourly allowance. Today it is 300 lookups, 60 changes, 20 single deletions and 5 bulk deletions. The account as a whole has 2,000 per hour. The limits reset each hour.
- Short-lived access. Access passes last at most an hour and renew quietly. Disconnecting does not wait for a pass to expire.
- Previews expire. The code that goes with a preview works once, within 15 minutes.
- Your assistant asks you. The preview and the question come from your assistant. Kinds tells every assistant never to confirm for you, but it cannot see whether a person answered. Leave your assistant set to ask before it uses a Kinds tool that makes changes.
- Result sizes. Lists come back up to 50 rows at a time, and your assistant asks for more as it needs them. One request can cover at most 366 days.
- Undo for deletions. Deleted learners can be restored for 30 days.
Your data
You choose the assistant. Whatever a tool returns, such as names, email addresses and individual results, goes to that assistant and so to the company behind it, under your own agreement with that company. Kinds does not send customer data to an AI company on its own initiative through this feature. Read the Privacy Policy for how Kinds handles data.
Troubleshooting
The feature is switched off
On the approval screen it reads “AI assistants are turned off for your account.” Ask an account admin to turn on Allow AI assistants (Step 1). Then connect again. An account admin who is connecting sees Switch on and continue on the same screen.
You are not an admin
Ask a Kinds admin to connect, or ask to be made an admin.
Your Kinds access is read-only and you asked for more
Choose Read. If you need Read, create and delete, ask an account admin to change your access in Kinds, then connect again.
The assistant asked for read access only
Read, create and delete is not offered because the assistant did not ask for it. Choose Read, or set the assistant up to ask for more.
You asked for a change on a Read connection
The assistant can see the tools that make changes, but they do nothing on a Read connection. Connect it again and choose Read, create and delete.
The sign-in link expired
Start again from your assistant. If you see “Too many tries”, wait a moment first.
An hourly limit was reached
It can also say deletions, bulk deletions or lookups, or that your organization has used its hourly allowance. Wait until the time shown. Retrying sooner does not help.
The preview changed before you confirmed
Read the new preview. If it is still what you want, confirm it.
The confirmation code was used or expired
That request ran nothing. If the code was used before, the action may already have run, so check in Kinds first. Then ask again to get a new preview.
The assistant was disconnected
An admin revoked the connection, or you connected the assistant again since this session started. Connect it again from your assistant (Step 2 and Step 3).
Your account is suspended
Contact support.
A tool makes a file
Ask your assistant for the same information as data instead, or download the file from the Kinds app.
Kinds could not save the connection
Connect again from your assistant.
Help
Email support@kindssecurity.com. Tell us which assistant you use and what you saw on screen.
Read what it does in Kinds now speaks MCP, and how it compares in Security awareness training MCP servers compared.