---
url: "https://kindssecurity.com/docs/mcp"
title: "Set up the Kinds MCP server | Kinds Security"
description: "Connect Claude, ChatGPT, Claude Code, Cursor or VS Code to your Kinds account. Switch it on, add the server, sign in and approve."
---

# 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](https://kindssecurity.com/glossary/what-is-model-context-protocol) standard. You need a Kinds admin account and an AI assistant that supports MCP.

Server address: `https://mcp.kindssecurity.com/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.

1. Sign in to Kinds and open Settings.
2. Under Features, open AI assistants.
3. Turn on Allow AI assistants.

You can also open the page directly at [app.kindssecurity.com/admin/settings/features/ai-assistants](https://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: `https://mcp.kindssecurity.com/mcp`

### Claude (web and desktop)

On a Free, Pro or Max plan: go to Customize, then Connectors. Select Add, then Add custom connector. Enter the name `Kinds` and the server address, then select Continue. Leave the authentication settings as Claude detects them, then select Add. Select Connect if shown, and sign in to Kinds. To use it in a chat, select the plus button, then Connectors, and turn Kinds on.

On a Team or Enterprise plan, an Owner goes to Organization settings, then Connectors, selects Add, then Custom (choose Web if asked), and enters the name and address. Each person then goes to Customize, then Connectors, and selects Connect on Kinds.

Source: [Anthropic, adding a custom connector](https://claude.com/docs/connectors/custom/remote-mcp).

### ChatGPT

Your workspace settings can limit who may add a custom MCP server.

1. In ChatGPT on the web, go to Plugins (`chatgpt.com/plugins`).
2. Select the plus button, then Add custom MCP server.
3. Enter the name `Kinds`.
4. Under Connection, enter the Server URL: `https://mcp.kindssecurity.com/mcp`
5. Set authentication to OAuth.
6. Select I understand and want to continue, then Create as a plugin.
7. Install the plugin, then sign in to Kinds and approve.

Source: OpenAI, [custom MCP server](https://developers.openai.com/api/docs/guides/custom-mcp-server) and [connect to ChatGPT](https://developers.openai.com/plugins/deploy/connect-chatgpt). OpenAI has renamed this area more than once, so your menu names may differ.

### Claude Code

```
claude mcp add --transport http kinds https://mcp.kindssecurity.com/mcp
```

Start Claude Code, run `/mcp`, select Kinds and follow the steps in your browser to sign in. Add `--scope user` to make the server available in all your projects.

Source: [Claude Code MCP](https://code.claude.com/docs/en/mcp).

### Cursor

Add Kinds to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (one project):

```json
{
  "mcpServers": {
    "kinds": {
      "url": "https://mcp.kindssecurity.com/mcp"
    }
  }
}
```

Save the file and make sure Kinds is turned on under Customize in the sidebar. Cursor supports OAuth for remote servers. Follow its sign-in prompt, then approve in Kinds.

Source: [Cursor, Model Context Protocol](https://cursor.com/docs/context/mcp).

### VS Code

Run MCP: Add Server from the Command Palette, choose HTTP, enter the server address and name it `kinds`. Or add it to `.vscode/mcp.json`:

```json
{
  "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.

Source: [Visual Studio Code, MCP servers](https://code.visualstudio.com/docs/copilot/customization/mcp-servers).

### Any other MCP client

- Server address: `https://mcp.kindssecurity.com/mcp`
- Transport: Streamable HTTP
- Sign-in: OAuth

You do not need an API key.

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

1. 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.
2. 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.
3. Under What it can do, choose Read, or Read, create and delete. Kinds does not pre-select the access that can make changes.
4. Select Allow. Select Deny to cancel.

You are sent back to your assistant. The connection is ready.

## Step 4: Try it

Four requests that 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 requests that 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:

1. 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.
2. You confirm in your assistant. For some actions, such as deleting many learners, the preview asks you to type a short phrase.
3. Kinds checks that nothing changed since the preview, then runs the action once.
4. 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.
- **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](https://kindssecurity.com/privacy-policy) for how Kinds handles data.

## Troubleshooting

**The feature is switched off.** You see "AI assistant access (MCP) is turned off for this Kinds account. An account admin can turn it on in Settings." 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.** You see "Only Kinds administrators can connect an AI assistant." Ask a Kinds admin to connect, or ask to be made an admin.

**Your Kinds access is read-only and you asked for more.** You see "Your Kinds access is read-only, so an assistant you connect can read but cannot create or delete." Choose Read. If you need Read, create and delete, ask an account admin to change your access, then connect again.

**The assistant asked for read access only.** You see "This application 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.** You see "Nothing was changed. This Kinds connection is read-only. To do this, reconnect Kinds in your assistant and choose 'Read, create and delete'." 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.** You see "This link has expired. Go back to your assistant and try connecting again." Start again from your assistant. If you see "Too many tries", wait a moment first.

**An hourly limit was reached.** You see "You've used this hour's allowance for changes. It resets in about 25 minutes." It can also say deletions, bulk deletions or lookups, or that your organization has used its hourly allowance. Wait until the time shown.

**The preview changed before you confirmed.** Your assistant says that what the action would do changed since the last preview, so nothing ran. Read the new preview. If it is still what you want, confirm it.

**The confirmation code was used or expired.** You see "This confirmation code cannot be used: it expired, was already used, or was never issued." 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.** You see "This assistant is no longer connected to Kinds. Connect it again to continue." An admin revoked the connection, or you connected the assistant again since this session started. Connect it again from your assistant.

**Your account is suspended.** You see "This Kinds user is suspended." Contact support.

**A tool makes a file.** You see "This tool makes a file to download, and files are not available through this connection yet. Nothing was created." Ask your assistant for the same information as data instead, or download the file from the Kinds app.

**Kinds could not save the connection.** You see "Kinds could not save this connection, so it was ended for safety. Nothing else changed. Connect the assistant again." 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](/blog/mcp-server-for-security-awareness-training), and how it compares in [Security awareness training MCP servers compared](/blog/security-awareness-training-mcp-servers-compared).
