Scalekit

Scalekit MCP Server provides an OAuth-protected, scalable interface for AI agents to manage identities, organizations, environments, and connections via natural language conversations. It enables secure access control and full coverage of Scalekit's identity and access management capabilities for multiple MCP clients.

How to use

You interact with the Scalekit MCP Server through compatible MCP clients. Use natural language prompts to manage environments, organizations, users, and identity connections, while you rely on OAuth for secure authentication. The server supports multiple clients (including VS Code, Claude Desktop, Cursor, Windsurf, and others) and exposes a broad set of management tools for environments, organizations, workspaces, and connections.

Common usage patterns include: authenticating once to obtain an access token, querying environment and organization data, updating settings, managing workspace members, and configuring OIDC connections. You can generate admin portal links for organizations, invite users, and switch authentication modes for MCP servers as your needs evolve.

How to install

Prerequisites: ensure you have a modern Node.js runtime and a package manager available on your system. You will also need network access to reach the MCP server URLs shown in the configuration examples.

Step 1: Acquire the server code and its dependencies. Clone the repository or obtain the source in your preferred workflow, then install dependencies.

# Install dependencies
npm install

Step 2: Build the project if a build step is provided in your package configuration. This prepares the runtime artifacts for starting the MCP server.

# Optional build step if defined
npm run build

Step 3: Start the MCP server using the start script defined in your project. If no explicit start script is present, use a pragmatic start command that launches the server binary or entry point from your build output.

# Typical start command (adjust to your setup)
npm run start

Configuration and usage details

You configure the MCP server in a client-specific way. The server supports both direct HTTP access to a remote MCP endpoint and a local stdio-based proxy workflow via a command that wraps a remote endpoint.

{
  "servers": {
    "scalekit": {
      "type": "http",
      "url": "https://mcp.scalekit.com/"
    }
  }
}

Or, use the local proxy route with a wrapper command to connect to the same remote endpoint.

{
  "mcpServers": {
    "scalekit": {
      "command": "npx", 
      "args": ["-y", "mcp-remote", "https://mcp.scalekit.com/"]
    }
  }
}

Security and authentication

The Scalekit MCP Server uses OAuth 2.1 for secure authentication. When you register the MCP server with your client, the authorization flow ensures token-based communication between your AI agent and Scalekit's platform.

Notes for consistency

If you are configuring different MCP clients, copy the appropriate server configuration snippet into each client’s MCP settings. Restart the client after saving changes to ensure the new MCP server is active.

Additional resources

Explore the full set of capabilities to manage environments, organizations, connections, workspaces, and MCP servers. You will find tools to list, create, update, and configure each area, including generating admin portal links and inviting workspace members.

Available tools

list_environments

Retrieve the list of all available environments to understand the scope of your workspace and plan resource allocation.

get_environment_details

Fetch detailed information for a specific environment by its ID to review configuration, owners, and permissions.

list_environment_roles

Show all roles defined within a given environment to understand access levels and responsibilities.

create_environment_role

Create a new role inside an environment with a name, display name, description, and default status.

list_environment_scopes

List all scopes available within an environment to control access granularity.

create_environment_scope

Create a new scope in the specified environment for fine-grained permissions.

list_workspace_members

List all members of the current workspace to manage collaboration and access.

invite_workspace_member

Invite a new member to the current workspace by email to expand your team.

list_organizations

List all organizations under a given environment to manage enterprise structure.

get_organization_details

Get detailed information for a specific organization by its ID.

create_organization

Create a new organization under the specified environment to organize teams and resources.

generate_admin_portal_link

Generate a magic/admin portal link for a selected organization to streamline access.

create_organization_user

Create a new user within a selected organization, including identifiers and metadata.

list_organization_users

List all users in a specific organization with pagination support.

update_organization_settings

Update organization features and capabilities in a structured way.

list_environment_connections

List all identity provider or connection entries for an environment.

list_organization_connections

List all connections associated with a specific organization.

create_environment_oidc_connection

Create a new OIDC connection for the environment with a chosen provider.

update_environment_oidc_connection

Update an existing OIDC connection with updated key/provider/config details.

enable_environment_connection

Enable an existing connection for an environment to activate it.

list_mcp_servers

List all MCP servers registered under an environment.

register_mcp_server

Register a new MCP server with name, description, URL, and token expiry.

update_mcp_server

Update an existing MCP server’s details such as name, URL, or expiry.

switch_mcp_auth_to_scalekit

Switch an MCP server to use Scalekit authentication for simplified access control.