Prerequisites
- An MCPJam organization with enterprise SSO and provisioning enabled.
- An Okta administrator who can add applications, assign users and configure provisioning.
- Organization-specific SSO and provisioning setup links from your MCPJam contact. Keep their credentials private.
- Your users’ email domain verified for your MCPJam organization. Your MCPJam contact helps configure this before the pilot.
- A pilot user with a work email address in that domain.
Supported features
Configuration steps
Complete SAML setup and a pilot sign-in before enabling SCIM provisioning.Before you begin: open your organization’s setup portal
MCPJam uses a separate, organization-specific setup portal for your identity provider configuration. Signing in to the MCPJam application as an organization admin does not itself open this portal.- Contact [email protected] with your MCPJam organization name and the work email address of the Okta administrator who will configure SSO. Request an SSO setup invitation for that organization. Do not send passwords, API tokens or client secrets.
- Open the setup invitation sent to that administrator. Check that it is for the intended MCPJam organization, then choose Okta SAML.
- Keep the portal open alongside your Okta Admin Console. The portal provides the MCPJam service-provider values used below. Enter your Okta application’s Metadata URL in this portal to connect your Okta organization to MCPJam.
- Complete SAML setup and verify a pilot sign-in. Then request the provisioning setup invitation for the same organization to obtain its SCIM endpoint and bearer token.
1. Add MCPJam from the OIN catalog
- In the Okta Admin Console, open Applications → Applications.
- Select Browse App Catalog, search for MCPJam, and open its listing.
- Select Add Integration, enter an application label and continue.
- Open the SSO setup link supplied by MCPJam and select Okta SAML.
- Copy your complete SP Entity ID into the integration’s SP Entity ID field. The integration constructs the SAML ACS URL from this value.
- For SCIM Base URL, use only the directory identifier following
/scim/v2.0/in your provisioning endpoint. Obtain this from your organization-specific provisioning setup link. It is not the bearer token. - Save the integration. Use only the values issued for your organization; identifiers are case-sensitive.
2. Complete SAML configuration
- Open the application’s Sign On tab and select SAML 2.0 if prompted.
- Use the user’s work email as the application username and SAML Name ID.
- Under Attributes (Optional), configure the immutable user identifier:
add
oktaUserIdwith valueuser.getInternalProperty("id"). - Ask your MCPJam contact to map this connection’s IdP ID to
oktaUserId. Do this before the first test sign-in. - Copy the app’s Metadata URL from Sign On to the MCPJam SSO setup portal and complete the connection setup.
- Under Assignments, assign the pilot user. Test the SP-initiated and IdP-initiated flows below before assigning the rest of the team.
3. Enable SCIM provisioning
- Open your MCPJam provisioning setup link and choose Okta. Copy the directory identifier into SCIM Base URL in the app’s general settings if not already configured. The resulting endpoint must match the full SCIM endpoint shown by the setup portal.
- In the Okta app, open Provisioning → Integration → Configure API Integration and enable API integration.
- Paste the setup portal’s bearer token into API Token. Paste only the
token; do not add
Bearer, and do not paste the directory identifier. - Select Test API Credentials. Save only after the test succeeds.
- Open Provisioning → To App, select Edit, and enable Create Users, Update User Attributes and Deactivate Users. Save.
- Keep password synchronization disabled. Users authenticate through SAML.
4. Check profile mappings
Use the following identity fields. Additional business-profile attributes such as department, manager, title, postal address and telephone number are not required by MCPJam.active state through lifecycle operations. The server
returns the SCIM id; do not manually replace it. Preserve identifiers and
schema-required attributes maintained by the connector.
Keep the username and work email consistent. Contact MCPJam before changing a
provisioned user’s email or domain, so account linking and domain management
can be checked.
5. Test the user lifecycle
- Assign a pilot user under Assignments. Verify successful provisioning in Okta and sign in to the intended MCPJam organization.
- Change the pilot user’s given or family name in Okta. Verify the update in the connected directory; the updated name should appear after a fresh login.
- Unassign the pilot user from the provisioning app. Verify that they lose access to the MCPJam organization, including from an existing session.
- Reassign the user and verify that they can authenticate and access the organization again.
SP-initiated SSO
- Open MCPJam in a private browser window.
- Select Sign in and enter the assigned user’s work email address.
- MCPJam routes the verified email domain to your organization’s Okta SSO connection. Complete Okta authentication and any required MFA.
- Verify that MCPJam opens with access to the intended organization.
IdP-initiated SSO
Sign in to your Okta dashboard and select the MCPJam tile. Complete any required authentication and verify access to your MCPJam organization.Roles and limitations
MCPJam has separate owner, admin, member and guest roles. Organization owners manage role assignments in MCPJam. SCIM provisions and removes organization access, but this integration does not currently synchronize Okta group or role changes into MCPJam admin/member permissions. Deactivation applies to the connected organization. It does not delete the person’s data or memberships in unrelated MCPJam organizations. An explicit removal performed in MCPJam is not automatically undone by an IdP reactivation. OIDC is a separate, optional setup and is not part of this SAML/SCIM catalog configuration. Contact MCPJam before configuring it.Troubleshooting
I cannot find where to enter my Okta configuration in MCPJam
I cannot find where to enter my Okta configuration in MCPJam
My setup invitation is missing or expired
My setup invitation is missing or expired
MCPJam is not in the Okta App Catalog
MCPJam is not in the Okta App Catalog
Sign-in fails with an audience or recipient mismatch
Sign-in fails with an audience or recipient mismatch
Sign-in fails because the user identifier is missing
Sign-in fails because the user identifier is missing
oktaUserId SAML statement uses user.getInternalProperty("id")
and ask your MCPJam contact to verify the IdP ID mapping for the connection.Users sign in but land in the wrong organization
Users sign in but land in the wrong organization
Test API Credentials fails or provisioning returns 401
Test API Credentials fails or provisioning returns 401
Bearer prefix.
A revoked token must be replaced with a valid token for that directory.Suspension does not remove MCPJam access
Suspension does not remove MCPJam access
A deactivated user still appears in directory records
A deactivated user still appears in directory records
Changing an Okta group does not change MCPJam admin access
Changing an Okta group does not change MCPJam admin access

