The Oneteam connector links an AI assistant to your Oneteam environment. You then give it instructions in plain language: build a course, send a message to a specific location, set up a form or create a report on your onboarding progress.
As an organisation admin, this means work that normally takes a lot of clicking can be described in a single instruction. You don’t need any technical knowledge. You type what you want to achieve, the assistant does the groundwork and you check the result in the admin portal.
What exactly is an MCP?
A Model Context Protocol is a secure connection between the AI assistant and Oneteam. The assistant works with your own account, so it sees exactly what you see and nothing more. Everything the assistant creates or posts appears under your name in Oneteam.
The connector always works within one organisation. If you belong to more than one, the assistant first asks which organisation you want to work in.
Setting up the connector
You only set up the connector once. After that, you can use it in any conversation.
The Oneteam connector is in Claude’s connector directory.
In Claude, go to Settings > Connectors.
Search for Oneteam.
Click Connect.
Log in with your Oneteam account and give permission.
Using Claude on a Team plan? An admin of your Claude workspace first needs to add the connector via Organization settings > Connectors. After that, you can connect it yourself.
In ChatGPT and Copilot, you add the connector manually. Here’s how it works in ChatGPT.
Go to Plugins > Settings > MCPs.
Click + Add server.
Enter Oneteam as the name.
Choose Streamable HTTP as the type.
Enter https://api.oneteam.io/mcp as the URL.
Click Save.
How to give an instruction
Write out what you want to create or find out.
Name the audience if you want to limit something to specific communities or function groups.
Name the period if you want a report or a summary.
Check the result in the admin portal and ask the assistant to change anything that isn’t right yet.
The more specific your instruction, the better the result. Don’t hesitate to ask for changes if something isn’t right. The assistant can update most things afterwards.
Creating and following up on courses
This is where the connector saves the most time. The assistant can build a complete Academy course in one go, based on your description, a manual or loose notes.
Build a course with content modules and quiz modules, up to 30 modules per course and up to 30 screens per module.
Quiz questions with two to six answer options, a hint for a wrong answer and points per correct answer.
Set the estimated duration of each module.
Read the contents of an existing course.
Edit an existing course: rename modules, change the duration, rewrite the text on a screen or replace a quiz question.
Automatically translate the entire course into one or more other languages.
Check progress: who still needs to start, who is in progress, who has finished and who is overdue.
Read the feedback employees give after finishing a course, including star ratings and comments.
A new course is always saved as a draft first. You publish it yourself via the organisation dashboard > Academy.
Please note: when the assistant rewrites the text on a screen, it replaces all the content on that screen. Any images or videos on it will be removed. Add them again afterwards in the admin portal.
Tip for translating: always name every language you want the course in. If a language is already on the course but you don’t name it, it will be removed.
Example instruction: “Create a course called Working safely with three content modules about personal protective equipment and a five-question quiz. Then translate it into Polish and Dutch.”
Posting messages in the timeline
Post a message for the whole organisation, or only for specific communities and function groups.
Schedule a message for a moment in the future.
Ask for a preview first, so you can see exactly what will be posted and who will receive it.
Read and summarise the timeline, including only the messages marked as important.
Retrieve the comments on messages, for example to see how employees responded to an announcement.
Example instruction: “Write a message for the Amsterdam and Rotterdam locations about the new opening hours and schedule it for Monday at 9:00. Show it to me before you post it.”
Filling the knowledge base
Create new folders, including folders inside existing folders.
Create pages with headings, bullet points, bold, italic, underlined text and links.
Save a page as a draft first, or publish it right away.
Get an overview of all existing folders with their full path, so you can quickly find the right place.
Example instruction: “In the HR folder, create a subfolder called Leave and add a draft page with our leave policy, based on these notes.”
A new folder gets the same visibility as the folder you put it in. If you create a folder at the top level, check its visibility yourself.
Forms
Create a form with up to 50 questions.
Choose from nine question types: open text, multiple choice, checklist, dropdown, slider, number, date and time, yes or no, and file upload.
Settings such as letting people fill in the form anonymously or limiting it to specific communities or function groups.
Retrieve all submissions, or view a single submission in detail.
Example instruction: “Create an anonymous form with five questions about the workload in the kitchen on that day, only for the Kitchen staff function group.”
A new form is always saved as a draft first. Employees only see it once it’s live, and the assistant never publishes a form on its own initiative. You’ll always be asked to confirm which forms can be published.
Surveys
Create a survey with up to 50 questions: open text, multiple choice or slider.
Make the survey anonymous, limit it to specific communities or function groups and set a closing date.
Read the results, zoom in on the individual answers per question and compare answers between locations or function groups.
A new survey is always saved as a draft first. When it’s published, everyone in the audience immediately gets a push notification, and the questions can no longer be changed. That’s why the assistant always asks you to confirm first. Want to send a survey at a later moment? Schedule it in the admin portal.
Example instruction: “Create an anonymous survey about satisfaction with the schedule, with three slider questions and one open question, closing in two weeks. Show me the questions first.”
Performance reviews
Create an evaluation form based on an existing template, or with your own open questions.
Choose whether only the manager fills in the form, or whether the employee also completes a self-evaluation.
Publish the form so managers can use it.
Request reports: summary, distribution of ratings, competencies, employees and talent reviews.
Publishing doesn’t start any reviews yet and doesn’t send employees a notification.
Setting up your organisation
Setting up a new organisation, or adding a new location? The assistant can do the setup work in bulk.
Create communities, teams within communities and function groups in one go.
Retrieve the full structure of your organisation.
Add, edit or remove company values.
Invite new employees by email, straight away with the right role, communities and function groups.
Read the current invitation email first, then rewrite the invitation email and the reminder email per language, with personal fields such as the recipient’s first name and your organisation’s name. The invitation email supports formatting: bold, italic, two levels of headings and bullet points. You can also turn the logo and header banner on or off.
Create, edit or delete shortcuts. A shortcut can link to an external website, or to a form or knowledge base page in Oneteam. You choose an icon and a colour, and you can limit the shortcut to specific communities or function groups.
Change general settings: your organisation’s name, the theme colours (including for dark mode), the screen employees start on, how many days new employees get to complete their onboarding, and whether they need to introduce themselves.
Example instruction: “Create communities for our five locations and add the teams Kitchen, Service and Delivery to each location.”
Reports and statistics
Onboarding progress for the whole organisation or for a single course, with a list per employee.
User numbers: invited, registered and not yet active.
Activity over a chosen period: timeline messages, comments, high fives, private messages and shift swaps.
Statistics per community, so you can compare locations.
Charts of platform usage, for example which days of the week or which hours employees are most active, broken down by community, function group or team.
Example instruction: “Give me an overview of onboarding progress over the past quarter and show which locations are falling behind.”
What the connector can’t do yet
It’s just as important to know that you can’t currently do the following via the connector. You do these in the admin portal.
Manage employees, apart from inviting them. You can’t look up users, edit profiles, change roles or deactivate accounts via the connector.
Add images and videos. The connector only works with text.
Schedule a survey for a later moment.
Fill in ratings or start performance reviews.
Read back, edit or delete knowledge base pages.
Create or manage events.
Assign a course to an audience or give it its own deadline.
Change your organisation’s logo.
Working safely with the connector
The assistant works with your account and only sees what you’re allowed to see.
Forms, surveys and evaluation forms are always saved as drafts first and only go live once you confirm.
You can preview a message first, including the names of the groups that will receive it.
Every message that gets posted appears under your name.
If you ask for something that isn’t possible, the assistant tells you instead of doing something else.
Feel free to reach out via live chat if we can advise or help you with anything. 👉