> **Building with AI coding agents?** If you're using an AI coding agent, install the official Scalekit plugin. It gives your agent full awareness of the Scalekit API — reducing hallucinations and enabling faster, more accurate code generation.
>
> - **Claude Code**: `/plugin marketplace add scalekit-inc/claude-code-authstack` then `/plugin install <auth-type>@scalekit-auth-stack`
> - **GitHub Copilot CLI**: `copilot plugin marketplace add scalekit-inc/github-copilot-authstack` then `copilot plugin install <auth-type>@scalekit-auth-stack`
> - **Codex**: run the bash installer, restart, then open Plugin Directory and enable `<auth-type>`
> - **Skills CLI** (Windsurf, Cline, 40+ agents): `npx skills add scalekit-inc/skills --list` then `--skill <skill-name>`
>
> `<auth-type>` / `<skill-name>`: `agent-auth`, `full-stack-auth`, `mcp-auth`, `modular-sso`, `modular-scim` — [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# JumpCloud Directory

This guide helps administrators sync their JumpCloud directory with an application they want to onboard to their organization. Integrating your application with JumpCloud automates user management tasks and ensures access rights stay up-to-date.

This registration sets up the following:

1. **Endpoint**: This is the URL where JumpCloud sends requests to the onboarded app, acting as a communication point between them.
2. **Bearer Token**: Used by JumpCloud to authenticate its requests to the endpoint, ensuring security and authorization.

These components enable seamless synchronization between your application and the JumpCloud directory.

1. ## Create an endpoint and API token

   Open the Admin Portal and select the "SCIM Provisioning" tab. A list of Directory Providers will be displayed. Choose "JumpCloud" as your Directory Provider. If the Admin Portal is not accessible from the app, request instructions from the app owner.

   ![SCIM Provisioning Setup](@/assets/docs/guides/scim-integrations/jumpcloud-scim/1-select-jumpcloud.png)

   ![SCIM Provisioning Setup](@/assets/docs/guides/scim-integrations/jumpcloud-scim/1-2-scimconfigs.png)

   This action will generate an Endpoint URL and Bearer token for your organization, allowing the app to listen to events and maintain synchronization with your organization.

2. ## Add a new application in JumpCloud

   Go to the JumpCloud Admin Portal > SSO Applications and click on "+ Add New Application."

   ![Add New Application](@/assets/docs/guides/scim-integrations/jumpcloud-scim/2-add-new-app.png)

   Create a custom application by trying to do an non-existent application search.

   ![Application Selection](@/assets/docs/guides/scim-integrations/jumpcloud-scim/3-custom-integration.png)

   Click "Next" and choose the features you would like to enable. Since your application wants to provision new users and user updates from JumpCloud, select "Export users to this app (Identity Management)"

   ![Feature Selection](@/assets/docs/guides/scim-integrations/jumpcloud-scim/4-export-users.png)

   Finally, enter the general info such as display name (this example uses "YourApp") and click "Save Application"

   ![Successful addition](@/assets/docs/guides/scim-integrations/jumpcloud-scim/5-success-app-creation.png)

3. ## Configure provisioning settings

   Click on "Configure Application" and proceed to configure the application settings. This opens a modal with "Identity Management" selected. Enter the Endpoint URL and Bearer Token provided in the Step 1.

   ![Configure Application Settings](@/assets/docs/guides/scim-integrations/jumpcloud-scim/6-scim-config-page.png)

4. ## Configure group management

   JumpCloud uses groups as the primary way provision users to your application.

   ![Provisioning Settings](@/assets/docs/guides/scim-integrations/jumpcloud-scim/7-group-management.png)

   Click "Activate" and then "Save".

5. ## Assign users and groups

   To assign users to the newly integrated application:

   ![User Assignment](@/assets/docs/guides/scim-integrations/jumpcloud-scim/8-group-assigned.png)

1. Go to "SSO Applications" and select the application you created. This opens an Modal. Select the User Group and click on "Save".
2. Click on the "User Groups" tab and select the apps you want to assign to this group of users.
3. If you don't have groups you can create one from "User Groups" tab. In this example, we have created a group called "YourApp Users" and assigned the "YourApp" app to it.
4. Click on "Save Group" to save the changes.
5. Now try adding a user to the group. If you don't have users, you can create one from "Users" tab.
**Tip:** Make sure to organize your users into groups for easier management and assignment of permissions.

6. ## Group based Role Assignment Configuration

   To automatically assign roles to users based on their group membership, configure appropriate group to role mapping in the SCIM Configuration Portal.

7. ## Verify successful connection

   After completing these steps, verify that the users and groups are successfully synced by visiting Users and Groups tab in the Admin Portal.

   ![Verification Process](@/assets/docs/guides/scim-integrations/jumpcloud-scim/9-synced-user.png)
**Note:** When an group is disassociated from an app in JumpCloud ("YourApp"), JumpCloud sends an group update event that unassigns all the group users to your app. However, the group association is not removed automatically.

---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |