Skip to main content

Using the Swif Plugin for Grok

Connect Grok to your Swif tenant and ask about your devices, employees, teams, and installed apps in plain language.

The Swif plugin for Grok connects Grok to your Swif tenant. Once it's connected, you can ask Grok about your organization's devices, employees, teams, and the apps and browser extensions installed across your fleet, in plain language. Grok answers with live data from Swif.

It works in Grok on the web and the Grok app for Mac, with the Macs, Windows, Linux, iOS, and Android devices you manage in Swif.

This plugin is designed for IT and security teams that manage their devices with Swif.

Important: The plugin can't change, lock, or wipe devices, or delete employees. For your organization's safety, the plugin can only read device data, and its only changes are adding an employee or moving one to another team. Grok makes those changes only when you ask, and only after confirming the details with you. Only your organization's data is visible.


What you can do

Devices

  • List your devices, and filter them by team, operating system, or status

  • See the apps and browser extensions installed on a device

  • Find every device that has a given app installed

Employees and teams

  • List your teams, and the employees on a team

  • Add an employee, after Grok confirms the details with you

  • Move an employee to another team, after Grok confirms the details with you. Their devices stay assigned to them.

What you can't do

  • Change device settings, or lock or wipe devices

  • Delete employees

  • Change policies or compliance settings


Requirements

Requirement

Details

Swif

A Swif UEM account

Swif API key

Created in the Swif admin console. See Public APIs: your API key.

Grok

A Grok account that can add custom connectors, on the web or in the Grok app for Mac

Keep your API key secure. Anyone with it can read your organization's Swif data, and add or move employees.


Connect Swif to Grok

  1. In Grok, click Connect apps, at the bottom of the sidebar.

  2. Scroll to the bottom of the list, and click Add a custom connector.

  3. Fill in:

    • Name: Swif

    • Type: Remote HTTPS

    • Server URL: https://mcp.swifteam.com/mcp. For a Swif workspace in the EU region, use https://mcp.eu.swifteam.com/mcp.

    • HTTP headers: Leave empty

    • Client ID: Leave empty

  4. Click Add plugin.

  5. Sign in when Grok asks. On the Swif connection page, enter your Swif API key, accept the agreement, and approve the connection.

Swif appears in Grok's sidebar. Open it, and ask a question about your devices.

You only enter your API key once. The connection stays signed in, even after a long break.

Use the right server URL. The Server URL must match your Swif region. A workspace in the EU region can't connect through mcp.swifteam.com.


Example questions

Devices

  • "List my Swif devices."

  • "How many devices are in the team named exactly 'Engineering'?"

  • "Break down the devices in the Sales team by operating system."

Apps and extensions

  • "Which devices have Microsoft Teams installed?"

  • "What apps are installed on WIN-ABC123?"

  • "What browser extensions are on Alex's laptop?"

Employees and teams

  • "List all teams in my Swif organization."

  • "List all employees in the team named exactly 'Engineering'."

  • "Add Jordan Lee, jordan@example.com, to the Sales team."

  • "Move Alex to the Marketing team."

Tips for better answers

  • Use exact team names. For example, "the team named exactly 'QA'". If several teams share a name, Grok lists them, and asks which one you mean.

  • Ask for a summary first. For large fleets, Grok gives a short summary, and offers the full list.


What data Grok can see

Data

Details

Devices

Name, operating system, owner, team, and status

Apps

Apps and versions installed on each device

Browser extensions

Extensions installed in Chrome, Edge, Firefox, and Safari

Employees

Name, email, status, and team

Teams

Team names and IDs

How Grok handles results

  • Active, enrolled devices: device lists include only active, enrolled devices, unless you ask for all of them. So Grok's count can be lower than the Swif console's, which also includes unenrolled and archived devices.

  • Large results: Grok reads results in pages, so it can cover your whole fleet.

  • Missing data: if a device hasn't reported its installed apps, app searches can't find apps on it.

Built-in safeguards

Safeguard

What happens

Confirms before changes

Grok confirms the details before it adds or moves an employee

Asks when a name matches several teams

Grok lists the matching teams, and asks which one you mean, instead of guessing

No duplicate employees

If an employee with that email already exists, Grok doesn't add them again

No made-up data

Grok won't invent employees. For example, if you ask for "5 random test employees", it asks for real names, emails, and teams.

Secure sign-in

The connection uses OAuth with PKCE. Grok never sees your API key. It uses a sign-in token from Swif instead.


Switch to another Swif tenant

If you manage more than one Swif tenant, such as an MSP:

  1. In Grok, remove the Swif connector.

  2. Add it again, and enter the other tenant's API key.

Grok then shows only the new tenant's data.


Disconnect Swif

In Grok, open Connect apps, and remove the Swif connector. Grok can no longer access your Swif data.

To stop all access immediately, you can also revoke the API key in the Swif admin console.


Troubleshooting

The connection page rejects my API key

Check that you copied the whole key, and that it hasn't been revoked in the Swif admin console. Create a new key if needed.

Grok can't connect to Swif

  • Check the Server URL: https://mcp.swifteam.com/mcp, or https://mcp.eu.swifteam.com/mcp for the EU region.

  • Check that Type is Remote HTTPS, and that HTTP headers and Client ID are empty.

Grok shows fewer devices than the Swif console

This is expected. Grok counts active, enrolled devices, unless you ask for all of them. The console also counts unenrolled and archived devices.

Grok asks which team I mean

Several teams share that name. Choose one from Grok's list, or use the exact team name.

Grok asked me to confirm before adding an employee

This is expected. Grok confirms the details before it makes any change in Swif.

An app search misses a device

The device hasn't reported its installed apps to Swif yet. Check the device's Apps tab in the Swif console.

A device setting or lock request doesn't work

This is expected. For your organization's safety, the plugin can't change, lock, or wipe devices. Use the Swif console instead.


Related resources

Swif

Grok

Did this answer your question?