Skip to main content
Integrations

AI integration (MCP)

Use Skoop in your AI assistant, such as ChatGPT, Claude, Mistral, Gemini or Copilot. Here's how to connect Skoop via MCP in a few minutes.

Written By Kjell

Last updated About 1 hour ago

With Skoop's MCP integration, your AI assistant works directly in your Skoop account. That can be ChatGPT, Claude, Mistral Le Chat, Gemini or a Copilot agent. Ask how your teams are doing, prepare a 1:1 based on someone's profile or set up a new flow, without switching tools. The assistant only sees and does what you are allowed to see and do in Skoop.

What is MCP?

MCP stands for Model Context Protocol. It's an open standard that lets AI assistants talk to other apps securely. Skoop has its own MCP server. Once you connect it to your AI assistant, the assistant can look up your data in Skoop and, when you ask, make changes for you.

You only need one address, the same for every assistant:

  • MCP server URL: https://app.skoophr.com/mcp

  • Name: Skoop

You log in with your own Skoop account (OAuth). You never give the assistant an API key or password.

What you'll need

  • HR permissions in Skoop. Only employees with a role that has HR permissions, such as HR manager, can connect Skoop to an AI assistant. Read more in Roles in Skoop.

  • AI assistants are turned on for your organization. An HR manager turns this on or off in Settings, Company, Security & Privacy, under AI assistants.

  • An active Skoop license for your organization.

  • Two-factor authentication, if your organization requires it and you log in with a password. Do you log in with Google, Microsoft or Teams? Then you don't need it. Read how to set up two-factor authentication.

  • An AI assistant that supports MCP servers with OAuth. Which plans allow this is up to the provider of your assistant.

Connect Skoop to your AI assistant

You'll also find the steps for your assistant in Skoop itself. Log in via app.skoophr.com, click your name in the bottom left, choose Settings and then AI assistants. There's a tab per assistant with the URL and name ready to copy.

ChatGPT

  1. Go to chatgpt.com/plugins.

  2. Choose + and then Add custom MCP server.

  3. Paste the MCP server URL https://app.skoophr.com/mcp and give it the name Skoop.

  4. Choose OAuth, select I understand and want to continue and choose Create as a plugin.

  5. Install the plugin and follow the steps in Log in and choose your organization below.

Claude

  1. In Skoop, under AI assistants, open the Claude tab and click Add Skoop to Claude. Claude opens "Add custom connector" with the name and URL already filled in. If it doesn't, go to Settings, then Customize and then Connectors in Claude, click + Add, choose Add custom connector and enter the name and MCP server URL yourself.

  2. Click Continue. Claude checks the connection with Skoop.

  3. Leave "Sign in now" and "Register automatically" selected and click Add.

  4. You see "You're not connected to Skoop yet." Click Connect and follow the steps in Log in and choose your organization.

  5. Then, in a new chat, click +, open Connectors and switch on Skoop.

Using Claude Team or Enterprise? Then an Owner of your Claude organization first adds Skoop once via Organization settings, Connectors, Add, Custom, Web, with the same name and MCP server URL. After that, every HR manager connects their own Skoop account via Customize, Connectors, Skoop, Connect. Find more in Claude's help articles.

Mistral Le Chat

  1. Go to chat.mistral.ai and open Connectors in the sidebar.

  2. Choose Add Connector and then the Custom MCP Connector tab.

  3. Paste the MCP server URL https://app.skoophr.com/mcp and give it the name Skoop.

  4. Choose Connect and follow the steps in Log in and choose your organization.

Gemini

Custom apps in Gemini only work with a personal Google account in the United States.

  1. Go to gemini.google.com/apps or via Settings, then Connected Apps.

  2. Choose Add a custom app.

  3. Paste the MCP server URL https://app.skoophr.com/mcp.

  4. Choose Next and follow the steps in Log in and choose your organization.

Microsoft Copilot Studio

  1. Go to copilotstudio.microsoft.com and open Tools in your agent.

  2. Choose Add a tool, then New tool and then Model Context Protocol.

  3. Paste the MCP server URL https://app.skoophr.com/mcp, give it the name Skoop and the description Skoop, the HR platform of your organization.

  4. Choose OAuth 2.0, then Dynamic discovery, and choose Create and then Next.

  5. Choose Create a new connection and follow the steps in Log in and choose your organization. Then choose Add to agent.

Another AI assistant

Does your assistant support MCP servers with OAuth? Then add a custom MCP server or connector with the MCP server URL https://app.skoophr.com/mcp. Skoop registers the assistant automatically, so you don't need to enter a client ID or secret.

Log in and choose your organization

  1. Skoop opens in your browser. Log in if Skoop asks you to.

  2. Do you have access to more than one organization? Then choose under Organization where the assistant may work. One connection always works in one organization.

  3. Read the three boxes under Before you connect and tick them:

    • I recognize this application and where it sends me.

    • It can read employee data, including sensitive details, and act on my behalf.

    • Skoop cannot control what this application does with the data it reads.

  4. Click Authorize. You return to your assistant.

That's it! In Skoop, the assistant now shows up in Settings, AI assistants, under Connected assistants.

It's best to connect via the website or desktop app of your assistant. After that, most assistants also let you use Skoop in their mobile app, with the same account.

What can your AI assistant do with Skoop?

Through the MCP server, your assistant reads your data in Skoop and, when you ask, can create, update or delete things for you. A few examples to get started:

  • "How are my teams being followed up? Who haven't I talked to in six months?"

  • "Prepare my 1:1 with Sarah based on her profile."

  • "Summarize the results of our latest pulse survey and compare the teams."

  • "Schedule a 30 minute 1:1 with Tom next week at a time when we're both free."

  • "Create an onboarding flow for new developers with a check-in after one week, one month and three months."

  • "Add a note to Lisa: she gave a really strong client presentation."

Which MCP tools read, and which change something?

Skoop's MCP server gives your assistant separate tools to read, create, update and delete.

Read only

  • Employees and their profile: notes, reviews with their submitted answers, reports of 1:1 conversations and assessments per competency

  • Free time in employees' connected calendars

  • Teams, and how the teams you manage are being followed up

  • Tags and the job framework: job titles, levels, job title profiles and competencies

  • Goals, tasks, flows and their steps

  • Templates, the template library, chapters and questions

  • Campaigns and their results, reviews and who fills them in

  • Conversation types and notes

Create and update

  • Create and update employees, and change their tags

  • Invite an employee. Skoop then sends an invitation email.

  • Create and update teams, tags and the job framework

  • Create and update goals, tasks, flows and steps

  • Create and update templates, chapters and questions, including a template's language

  • Create campaigns, rename them or move their deadline. Before the assistant creates a campaign, it shows you a full proposal and waits for your approval.

  • Create reviews in a campaign and ask extra colleagues to fill in a 360 review or instant feedback. If the review was already sent, those colleagues are notified right away.

  • Schedule and update 1:1 conversations. Skoop adds the appointment to the participants' connected calendars.

  • Create and update conversation types and notes

  • Change the language of your own Skoop account

Delete or archive

  • Tags, job titles, competencies, competency categories, competency levels and the expected competencies of a job title

  • Goals, tasks, questions, conversation types and notes

  • Archive an employee, or bring them back from the archive

Your assistant cannot delete employees, campaigns or reviews.

Whatever your assistant creates, changes or deletes really happens in your Skoop account, just as if you did it yourself. Most assistants ask for your permission before such an action, unless you always allow it. So read your assistant's proposal carefully before you confirm.

Your assistant only sees what you can see

The MCP server works with your account and your permissions in Skoop. Anything you can't see or do in Skoop, your assistant can't either. An anonymous campaign, for example, never shows who answered what, not even to your assistant.

If you lose your HR permissions, get archived, or an HR manager turns off AI assistants, your assistant loses access right away.

Switch organization

Do you work in more than one organization? In Skoop, go to Settings, AI assistants. Under Connected assistants, pick another organization for your assistant and then start a new chat.

Disconnect

  • In Skoop: go to Settings, AI assistants, click the trash icon next to the assistant (Disconnect) and confirm. The assistant loses access to Skoop right away.

  • In your assistant: remove the Skoop connector, plugin or app in your assistant's settings.

  • For the whole organization: an HR manager turns off AI assistants in Settings, Company, Security & Privacy. All connected assistants are then disconnected right away.

Privacy and your data

  • What your assistant reads in Skoop through MCP is sent to the provider of that assistant, such as OpenAI, Anthropic, Mistral, Google or Microsoft, to answer your question. Skoop has no control over what the assistant does with that data. The terms of your plan with that provider and the agreements within your organization apply.

  • You log in on Skoop itself. You never share your password with the assistant. The assistant only gets access to the organization you choose.

  • Skoop stores which assistant is connected to which organization, and the access keys of that connection. When you disconnect, Skoop deletes those keys right away.

  • Read how Skoop handles personal data in our privacy policy.

FAQ

That page only shows up if you can connect Skoop in at least one organization. You need HR permissions, AI assistants have to be turned on and the organization needs an active Skoop license.

"Only HR managers can use Skoop in an AI assistant." You don't have HR permissions in that organization. Ask an HR manager for them.

"AI assistants are turned off for this organization." Ask an HR manager to turn on AI assistants.

"This organization has no active Skoop license." Contact whoever manages your Skoop subscription.

Your organization requires two-factor authentication. Turn it on in Skoop and connect again. Read how to set up two-factor authentication.

Not every plan allows custom MCP servers or connectors. In a business account, an admin sometimes has to allow or add them first, as with Claude Team and Enterprise. Check your assistant's documentation or ask your IT admin.

Check that Skoop is switched on in your chat, for example in Claude via + and Connectors. Did you just switch organization? Then start a new chat.

Questions? Feel free to open a chat or email support@skoophr.com!

It's that simple with Skoop 💜