Parseable

Parseable MCP サーバー

Parseable 用の Model Context Protocol サーバーです。MCP 対応クライアント（Claude Desktop、Claude Code、Cursor、VS Code Copilot、Windsurf、Continue、Cline、Zed、Codex）から、自然言語を使って Parseable のデータセットやアラートを検出、クエリ、管理できます。

2 種類のトランスポート：

モード	トランスポート	認証	用途
stdio	標準入力／標準出力	環境変数で指定する API キー	Claude Desktop、Cursor、VS Code、ローカルクライアント
http	ストリーミング可能な HTTP	Cloud API キー、またはセルフホスト可能な URL ＋ API キー	ホスト型デプロイとリモートクライアント

---

クイックスタート — stdio（ローカル）

コマンドを 1 つ実行するだけで、対話形式のセットアップを行い、Claude Desktop／Cursor を検出して、設定ファイルを書き込みます。

npx -y @parseable/parseable-mcp-server init

MCP クライアントを再起動すると、ツールが表示されます。これで完了です。

スクリプトでのセットアップ：

npx -y @parseable/parseable-mcp-server init \
  --client claude-desktop \
  --url https://your-parseable.example.com \
  --api-key "$PARSEABLE_API_KEY"

対応する --client の値：claude-desktop、cursor。

Cursor Marketplace プラグイン

このリポジトリには、ネイティブの Cursor プラグインマニフェストも含まれています。Marketplace からインストールすると、https://mcp.parseable.com/mcp に接続し、認証情報を環境変数から読み込みます。

Cursor の起動前に、次の変数を設定してください。

export PARSEABLE_URL="https://your-parseable.example.com"
export PARSEABLE_API_KEY="your-api-key"
export PARSEABLE_MODE="self-hosted"

Cursor プラグインでは PARSEABLE_API_KEY と PARSEABLE_MODE が必須です。Parseable Cloud を使う場合は PARSEABLE_MODE=cloud を設定し、PARSEABLE_URL は省略します。セルフホスト可能な Parseable を使う場合は、PARSEABLE_MODE=self-hosted と PARSEABLE_URL を設定します。

# Parseable Cloud
export PARSEABLE_MODE="cloud"
export PARSEABLE_API_KEY="your-cloud-api-key"
unset PARSEABLE_URL

次に、Cursor Marketplace から Parseable プラグインをインストールします。Cursor を macOS の Dock や、シェルの環境変数を引き継がない別の GUI ランチャーから開いた場合は、代わりに対話形式のセットアップを使用してください。

npx -y @parseable/parseable-mcp-server init --client cursor

プラグインのメタデータは .cursor-plugin/plugin.json に、MCP 接続設定は mcp.json にあります。リリース時には、プラグインのバージョンを npm パッケージのバージョンと一致させてください。

---

クイックスタート — HTTP（ホスト型）

HTTP モードでは、1 つのプロセスからセットアップページと MCP エンドポイントを提供します。Cloud クライアントは API キーを指定します。セルフホスト可能なクライアントは、Parseable の URL と API キーを指定します。

1. 環境変数を設定する

# .env
PORT=8787

2. 実行する

# From source
npm run build:all
node dist/server.js http

# Docker
docker build -t parseable-mcp-server .
docker run -p 8787:8787 --env-file .env parseable-mcp-server

3. Claude から接続する

• Claude Desktop → 設定 → コネクター → カスタムコネクターを追加
• 名前：Parseable
• URL：https://mcp.your-domain.com/mcp
• ヘッダー X-Parseable-URL：https://your-parseable.example.com
• ヘッダー X-API-Key：Parseable の API キー
• 「追加」→「接続」をクリック

4. Claude Code から接続する

claude mcp add --transport http parseable https://mcp.your-domain.com/mcp --scope user \
  --header "X-Parseable-URL: https://your-parseable.example.com" \
  --header "X-API-Key: $PARSEABLE_API_KEY"

5. Cursor／VS Code から接続する

{
  "mcpServers": {
    "parseable": {
      "type": "http",
      "url": "https://mcp.your-domain.com/mcp",
      "headers": {
        "X-Parseable-URL": "https://your-parseable.example.com",
        "X-API-Key": "your-parseable-api-key"
      }
    }
  }
}

---

HTTP 認証

各 POST /mcp リクエストでは X-API-Key が必須で、次の 2 つのモードに対応しています。

モード	ヘッダー
Cloud	X-Parseable-Mode: cloud、X-API-Key
セルフホスト（デフォルト）	X-Parseable-URL、X-API-Key

X-Parseable-Mode が指定されている場合は、最初にこれが確認されます。省略するとセルフホストモードが選択されるため、クライアントは X-Parseable-Mode: self-hosted を送信する必要はありません。Cloud モードでは、サーバーが Parseable Cloud で API キーを検証し、返された URL とテナントのルーティング情報を、上限付きのインメモリ LRU キャッシュに 24 時間保存して、Parseable へのリクエストに x-p-tenant を付加します。キャッシュは破棄可能です。キャッシュミスやプロセスの再起動が発生した場合は、再度 Cloud を通じて解決されます。

セルフホストモードでは、HTTP サーバーが指定された URL を検証し、API キーをその Parseable インスタンスに転送します。SSRF のリスクを抑えるため、デフォルトではプライベートおよびループバックの Parseable URL は拒否されます。プライベートネットワークの宛先が必要な、信頼できるデプロイメントでのみ PARSEABLE_MCP_ALLOW_PRIVATE=true を設定してください。

---

環境変数

stdio モード

変数	必須	デフォルト	用途
PARSEABLE_URL	✅	—	Parseable のベース URL
PARSEABLE_API_KEY	✅	—	セルフホスト可能な Parseable 用の API キー
PARSEABLE_QUERY_TIMEOUT_MS		30000	HTTP タイムアウト（ミリ秒）

HTTP モード

Var	Required	Default	Purpose
PORT		8787	HTTP のリッスンポート
PARSEABLE_MCP_ALLOW_PRIVATE		false	リクエストヘッダーで指定されたプライベートまたはループバックの Parseable URL を許可します
PARSEABLE_ORCHESTRATOR_URL	Cloud のみ	-	Parseable Cloud オーケストレーターのベース URL
PARSEABLE_CLOUD_AUTH_TOKEN	Cloud のみ	-	API キーの検証に使用するサービスのベアラートークン
PARSEABLE_CLOUD_CACHE_TTL_SECONDS		86400	Cloud ルーティングの LRU TTL
PARSEABLE_CLOUD_CACHE_MAX_ENTRIES		10000	キャッシュする Cloud API キールートの最大数
PARSEABLE_CLOUD_VALIDATE_TIMEOUT_MS		10000	Cloud 検証のタイムアウト

OpenTelemetry（任意）

Var	Default	Purpose
PARSEABLE_OTEL_ENABLED	false	Parseable へのトレースエクスポートを有効にします
PARSEABLE_OTEL_ENDPOINT	—	Parseable OTLP エンドポイント
PARSEABLE_OTEL_USERNAME	—	OTLP のベーシック認証
PARSEABLE_OTEL_PASSWORD	—	OTLP のベーシック認証
PARSEABLE_OTEL_TRACES_STREAM	mcp-traces	トレースのストリーム名
PARSEABLE_OTEL_DEBUG	false	OTLP エクスポートエラーをログに記録します

完全なテンプレートを使用するには、.env.example を .env にコピーしてください。

---

ツール

ツールはこのアダプターではなく、接続先の Parseable インスタンスが所有します。 MCP の tools/list に対して、アダプターは GET /api/prism/v1/llm/tools/list からエディション固有のカタログを取得します。 OSS、Enterprise、Cloud では、公開されるツールセットが異なる場合があります。

アダプターは、サーバーが指定する max-age の期間、カタログをキャッシュし、 ETag を使って再検証します。MCP の tools/call リクエストは POST /api/prism/v1/llm/tools/call に転送されます。Parseable はそこで引数を検証し、 RBAC を適用してツールを実行し、MCP の CallToolResult を返します。

---

クライアントの設定 — stdio

Claude Desktop

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

{
  "mcpServers": {
    "Parseable": {
      "command": "npx",
      "args": ["-y", "@parseable/parseable-mcp-server"],
      "env": {
        "PARSEABLE_URL": "https://your-parseable.example.com",
        "PARSEABLE_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Code

claude mcp add Parseable \
  --env PARSEABLE_URL=https://your-parseable.example.com \
  --env PARSEABLE_API_KEY=your-api-key \
  -- npx -y @parseable/parseable-mcp-server

Cursor

~/.cursor/mcp.json：

{
  "mcpServers": {
    "Parseable": {
      "command": "npx",
      "args": ["-y", "@parseable/parseable-mcp-server"],
      "env": {
        "PARSEABLE_URL": "https://your-parseable.example.com",
        "PARSEABLE_API_KEY": "your-api-key"
      }
    }
  }
}

VS Code

.vscode/mcp.json：

{
  "servers": {
    "Parseable": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@parseable/parseable-mcp-server"],
      "env": {
        "PARSEABLE_URL": "https://your-parseable.example.com",
        "PARSEABLE_API_KEY": "your-api-key"
      }
    }
  }
}

---

開発

git clone https://github.com/parseablehq/parseable-mcp-server.git
cd parseable-mcp-server
npm install
cp .env.example .env    # fill in your values

# Build
npm run build           # server only (tsc)
npm run build:ui        # React UI only (vite)
npm run build:all       # both

# Run
node dist/server.js         # stdio mode
node dist/server.js http    # HTTP mode (port 8787)

# Dev
npm run dev             # tsc --watch
npm run dev:ui          # vite dev server (proxies API to :8787)
npm test
npm run lint
npm run fix             # biome auto-fix

CI（GitHub Actions）は、Node 22 で main へのすべての push/PR に対して、lint、build:all、テストを実行します。main へのマージ時に、Docker イメージが ghcr.io/parseablehq/parseable-mcp-server に公開されます。

---

セキュリティ

• Parseable API キーは MCP クライアントの設定に保存されます。必要最小限の権限に限定したキーを使用してください。
• HTTP クライアントは X-Parseable-URL と X-API-Key で認証情報を送信します。リモート環境へのデプロイでは、必ず HTTPS を使用してください。
• query_sql は DDL/DML をブロックし、行数に LIMIT を強制します。時間範囲の指定は必須です。
• evaluate_alert は実際の通知を送信する場合があります。承認する前に呼び出し内容を確認してください。
• テレメトリはありません。外部への呼び出しは、ユーザーが設定した Parseable インスタンスにのみ行われます。

---

ライセンス

Apache-2.0。詳細は LICENSE を参照してください。