Mia-Platform Console MCP Server

Mia-Platform Console MCP サーバー

はじめに

Mia-Platform Console MCP サーバーは、Mia-Platform Console API とシームレスに連携する Model Context Protocol（MCP） サーバーです。開発者とツール向けに、高度な自動化機能と対話機能を提供します。

前提条件

Visual Studio Code、Claude Desktop、Cursor、Gemini CLI などのクライアントで Mia-Platform Console MCP サーバーを使用するには、まず接続先の Mia-Platform Console インスタンスで有効なアカウントを取得する必要があります。また、インスタンスのホストアドレスを環境変数 CONSOLE_HOST に設定する必要があります。

次のいずれかの方法でアクセスできます。

• サービスアカウントを使用してマシン間認証を行うと、S.A. が作成された Company に対する MCP の全機能を利用できます（詳しくは、Mia-Platform サービスアカウントの作成方法に関する公式ドキュメントをご覧ください）。この方法を使用する場合は、環境変数 MIA_PLATFORM_CLIENT_ID と MIA_PLATFORM_CLIENT_SECRET を設定する必要があります。
• ご自身の認証情報を使用する方法：Mia-Platform Console MCP サーバーは、OAuth2.1 と Dynamic Client Registration を使用した、認証に関する Model Context Protocol の仕様に準拠しています。この仕様に準拠したクライアントは、アクセス先として選択した Mia-Platform インスタンスの認証エンドポイントを検出し、ログインを案内できます。

実行方法

Mia-Platform Console MCP サーバーの安定版は、Docker を使用して実行できます。詳しい手順は、Mia-Platform ドキュメントの関連ページをご覧ください。

Docker がインストールされていない場合や、ローカルで実行したい場合は、NPM と Node.js を使用できます。プロジェクトをクローンしたら、次のコマンドを実行します。

npm ci
npm run build

これらのコマンドを実行すると、依存関係がすべてインストールされ、TypeScript コードが build フォルダーにトランスパイルされます。

NOTE

サーバーは、プロジェクトのルートに .env ファイルがある場合、起動時に環境変数を自動的に読み込みます。 default.env を .env にコピーし、必要に応じて値を更新して作成できます。

これらの手順が完了したら、次のように node コマンドを使用して MCP サーバーをセットアップできます。

{
  "mcp": {
    "servers": {
      "mia-platform-console": {
        "command": "node",
        "args": [
          "${workspaceFolder}/mcp-server",
          "start",
          "--stdio",
          "--host=https://console.cloud.mia-platform.eu"
        ]
      }
    }
  }
}

TIP

または、ビルド後に次のコマンドでサービスを起動できます。

node mcp-server start

その後、URL を指定するだけでクライアントに MCP サーバーを追加できます。VS Code の場合は、次のようになります。

{
  "mcp": {
    "servers": {
      "mia-platform-console": {
        "type": "http",
        "url": "http://localhost:3000/console-mcp-server/mcp"
      }
    }
  }
}

3000 の代わりに、環境変数 PORT で定義されているポートを指定してください。詳しくは「環境変数」セクションをご覧ください。

環境変数

.env という名前のファイルに記載された環境変数は、サービスの起動時に自動的に読み込まれます。

変数名	説明	必須	デフォルト値
LOG_LEVEL	アプリケーションのログレベル	いいえ	info
PORT	HTTP サーバーのポート番号	いいえ	3000
CONSOLE_HOST	Mia-Platform Console インスタンスのホストアドレス	はい	-
MIA_PLATFORM_CLIENT_ID	サービスアカウント認証用のクライアント ID	いいえ	-
MIA_PLATFORM_CLIENT_SECRET	サービスアカウント認証用のクライアントシークレット	いいえ	-
CLIENT_EXPIRY_DURATION	DCR 認証フローで生成されたクライアントの有効期間（秒）。この期間が経過すると、クライアントは期限切れとなり、使用できなくなります。	いいえ	300

ローカル開発

サーバーの開発に参加するには、お使いのマシンに Node.js をインストールする必要があります。
nvm や mise などのバージョンマネージャーを使用することをおすすめします。

.nvmrc ファイルに記載されている正しい Node.js のバージョンを使って環境をセットアップしたら、次のコマンドを実行します。

npm ci

処理が完了すると、プロジェクトのすべての依存関係がインストールされます。続いて、default.env ファイルをコピーして環境ファイルを作成し、必要に応じて編集します。

cp default.env .env

最後に、すべてが正しく動作することを確認するため、次を実行します。

npm run local:test

Console Cloud へのインストールを対象としていない場合は、--host フラグを使用して独自のホストを指定できます。

npm run local:test  -- --host https://CONSOLE_HOST

このコマンドを実行すると、http://localhost:6274 で MCP inspector がダウンロードされ、起動します。LLM 環境を用意しなくても、ツールやプロンプトの検出をテストして、実装が正しく動作するか確認できます。

新しい実装のテストを実行するには、次を使用します。

npm test

または、単一のファイルのテストを実行するには、次を実行します。

node --test --import tsx <FILE_PATH>