Précis Finance MCP

Précis Finance MCP

FP&A と経営報告向けの、読み取り専用でセルフホスト可能な MCP サーバーです。SQL セマンティックレイヤーを介して、統制された指標、財務諸表、行レベルのドリルダウン、グラフ、スナップショットファイルのエクスポートを提供します。市場データではなく、お客様独自のデータウェアハウスを使用します。 エージェント型 Finance Intelligence Platform である Précis のオープンコアです。

ビジネス指標（KPI、階層、財務諸表のレイアウト）を、Git でバージョン管理された、シンプルな SQL ビューによるセマンティックレイヤー上の YAML カタログに一度定義すれば、MCP 対応クライアントは一貫性があり、根拠を明確に示せる数値を利用できます。セマンティックビューはお客様の ClickHouse 内のシンプルな SQL なので、既存の BI ツールからも同じビューを直接クエリできます。このリポジトリには、指標エンジン、セマンティックレイヤーとカタログ、データ取り込み、ID 管理、MCP トランスポートがすべて揃っており、外部の依存先はありません。セルフホストも可能です。

このような場合にご利用ください

• 財務部門を運営または支援しており、Claude、ChatGPT などの MCP 対応クライアントに、自社の数値に基づく質問への回答や経営報告をさせたい場合。
• 統制された指標が必要な場合。たとえば、売上総利益率、稼働率、事業部門別売上について合意済みの定義を使い、エージェントが総勘定元帳の生データをクエリしたり、独自の定義を作り出したりしないようにしたい場合。
• すでに運用しているインフラ上で、ご自身が管理するセキュリティモデルのもとでセルフホストしたい場合。新たなクラウド契約は不要です。
• すべての回答を追跡可能にしたい場合。設計上、読み取り専用で、モデルが数値を生成することはなく、すべての数値は読み取り可能なセマンティックビューから集計されます。

要件

• Docker — Engine と Compose v2 が必要です。すべてコンテナで実行されるため、ほかにインストールするものはありません。
• データウェアハウスの準備は不要です — スタックには ClickHouse（エンジンの分析ストア）、PostgreSQL（プラットフォームとアーティファクトの状態管理）、Valkey（一時スナップショット）が含まれています。ローカルでの試用は、ほかに何も用意せずに実行でき、サンプルの財務モデルが読み込まれます。
• すでに ClickHouse を実行していますか？ — バンドル版ではなく、お使いのインスタンスをエンジンの接続先として指定することもできます。データモードをご覧ください。
• MCP 対応クライアント — Claude（デプロイ済みインスタンスに接続する claude.ai および Desktop コネクター）、Claude Code、ChatGPT、または任意の MCP クライアント。
• Excel へのアクセス（任意） — マルチユーザーイメージでは、Précis Excel アドインも /excel でホストされます。ライブの読み取り専用ワークブック関数を使う場合は、OAuth クライアントを有効にしてください。

Précis Finance MCP の画面

すべての数値は、アカウント、コストセンター、期間、シナリオごとのセマンティックビューから集計されます。汎用的な指標レイヤーでは表現できない指標（レイアウト内の小計を含め、期間平均の稼働率分母を四半期または事業部門単位で再集計する指標）も、カタログで第一級の定義として扱われます。

公開デモを試す

リモート MCP クライアントを https://mcp.precis.finance/mcp に接続すると、インストールやアカウント作成をせずに Précis Finance MCP を試せます。共有サーバーでは、合成された財務データセットに対する読み取り専用ツールを利用できます。お客様の財務データは含まれていません。API キーもサインインも不要です。

Claude Code の場合：

claude mcp add --transport http precis-demo https://mcp.precis.finance/mcp

次に、precis_orientation にデモで利用できる機能を尋ねるか、比較情報付きの損益計算書をリクエストしてください。他の MCP クライアントや、この共有インスタンスの制限については、公開デモ接続ガイドをご覧ください。

クイックスタート — 単一ユーザー向けローカルトライアル

export MCP_DEV_KEY=$(openssl rand -hex 32)
export ARTIFACT_SIGNING_KEY=$(openssl rand -hex 32)
docker compose -f deploy/docker-compose.local.yml up -d --build
docker compose -f deploy/docker-compose.local.yml exec precis-mcp \
  python -m precis_mcp.sample_data   # populate the demo model

サーバーと ClickHouse、Postgres、Valkey をまとめたスタックを、共有開発キーを使って 127.0.0.1 にバインドします。開発キーをベアラートークンとして指定し、任意の MCP クライアントを http://127.0.0.1:8768/mcp に接続してください。Claude Code を使う場合の例：

claude mcp add --transport http precis http://127.0.0.1:8768/mcp \
  --header "Authorization: Bearer $MCP_DEV_KEY"

次に、財務に関する具体的な質問をして、これが汎用 SQL MCP ではないことを確かめてください。 「比較情報付きで FY2025 の損益計算書を表示してください。」 · 「コストセンター別に収益を掘り下げてください。」 · 「デジタルトランスフォーメーションチームの月別稼働率を表示してください。」

デモデータや独自のモデルの持ち込み方法を含む、詳しい手順についてはdocs/getting-started/quickstart.mdをご覧ください。

通話で試してみませんか？早期導入のお客様とともに、お客様独自のデータウェアハウス上で Précis Finance MCP を稼働させます。precis.finance または [email protected] までお問い合わせください。

マルチユーザー向けデプロイ

deploy/docker-compose.yml では、オープンサーバー、PostgreSQL、ClickHouse、Valkey、アーティファクトストレージ、OAuth 2.1 + PKCE サインインを含むマルチユーザー向けスタックを実行します。デプロイは、相互に独立した次の軸でモジュール化されています。

• データ — バンドルされた ClickHouse（空、またはサンプルデータ入り）、あるいは独自のデータ： docs/deployment/clickhouse-data-modes.md
• ID 管理 — ローカル開発キー、バンドルされた Keycloak（任意でお客様の IdP とフェデレーション）、または外部 OIDC プロバイダーとの直接連携（Auth0 / Okta / Entra / Ping）： docs/deployment/oauth-keycloak.md、 docs/deployment/external-idp-recipes.md
• イングレス — バンドルされた Caddy プロキシ（bundled-proxy プロファイル。デフォルトで有効）は、PRECIS_DOMAIN を設定するだけで、Let's Encrypt の証明書を自動取得して TLS を終端します。アプリ自体はプロキシに依存しません。プロファイルを無効にすれば、運用中のイングレスの背後に配置できます（deploy/nginx/ に nginx vhost の例、ホストヘルパーは scripts/install-precis-mcp.sh --nginx）
• バックアップ — 追加可能な backup Compose プロファイル：スケジュールに従って、Postgres のダンプ、ClickHouse のバックアップ、インスタンス設定をまとめたバンドルをローカルボリュームまたは S3 に保存します。リストアおよび復旧訓練用コマンドも用意されています： docs/operations/backups.md
• Excel アドイン — 同じインスタンスの /excel で提供される、オプションのホスト型ワークブック関数。バンドルされた Keycloak クライアント、または外部 IdP のパブリッククライアントで有効化できます： docs/excel/

scripts/deploy-mcp.sh --data-mode ... --auth-mode ... は、Compose プロファイルを簡単に操作するための入口です。すべての設定項目は環境変数で指定します： docs/configuration/environment-variables.md。

データモデルを設定する

モデルは instance/ ディレクトリに格納されます。ここには、指標カタログ、セマンティック SQL ビュー、取り込みバインディングが含まれます。バンドルされたデモインスタンスで構成を確認できます。まずdocs/configuration/catalogue-and-semantic.mdを読み、次にdocs/configuration/ingestion.mdとdocs/operations/onboarding-ingestion.mdを参照してデータを読み込んでください。サーバーツールの追加方法については、開発者ガイドのdocs/development/adding-read-tools.mdをご覧ください。

セキュリティと読み取り専用の方針

約束ではなく、仕組みから説明します。

• 設計上読み取り専用 — サーバーはデータを取得しますが、ソースに書き込んだり変更したりすることはありません。書き戻す経路はありません。
• モデルが数値を生成することはありません — ツールはソースのディメンション（アカウント、コストセンター、期間、シナリオ）から集計した数値を返すか、データが存在しないことを報告します。クライアントは質問を組み立て、回答を説明しますが、数値を捏造することはありません。
• ソースまで追跡可能 — すべての数値は、レスポンス → セマンティックビュー → データウェアハウスの経路で追跡できます。セマンティックビューは誰でも読めるプレーンな SQL で、カタログは git でバージョン管理されています。
• 市場データではなく、お客様自身のデータウェアハウス — お客様の環境で、お客様自身のデータウェアハウスに対し、お客様自身のアクセス制御のもとで動作します。
• 認証情報 — ローカル開発キー、同梱の Keycloak（必要に応じてお客様の IdP とフェデレーション可能）、または外部 OIDC プロバイダーへの直接接続（Auth0／Okta／Entra／Ping）を利用できます。
• 運用者の責任 — Précis Finance MCP は、ガバナンスが適用された読み取り操作を公開するよう設計されています。お客様ご自身のセキュリティモデルのもとで、引き続きデプロイと運用を行ってください。開示ポリシーについては、SECURITY.md をご覧ください。

ドキュメント

ドキュメント全文：docs.precis.finance。

領域	こちらから
はじめに	クイックスタート
デプロイ	ClickHouse のデータモード · OAuth／Keycloak · 外部 IdP の設定例
Excel	Précis for Excel · 関数リファレンス
設定	カタログとセマンティックレイヤー · データ取り込み · 環境変数
運用	オンボーディングとデータ取り込み · バックアップ
開発	読み取りツールの追加
セキュリティ	SECURITY.md

Précis Finance MCP と Précis の違い

ここで構築するデプロイ環境とデータモデルは、フル版の Précis プラットフォームを支える基盤です。Précis は現在、一般提供前の段階にあり、同じエンジンとデータモデル上に、ライセンス提供のエージェント型ワークスペースを追加します。オープンコアから Précis への移行に必要なのは、ワークフローの設定と導入であり、別のデータ統合プロジェクトではありません。Précis は準備を支援し、最終的な判断は財務の専門家が行います。

提供されるもの — 提供されないもの

Précis Finance MCP（Elastic License 2.0）に含まれるもの： MCP サーバーとトランスポート · メトリックエンジン · 財務諸表レイアウト · セマンティック SQL ビューパターン · YAML メトリックカタログ · サンプル財務モデル · データ取り込み経路 · ホスト型の読み取り専用 Excel アドイン · ClickHouse 分析ストア · PostgreSQL プラットフォーム状態管理 · ローカル開発キー方式 · マルチユーザー OAuth 2.1 方式 · Docker Compose デプロイ · バックアップと復元のプロファイル · 設定およびデプロイのドキュメント。

Précis に含まれ、このリポジトリには含まれないもの： ワークスペース UI · 対話型エージェント · 計画の書き戻し · シナリオ確定ワークフロー · Dispatch による定期ブリーフィング · レポート／マネジメントパックのワークフロー · Excel の書き戻し／ラウンドトリップ · 商用サポート（別途合意した場合を除く）。

Précis についてのお問い合わせ — フルプラットフォームおよびデザインパートナープログラム： precis.finance または [email protected]。

サポートとサービス

Précis Finance MCP はセルフサービスで利用できるよう構築されており、ドキュメントで 必要な情報を網羅することを目指しています。データモデルの設定、ガイド付きのデプロイ、継続的なサポート、現実的なデータで評価するためのデモ環境など、 ドキュメントに記載のないサポートをご希望の場合は、precis.finance からセットアップセッションをご予約いただくか、 [email protected] までご連絡ください。同じアドレスから、Précis プラットフォーム全体を開発するチームにもご連絡いただけます。

コントリビューション

このリポジトリは Précis モノレポの一方向ミラーです。main は同期コミットによって更新され、 プルリクエストは、作成者情報と DCO への署名を保持したまま内部で適用され、次回の同期時に公開されます。 CONTRIBUTING.md をご覧ください。

ライセンス

Elastic License 2.0 — ソースコードを利用できます。自由に使用、変更、 セルフホスト（商用利用を含む）、再配布できます。ただし、ホスト型サービスまたはマネージドサービスとして第三者に提供することはできません。