LightShip について
LightShipは、既存のClickHouse OpenTelemetryテーブルに保存された本番AIエージェントのトレースを、ドメイン専門家やコーディングエージェントが調査するためのツールです。Web UI、REST API、MCPに同じロール・属性ベースのポリシーを適用し、データベース認証情報を利用者に渡しません。
主な機能
- 01統制されたトレースアクセス
- 02会話・ツール呼び出し・結果の検索
- 03既存のClickHouseトレースデータを利用
- 04UI・REST・MCPへのポリシー適用
- 05確認用のインデックスDDL提案
活用シーン
- 01本番エージェントの障害調査
- 02ドメイン専門家への制御されたトレース提供
- 03認可済み調査のエージェントワークスペースへの出力
MCP 対応
MCPクライアントはWeb UIやREST APIと同じ認可ポリシーの下でトレースを検索できます。ローカルMCP companionは認可済みの出力をエージェントワークスペースに保存し、パスと件数のみを返します。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://lightship-production.up.railway.app/mcpclaude mcp add --transport http lightshiphq-lightship https://lightship-production.up.railway.app/mcp{"mcpServers":{"lightshiphq-lightship":{"type":"http","url":"https://lightship-production.up.railway.app/mcp"}}}Cursor で開く{"servers":{"lightshiphq-lightship":{"type":"http","url":"https://lightship-production.up.railway.app/mcp"}}}VS Code で開く{"mcpServers":{"lightshiphq-lightship":{"type":"http","url":"https://lightship-production.up.railway.app/mcp"}}}{"mcpServers":{"lightshiphq-lightship":{"serverUrl":"https://lightship-production.up.railway.app/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
https://lightship-production.up.railway.app/mcp認証が必要ツール
詳細
LightShip
開発者がボトルネックにならず、本番環境のエージェントをより速く改善できます。
LightShip を使うと、ドメインの専門家がガバナンスの効いたセルフサービス形式で、本番環境のエージェントのトレースにアクセスできます。ClickHouse にある既存の OpenTelemetry データの前段に配置することで、データベースの認証情報や別の可観測性サイロを用意することなく、人間と AI コーディングエージェントが実際の会話やツール呼び出しを調査できます。
LightShip を選ぶ理由
- 失敗の背後にあるパターンを見つけます。 Codex、Claude、その他の MCP クライアントを使い、会話、ツール呼び出し、結果を横断してビジネス上の質問をできます。
- 既存のトレースストアをそのまま使えます。 トレースを別のプラットフォームにコピーせずに、LightShip を OpenTelemetry テーブルに接続できます。
- 計装は一度だけ。ポリシーは後から定義できます。 既存の列と属性キーを認可の入力として選択すれば、再計装することなくポリシーを作成または変更できます。同じポリシーがウェブ UI、REST API、MCP に適用されます。
- 大規模な調査内容をモデルのコンテキストに入れずに済みます。 ローカルの MCP コンパニオンは、認可されたエクスポートをエージェントのワークスペースに書き込み、会話にはパスと件数のみを返します。
仕組み
- 管理者が LightShip を ClickHouse にある既存の OpenTelemetry スパンテーブルに接続します。
- 検索とアクセスルールに使用できる列とマップキーを選択します。
- LightShip は、トレースをウェブ UI、REST、MCP 経由で返す前に、各呼び出し元のロールと属性を ClickHouse クエリに組み込みます。
トレースが認可の単位です。一致するスパンが 1 つあれば、トレース全体へのアクセスが許可されます。 LightShip が、制限付きユーザーに ClickHouse の認証情報を直接渡すことはありません。
パフォーマンス
クエリのパフォーマンスは、既存の ClickHouse トレーステーブルのレイアウトとインデックスに左右されます。フィルターとアクセス ポリシーで使用できるフィールドを選択すると、LightShip はテーブルのソートキーとスキップインデックスを確認し、不足しているインデックスの DDL を提案します。これらの推奨事項は参考情報です。LightShip が ClickHouse スキーマを自動的に変更することはありません。最適化レポートの確認方法をご覧ください。
はじめる
ドキュメントには、最新のセットアップ手順とリファレンス資料が記載されています。
- 最新のアルファ版をインストール
- Go パッケージを見る
- ClickHouse を接続
- ロールとポリシーを定義
- Codex、Claude、その他の MCP クライアントを接続
- ウェブ UI を使用
- LightShip をデプロイして設定
- API リファレンスを見る
お使いの環境への LightShip のデプロイについてお困りですか？ご相談ください。
セキュリティとプロジェクトの状況
LightShipが保護するのは、LightShip経由で送信されたリクエストのみです。ClickHouseに直接アクセスすると、LightShipのポリシーは適用されません。現在、PIIの検出、ペイロードのマスキング、個々のスパンの非表示には対応していません。クエリの監査はベストエフォートで行われるため、監査ログの書き込みに失敗しても、トレースリクエストは失敗せず、エラーがログに記録されます。
LightShipは実験的なアルファ版であり、安定版はリリースされていません。隔離された環境で、合成データまたは機密性のないデータを使用して評価してください。デプロイ前に、セキュリティガイダンスと現在の制限事項をお読みください。
フィードバック
自律的な作業の信頼性とガバナンスの向上を支援したいと考えています。本番環境でAIエージェントを運用しているチームの皆さまから、LightShipが次にサポートすべき内容について、ぜひご意見をお聞かせください。
お問い合わせいただくか、 GitHub issueを作成してください。
コントリビューション
開発とテストについてはCONTRIBUTING.mdを、脆弱性の報告についてはSECURITY.mdを、変更内容についてはCHANGELOG.mdをご覧ください。 LightShipはApache-2.0ライセンスの下で公開されています。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。