Scalekit MCP Server

🚀 Scalekit MCP Server

Model Context Protocol (MCP) サーバーは、Scalekit環境、組織、ユーザー、接続、およびワークスペース操作を管理する包括的なツールを提供します。シンプルな自然言語クエリに基づいてAIツールをScalekitのコンテキストと機能に接続したい開発者向けに構築されています。

🚀 クイックスタート

このMCPサーバーを使用すると、AIアシスタントは標準化された一連のツールを介してScalekitのIDおよびアクセス管理プラットフォームとやり取りすることができます。環境、組織、ユーザー、認証接続などを管理するための安全なOAuth保護アクセスを提供します。

✨ 主な機能

• 環境の管理と設定
• 組織とユーザーの管理
• ワークスペースメンバーの管理
• OIDC接続の設定と管理
• MCPサーバーの登録と設定
• ロールとスコープの管理
• 管理者ポータルリンクの生成

📦 インストール

設定

VS Code (バージョン1.101以上)

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

|

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

|

MCPホストに基づいて、ScalekitをMCPサーバーとして追加する設定手順は以下の通りです。

Claude Desktop

ClaudeアプリをMCPサーバーを使用するように設定します。

1. Claude Desktopアプリを開き、設定に移動してから開発者設定を選択します。
2. 設定を編集するをクリックします。
3. claude_desktop_config.jsonファイルを開きます。
4. サーバー設定を既存のファイルにコピーして貼り付け、保存します。
5. Claudeを再起動します。

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

Cursor

CursorをMCPサーバーを使用するように設定します。

1. Cursorを開き、設定に移動してからCursor設定を選択します。
2. 左側のMCPを選択します。
3. 右上の「新しいグローバルMCPサーバー」を追加をクリックします。
4. サーバー設定を既存のファイルにコピーして貼り付け、保存します。
5. Cursorを再起動します。

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

Windsurf

WindsurfをMCPサーバーを使用するように設定します。

1. Windsurfを開き、設定に移動してから開発者設定を選択します。
2. 設定を編集するをクリックします。
3. windsurf_config.jsonファイルを開きます。
4. サーバー設定を既存のファイルにコピーして貼り付け、保存します。
5. Windsurfを再起動します。

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

💻 使用例

利用可能なツール

環境管理

list_environments

• 説明: 利用可能なすべての環境をリストします。
• スコープ: 環境の読み取り

get_environment_details

• 説明: ID (例: env_123) で環境の詳細を取得します。
• パラメーター: environmentId
• スコープ: 環境の読み取り

list_environment_roles

• 説明: 指定された環境内のすべてのロールをリストします。
• パラメーター: environmentId (形式: env_)
• スコープ: 環境の読み取り

create_environment_role

• 説明: 指定された環境内に新しいロールを作成します。
• パラメーター:
  • environmentId (形式: env_)
  • roleName
  • displayName
  • description
  • isDefault (ブール値)
• スコープ: 環境の書き込み

list_environment_scopes

• 説明: 指定された環境内のすべてのスコープをリストします。
• パラメーター: environmentId (形式: env_)
• スコープ: 環境の読み取り

create_environment_scope

• 説明: 指定された環境内に新しいスコープを作成します。
• パラメーター:
  • environmentId (形式: env_)
  • scopeName
  • description
• スコープ: 環境の書き込み

ワークスペース管理

list_workspace_members

• 説明: 現在のワークスペース内のすべてのメンバーをリストします。
• パラメーター: pageToken (1から始まるインデックス)
• スコープ: ワークスペースの読み取り

invite_workspace_member

• 説明: 現在のワークスペースに新しいメンバーを招待します。
• パラメーター: email
• スコープ: ワークスペースの書き込み

組織管理

list_organizations

• 説明: 指定された環境下のすべての組織をリストします。
• パラメーター:
  • environmentId (形式: env_)
  • pageToken
• スコープ: 組織の読み取り

get_organization_details

• 説明: ID (例: org_123) で組織の詳細を取得します。
• パラメーター:
  • environmentId (形式: env_)
  • organizationId
• スコープ: 組織の読み取り

create_organization

• 説明: 指定された環境下に新しい組織を作成します。
• パラメーター: environmentId (形式: env_)
• スコープ: 組織の書き込み

generate_admin_portal_link

• 説明: 選択された組織の管理者ポータルへのマジックリンクを生成します。
• パラメーター:
  • environmentId (形式: env_)
  • organizationId (例: org_123)
• スコープ: 組織の書き込み

create_organization_user

• 説明: 選択された組織内に新しいユーザーを作成します。
• パラメーター:
  • environmentId (形式: env_)
  • organizationId
  • email
  • externalId
  • firstName
  • lastName
  • metadata (JSONキーバリューペア)
• スコープ: 組織の書き込み

list_organization_users

• 説明: 選択された組織内のすべてのユーザーをリストします。
• パラメーター:
  • environmentId (形式: env_)
  • organizationId
  • pageToken
• スコープ: 組織の読み取り

update_organization_settings

• 説明: 組織の設定を更新します。
• パラメーター:
  • environmentId (形式: env_)
  • organizationId
  • feature (機能オブジェクトのJSON配列)
• スコープ: 組織の書き込み

接続管理

list_environment_connections

• 説明: 指定された環境のすべての接続をリストします。
• パラメーター: environmentId (形式: env_)
• スコープ: 環境の読み取り

list_organization_connections

• 説明: 選択された組織のすべての接続をリストします。
• パラメーター:
  • environmentId (形式: env_)
  • organizationId (例: org_123)
• スコープ: 組織の読み取り

create_environment_oidc_connection

• 説明: 指定された環境に新しいOIDC接続を作成します。
• パラメーター:
  • environmentId (形式: env_)
  • provider (OKTA, GOOGLE, MICROSOFT_AD, AUTH0, ONELOGIN, PING_IDENTITY, JUMPCLOUD, CUSTOM, GITHUB, GITLAB, LINKEDIN, SALESFORCE, MICROSOFT, IDP_SIMULATOR, SCALEKIT, ADFS)
• スコープ: 環境の書き込み

update_environment_oidc_connection

• 説明: 指定された環境の既存のOIDC接続を更新します。
• パラメーター:
  • environmentId (形式: env_)
  • connectionId (例: conn_123)
  • key_id
  • provider
  • oidc_config (包括的なOIDC構成オブジェクト)
• スコープ: 環境の書き込み

enable_environment_connection

• 説明: 指定された環境の既存の接続を有効にします。
• パラメーター:
  • environmentId (形式: env_)
  • connectionId (例: conn_123)
• スコープ: 環境の書き込み

MCPサーバー管理

list_mcp_servers

• 説明: 指定された環境内のすべてのMCPサーバーをリストします。
• パラメーター:
  • environmentId (形式: env_)
  • pageToken
• スコープ: 環境の読み取り

register_mcp_server

• 説明: 指定された環境内に新しいMCPサーバーを登録します。
• パラメーター:
  • environmentId (形式: env_)
  • name
  • description
  • url
  • access_token_expiry (秒単位)
  • provider (オプション、use_scalekit_authenticationがfalseの場合に必要)
  • use_scalekit_authentication (ブール値)
• スコープ: 環境の書き込み

update_mcp_server

• 説明: 指定された環境内の既存のMCPサーバーを更新します。
• パラメーター:
  • environmentId (形式: env_)
  • id (MCPサーバーID)
  • name (オプション)
  • description (オプション)
  • url (オプション)
  • access_token_expiry (オプション、秒単位)
  • provider (オプション)
  • use_scalekit_authentication (オプションのブール値)
• スコープ: 環境の書き込み

switch_mcp_auth_to_scalekit

• 説明: 既存のMCPサーバーの認証をScalekit認証に切り替えます。
• パラメーター:
  • environmentId (形式: env_)
  • id (MCPサーバーID)
• スコープ: 環境の書き込み

🔧 技術詳細

MCPサーバーの認証

Scalekit MCPサーバーはOAuth2.1ベースの認証を使用しています。Scalekit MCPサーバーをMCPホストに登録すると、MCPホストがOAuth認証ワークフローを開始し、MCPクライアントがScalekitのMCPサーバーと安全に通信するための適切なトークンを取得できるようになります。

⚠️ 重要提示

独自のMCPサーバーを構築し、OAuthベースの認証を追加したい場合は、こちらのMCPサーバー用の認証ソリューションを参照できます: https://docs.scalekit.com/guides/mcp/overview/