MCPサーバー

モデルコンテキストプロトコル統合

mindzieAPI MCPサーバーは、AIコーディングアシスタントがmindzieStudioとプログラム的に連携することを可能にします。MCP（Model Context Protocol）は、外部機能にAIツールがアクセスするための標準化された方法を提供します。

利用可能なツール

MCPサーバーは以下のツールをAIアシスタントに公開しています：

mindzie_list_block_types

利用可能なブロックタイプ（フィルター、計算機、エンリッチメント）についての情報を取得します。

パラメーター

パラメーター	型	必須	説明
`category`	String	いいえ	カテゴリでフィルタリング: "filters", "calculators", "unified"、省略するとフィルターのみ

カテゴリのオプション

値	返される内容
`"filters"`	フィルターブロックタイプのみ（デフォルト）
`"calculators"`	計算機ブロックタイプのみ
`"unified"`	エンリッチメントを含むすべてのブロックタイプをカテゴリ別にグループ化して返す

例：すべてのブロックタイプを取得（推奨）

mindzie_list_block_types category="unified"

すべてのブロックタイプの完全なメタデータを返します：

{
  "BlockTypes": [
    {
      "OperatorName": "CaseAttributeFilter",
      "DisplayName": "ケース属性フィルター",
      "Description": "属性値に基づいてケースをフィルタリングします",
      "Category": "属性フィルター",
      "BlockType": "Filter",
      "DocumentationUrl": "/mindzie_studio/filters/case-attribute-filter",
      "UsageFrequency": "高",
      "CommonUseCases": ["顧客セグメントでフィルタリング", "特定地域に注目"]
    },
    {
      "OperatorName": "CaseDurationCalculator",
      "DisplayName": "ケース期間計算機",
      "Description": "ケースの総期間を計算します",
      "Category": "時間計算機",
      "BlockType": "Calculator",
      "DocumentationUrl": "/mindzie_studio/calculators/case-duration-calculator",
      "UsageFrequency": "高",
      "CommonUseCases": ["サイクルタイム分析", "遅延ケースの特定"]
    },
    {
      "OperatorName": "CaseStageCalculator",
      "DisplayName": "ケースステージ計算機",
      "Description": "活動パターンに基づいてケースにステージラベルを割り当てます",
      "Category": "ステージ分析",
      "BlockType": "Enrichment",
      "DocumentationUrl": "/mindzie_studio/enrichments/case-stage-calculator",
      "UsageFrequency": "中",
      "CommonUseCases": ["ケース進行の追跡", "ステージ遷移の監視"]
    }
  ],
  "Categories": ["属性フィルター", "時間フィルター", "時間計算機", "ステージ分析"],
  "TotalCount": 45,
  "ByBlockCategory": {
    "Filter": [...],
    "Calculator": [...],
    "Enrichment": [...]
  }
}

例：フィルターのみ取得

mindzie_list_block_types category="filters"

例：計算機のみ取得

mindzie_list_block_types category="calculators"

mindzie_list_projects

現在のテナントで利用可能なプロジェクトの一覧を取得します。

パラメーター

パラメーター	型	必須	説明
`tenant_id`	String	はい	テナントID

mindzie_get_project

特定のプロジェクトの詳細を取得します。

パラメーター

パラメーター	型	必須	説明
`tenant_id`	String	はい	テナントID
`project_id`	String	はい	プロジェクトID

mindzie_execute_block

ブロックを実行し、結果を返します。

パラメーター

パラメーター	型	必須	説明
`tenant_id`	String	はい	テナントID
`project_id`	String	はい	プロジェクトID
`block_id`	String	はい	実行対象のブロックID

mindzie_generate_url

mindzieStudioのページやエンティティへのURLを生成し、ナビゲーションや共有に使用します。

パラメーター

パラメーター	型	必須	説明
`type`	String	はい	URLの種類（下記URLタイプを参照）
`entity_id`	String	条件付き	エンティティ固有ページ用のエンティティID
`parent_id`	String	条件付き	親ID（projectIdまたはnotebookId）

URLタイプ

リストページ（entity_id不要）：

タイプ	parent_id	説明
`projects`	-	プロジェクト一覧
`apps`	-	アプリ一覧
`investigations`	projectId	プロジェクトの調査一覧
`dashboards-list`	projectId	プロジェクトのダッシュボード一覧
`datasets`	projectId	プロジェクトのデータセット
`actions`	projectId	プロジェクトのアクション
`bpmn`	projectId	プロジェクトのBPMNエディター

エンティティページ（entity_id必須）：

タイプ	entity_id	parent_id	説明
`dashboard`	dashboardId	-	単一のダッシュボード
`analysis`	notebookId	-	ノートブック/分析ページ
`block`	blockId	notebookId	特定のブロック
`enrichment`	enrichmentId	projectId（任意）	エンリッチメントノートブック

例：ダッシュボードURL取得

mindzie_generate_url type="dashboard" entity_id="{dashboardId}"

返却例：

{
  "url": "https://host/navigate?type=dashboard&id=...",
  "entityType": "dashboard",
  "entityId": "...",
  "tenantId": "..."
}

例：ブロックURL取得

mindzie_generate_url type="block" entity_id="{blockId}" parent_id="{notebookId}"

例：調査一覧URL取得

mindzie_generate_url type="investigations" parent_id="{projectId}"

前提条件

MCPサーバーのセットアップ前に以下を準備してください：

Node.js 18以降 - nodejs.orgからダウンロード
mindzie APIトークン - mindzieStudioのアカウント設定から生成
mindzieStudioのインスタンスURL - https://www.mindziestudio.com（クラウド）またはオンプレミスのURL

インストール

mindzie MCPサーバーはnpxを使って自動的にインストールされます。手動インストール不要です：

npx -y @mindzie/mcp-server

環境変数

変数名	必須	説明
`MINDZIE_API_URL`	はい	mindzieStudioインスタンスのURL
`MINDZIE_API_TOKEN`	はい	API認証用トークン

アプリケーション別セットアップ

Claude Desktop

Claude DesktopはAnthropicのClaude AI用デスクトップアプリケーションです。

Windows設定

以下の設定ファイルを編集します：

%APPDATA%\Claude\claude_desktop_config.json

mindzie MCPサーバーを追加：

{
  "mcpServers": {
    "mindzie": {
      "command": "npx",
      "args": ["-y", "@mindzie/mcp-server"],
      "env": {
        "MINDZIE_API_URL": "https://www.mindziestudio.com",
        "MINDZIE_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

macOS設定

以下のファイルを編集します：

~/Library/Application Support/Claude/claude_desktop_config.json

Windowsと同様の設定を追加してください。

設定後

設定ファイルを保存
Claude Desktopを完全に再起動（終了して再起動）
チャット画面にハンマーアイコンが表示され、MCPツールが利用可能になることを確認

Claude Code (CLI)

Claude CodeはAnthropicのClaude AI用コマンドラインインターフェースです。

MCPサーバーの追加

次のコマンドでmindzie MCPサーバーを登録します：

claude mcp add mindzie -- npx -y @mindzie/mcp-server

環境変数設定

Windows（PowerShell）:

$env:MINDZIE_API_URL = "https://www.mindziestudio.com"
$env:MINDZIE_API_TOKEN = "your-api-token-here"

Windows（コマンドプロンプト）:

set MINDZIE_API_URL=https://www.mindziestudio.com
set MINDZIE_API_TOKEN=your-api-token-here

macOS/Linux:

export MINDZIE_API_URL="https://www.mindziestudio.com"
export MINDZIE_API_TOKEN="your-api-token-here"

永続化設定

環境変数はシェルプロファイル（.bashrc、.zshrc、PowerShellプロファイルなど）に追加して永続化してください。

Cursor IDE

CursorはVS CodeをベースにしたAI搭載コードエディターです。

設定ファイル場所

ホームディレクトリまたはプロジェクトルートに.cursor/mcp.jsonを作成または編集します：

{
  "mcpServers": {
    "mindzie": {
      "command": "npx",
      "args": ["-y", "@mindzie/mcp-server"],
      "env": {
        "MINDZIE_API_URL": "https://www.mindziestudio.com",
        "MINDZIE_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

代替：設定UI

Cursorを開く
設定（Ctrl/Cmd + ,）を開く
「MCP」で検索
settings.jsonで編集をクリック
mindzieサーバー設定を追加

セットアップ確認

設定後、Cursorを再起動し、AIアシスタントの利用可能なツールにmindzieが表示されているか確認。

Windsurf (Codeium)

WindsurfはCodeiumのAI搭載IDEです。

設定ファイル場所

Windows:

%USERPROFILE%\.codeium\windsurf\mcp_config.json

macOS/Linux:

~/.codeium/windsurf/mcp_config.json

設定内容

{
  "mcpServers": {
    "mindzie": {
      "command": "npx",
      "args": ["-y", "@mindzie/mcp-server"],
      "env": {
        "MINDZIE_API_URL": "https://www.mindziestudio.com",
        "MINDZIE_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

セットアップ確認

Windsurfを再起動
Cascadeパネルを開く
mindzieツールがプロセスマイニングクエリに利用可能であることを確認

VS Code with Continue Extension

ContinueはVS Code向けのオープンソースAIコーディングアシスタントです。

Continueのインストール

VS Codeを開く
拡張機能パネル（Ctrl/Cmd + Shift + X）を開く
「Continue」で検索しインストール

MCPサーバー構成

Continueの設定ファイルを編集：

Windows:

%USERPROFILE%\.continue\config.json

macOS/Linux:

~/.continue/config.json

mcpServersセクションにMCPサーバーを追加：

{
  "mcpServers": [
    {
      "name": "mindzie",
      "command": "npx",
      "args": ["-y", "@mindzie/mcp-server"],
      "env": {
        "MINDZIE_API_URL": "https://www.mindziestudio.com",
        "MINDZIE_API_TOKEN": "your-api-token-here"
      }
    }
  ]
}

セットアップ確認

VS Codeを再起動
Continueパネルを開く
/toolsと入力してmindzieを含むMCPツールが表示されることを確認

トラブルシューティング

MCPサーバーが接続しない場合

Node.jsのインストール確認: node --version を実行し、バージョン18以上であることを確認
サーバーの手動テスト: ターミナルで npx -y @mindzie/mcp-server を実行して動作確認
環境変数の確認: MINDZIE_API_URL と MINDZIE_API_TOKEN が正しく設定されているか
アプリケーションの再起動: 完全に終了後、再度起動

認証エラー対応

APIトークンの確認: トークンが期限切れまたは無効化されていないか
トークンの権限確認: 必要なリソースにアクセスできる権限があるか
URLの確認: MINDZIE_API_URL が正しいインスタンスを指しているか

ツールが表示されない場合

設定の構文チェック: JSONが正しく、末尾のカンマなどがないか
ファイル配置の確認: 設定ファイルが正しい場所にあるか
アプリケーションログの確認: MCP関連のエラーメッセージを探す
完全再起動: 一部のアプリはMCP設定をキャッシュするため完全な再起動が必要

よくある設定ミス

ミス	解決策
npxの引数に `-y` を入れ忘れ	確認メッセージをスキップするため `["-y", "@mindzie/mcp-server"]` とする
JSONの末尾のカンマ	末尾のカンマを削除
設定ファイル場所の誤り	OSごとの正しいパスを再確認
トークンに特殊文字を含む	JSON内でトークンを正しく引用（ダブルクォート）

セキュリティベストプラクティス

トークンをバージョン管理にコミットしない - 環境変数やシークレットマネージャーを使用
プロジェクト毎のトークンを使用 - プロジェクトごとに別トークンを作成
トークンの定期的なローテーション - 特に本番環境で
トークン権限の制限 - 必要最小限のアクセス権を付与
トークン利用状況の監査 - APIアクセスログを定期的に確認

AIアシスタント向けの統合発見

unified カテゴリーパラメーターはAIアシスタント向けに設計されています。AIが利用可能な分析機能を把握する際に、一度のMCP呼び出しで以下を取得できます：

mindzie_list_block_types category="unified"

これによりAIは：

利用可能な機能の理解：全フィルター、計算機、エンリッチメントを取得
適切なブロックタイプの選択：UsageFrequencyやCommonUseCasesに基づく
ドキュメントへのリンク：各ブロックにDocumentationUrlが含まれる
関係性の識別：RelatedBlocksフィールドで補完的なブロックを提案

AIワークフロー例

プロセス期間分析を支援するAIアシスタントは：

mindzie_list_block_types category="unified" を呼び出して機能を発見
CommonUseCasesに「期間」を含むブロックタイプを抽出
CaseDurationCalculatorやWaitTimeCalculatorを提案
APIを使って該当ブロックを作成
実行して結果を解釈

レスポンスフィールド参照

category="unified" 使用時、各ブロックタイプに含まれる項目：

フィールド	説明	AIによる利用方法
`OperatorName`	技術的識別子	APIでブロック作成時に使用
`DisplayName`	ユーザー向け名称	利用者に表示
`Description`	簡単な説明	利用者が目的を理解するため
`Category`	機能的なグループ	提案の整理
`BlockType`	Filter/Calculator/Enrichment	利用シーンの判定
`DocumentationUrl`	ドキュメントへのリンク	詳細情報取得
`UsageFrequency`	高/中/低	よく使われるブロック優先
`CommonUseCases`	使用例シナリオ	利用者の目的に合致
`RelatedBlocks`	関連ブロックタイプ	補完分析の提案
`UsageNotes`	追加のガイダンス	利用者への補足説明

ベストプラクティス

AIアシスタント向け

まずは統合発見で開始：必ず最初に category="unified" を呼ぶ
結果をキャッシュ：ブロックタイプのメタデータは頻繁に変わらない
利用シナリオにマッチさせる：CommonUseCasesで関連するブロックを見つける
関連ブロックを提案：RelatedBlocksで補完分析を提供

開発者向け

トークンは安全に管理：クライアントに直接公開しない
適切なスコープを指定：必要最小限の権限を要求
レートリミットに対応：指数的バックオフでリトライ実装
レスポンス検証：エラー有無を確認してから処理

次のステップ

統合ブロックタイプAPI - 直接のAPIドキュメント
URL生成API - ナビゲーション用URL生成
AIコーディングツール概要 - 一般的なAIツール統合
認証 - API認証の詳細