Geztio Platform

Geztio MCP サーバー（co.geztio/platform）

Geztio の公式 Model Context Protocol（MCP）サーバーです。Geztio は、最新の建設プロジェクト管理および経済工学プラットフォームです。

AI アシスタント（Claude Desktop、Cursor、Claude Code、Windsurf、Antigravity、カスタムエージェント）を Geztio に直接接続し、単価分析（APU／Análisis de Precios Unitarios）、CBS 予算ツリー、動的価格表、リソースカタログ、プロジェクト運営業務を利用できます。

---

🏗️ 概要

Geztio は、建設会社、プロジェクトマネージャー、コストエンジニア、現場チームに、プロジェクトの経済情報を一元管理する信頼できる情報源を提供します。この MCP サーバーを通じて、AI モデルは次のことを実行できます。

• APU（UnitCost）の検索と分析：構成内訳、歩留まり、単価、材料、機材、労務、輸送にまたがるネストされたレシピを確認します。
• リソースカタログ（Resource）の照会：動的に解決された単価とともに、材料、機材、労務、輸送用資材を検索します。
• CBS と予算シナリオ（BudgetTree）の確認：プロジェクトの章や予算項目をたどり、数量、場所、明細の合計を確認します。
• 価格表（PriceList）の監査と比較：価格の外れ値を検出し、地域別価格表を検証して、シナリオの変動をシミュレーションします。
• 非同期処理の実行：リソースを一括インポートし、実行タスクのステータスを追跡します。

---

⚡ クイックスタートと設定

1. Claude Desktop

claude_desktop_config.json にリモート MCP サーバーとして Geztio を追加します。

{
  "mcpServers": {
    "geztio": {
      "url": "https://mcp.geztio.co/mcp"
    }
  }
}

初回接続時、Claude Desktop は Geztio の組織とメンバーアカウントを認証するため、OAuth 2.0 のハンドシェイクを自動的に開始します。

2. Cursor IDE

Cursor の「Settings」→「Features」→「MCP」で、次の手順を実行します。

1. + Add New MCP Server をクリックします。
2. Name：geztio
3. Type：Streamable HTTP
4. URL：https://mcp.geztio.co/mcp

3. Antigravity とエージェントフレームワーク

公式の @modelcontextprotocol/sdk または Python SDK を使用するカスタムエージェントから接続するには、次のようにします。

from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

async with streamablehttp_client("https://mcp.geztio.co/mcp") as (read, write):
    async with ClientSession(read, write) as session:
        await session.initialize()
        tools = await session.list_tools()
        print([t.name for t in tools])

---

🛡️ セキュリティとマルチテナント

• 組織ごとのスコープ設定：すべてのクエリは、認証済みメンバーの組織内に厳密に限定されます。
• シートティアに応じたコストのマスキング：
  • SeatTier.FULL：オフィスユーザーとプロジェクトマネージャーには、すべての直接費、通貨、明細合計が表示されます。
  • SeatTier.FIELD：現場監督者と現場作業メンバーには、プロジェクトの数量、レシピ、範囲が表示され、コスト関連フィールドは安全のため null にマスキングされます。
• 詳細なスコープ：
  • geztio:read：カタログ、予算、プロジェクト、価格表への読み取り専用アクセス。
  • unit_costs:write：APU の単価と項目レシピの作成または更新。
  • resources:write：カタログリソースの作成または更新。
  • budgets:write：予算の章の作成と、予算項目の数量の更新。
  • projects:write：新規プロジェクトの作成。
  • operations:write：一括インポートとバッチジョブのキューへの登録。

---

🛠️ ツールカタログ

ID とコンテキスト

ツール	スコープ	説明
geztio_whoami	geztio:read	認証済みメンバー、組織、シートティア（sees_money）、有効なサブスクリプションプランを特定します。

単価分析（APU / UPA）

ツール	スコープ	説明
geztio_search_unit_costs	geztio:read	名前またはコードで APU を検索します。必要に応じて、ネストされたタイプやプロジェクトで絞り込めます。
geztio_get_unit_cost_detail	geztio:read	指定された PriceList に基づき、リソースの内訳、歩掛、ロス率、確定したコストを含む APU の詳細を取得します。
geztio_create_unit_cost	unit_costs:write	組織またはプロジェクトのカタログに新しい単価レシピを作成します。
geztio_add_unit_cost_item	unit_costs:write	APU レシピにリソース項目（資材、労務、機器、運搬）を追加します。
geztio_remove_unit_cost_item	unit_costs:write	APU レシピから項目を削除します。

リソース（資材）と価格表

ツール	スコープ	説明
geztio_search_resources	geztio:read	確定した単価を含むリソース（資材、労務、機器、運搬）を検索します。
geztio_create_resource	resources:write	単位と価格設定モードを指定して、新しいリソースを登録します。
geztio_list_price_lists	geztio:read	有効な価格表（地域別、標準、プロジェクト固有）を一覧表示します。

プロジェクト、予算、CBS の章

ツール	スコープ	説明
geztio_search_projects	geztio:read	名前、コード、実施状況でプロジェクトを検索します。
geztio_get_project_overview	geztio:read	有効な契約予算やシナリオのバージョンを含む、プロジェクトの概要を取得します。
geztio_create_project	projects:write	組織に新しいプロジェクトを作成します。
geztio_get_budget_tree	geztio:read	数量と明細の合計を含む、作業分解構成（WBS/CBS）の章ツリー全体を取得します。
geztio_create_chapter	budgets:write	予算バージョンの CBS 階層に新しい章ノードを作成します。
geztio_update_budget_item_quantity	budgets:write	予算バージョンの明細数量を更新します。

操作とバッチ処理

ツール	スコープ	説明
geztio_import_resources	operations:write	リソースカタログを非同期で一括インポートまたは更新します。execution_id を返します。
geztio_get_execution_status	geztio:read	非同期実行の進捗、エラー、トークン／クォータの使用状況を確認します。

---

💬 プロンプト

サーバーには、事前構築済みの MCP プロンプトテンプレートが含まれています。

1. analizar_unit_cost：APU の技術分析（構成、歩掛、価格の整合性、最適化の提案）。
2. comparar_unit_costs：類似する 2 つの APU の比較分析（差異のある項目、コストのばらつき、推奨される用途）。
3. auditar_lista_de_precios：価格表を自動監査し、統計的な外れ値、価格の欠落、不審な価格差を検出します。

---

📦 リソース

安定した URI で参照できるリソースを提供します。

• geztio://project/{ref}：プロジェクトの JSON 表現を直接取得します。
• geztio://unit-cost/{ref}：APU レシピの JSON 表現を直接取得します。

---

🚀 公開とレジストリのメンテナンス

このリポジトリは mcp-publisher を使用して、メタデータを公式 MCP レジストリに公開します。

ドメイン認証（geztio.co）

co.geztio/* 名前空間のドメイン所有権は、DNS TXT レコードで検証されます。

geztio.co. IN TXT "v=MCPv1; k=ed25519; p=<PUBLIC_KEY_BASE64>"

手動公開

# 1. Login with domain private key
mcp-publisher login dns --domain "geztio.co" --private-key "$MCP_REGISTRY_PRIVATE_KEY"

# 2. Publish server.json
mcp-publisher publish

---

📄 ライセンス

このリポジトリは MIT ライセンス の下でライセンスされています。