DrillerDB

DrillerDB MCP サーバー

DrillerDB向けのリモートModel Context Protocolサーバーです。DrillerDBは、井戸掘削業者向けのオペレーティングシステムです。DrillerDBアカウントを Microsoft Copilot、Claude、ChatGPT、Codex、Cursor、VS Code、または任意のMCPクライアントに接続すると、実際の案件、顧客、請求書、作業員、井戸の掘削記録を自然な英語で扱えます。

https://mcp.drillerdb.com

トランスポート	Streamable HTTP
認証	OAuth 2.0（Authorization Code + PKCE、Dynamic Client Registration）
ホスティング	DrillerDB, LLC が管理します。インストールもセルフホストも不要です。
アカウント	有効なDrillerDBアカウントが必要です（app.drillerdb.com）
レジストリ名	com.drillerdb/drillerdb
詳細ドキュメント	drillerdb.com/connectors/mcp

このリポジトリには、公開ドキュメントと、ホスト型DrillerDB MCP サーバーのレジストリマニフェストserver.jsonが含まれています。 サーバー自体はマネージドサービスであり、そのソースは公開されていません。

---

クイックスタート

MCPクライアントでカスタムコネクターとしてサーバーURLを追加します。初回使用時にOAuthサインインが自動的に行われ、アクセス範囲はご自身のDrillerDB企業に限定されます。

Claude Code

claude mcp add --transport http drillerdb https://mcp.drillerdb.com

Claude（ウェブおよびデスクトップ）

Settings -> Connectors -> Add custom connector の順に選択し、https://mcp.drillerdb.comを貼り付けます。

Microsoft Copilot

DrillerDBでは、Microsoft MCP認定に向けてサーバーを準備中です。Microsoftが認定済みコネクターを公開した後、管理者はMicrosoftのエージェントおよびコネクターカタログから有効にできます。同じDrillerDB OAuthサインインと企業レベルの権限が適用されます。

Gemini CLI

このリポジトリからDrillerDB拡張機能を直接インストールします。

gemini extensions install https://github.com/DrillerDB/drillerdb-mcp

Gemini CLIはgemini-extension.jsonから管理エンドポイントを読み込み、サーバーの認証時にDrillerDB OAuthサインインフローを開始します。

Cursor / VS Code / その他のクライアント

{
  "mcpServers": {
    "drillerdb": {
      "type": "http",
      "url": "https://mcp.drillerdb.com"
    }
  }
}

クライアントは/.well-known/oauth-protected-resourceと、401応答時のWWW-AuthenticateヘッダーからOAuthエンドポイントを自動的に検出するため、クライアントIDやシークレットを手動で設定する必要はありません。

---

質問できること

• 「今週、スケジュールを組める案件はどれですか？」
• 「Acme Farmsがまだ支払っていない金額はいくらで、支払期限からどれくらい経っていますか？」
• 「Johnsonプロジェクトの井戸の掘削記録を表示してください。」
• 「今四半期の売上の進捗は、前四半期と比べてどうですか？」
• 「メンテナンスの期限が近づいている掘削機はどれですか？」
• 「今日の作業員の現場報告書を作成し、案件に添付してください。」

---

権限スコープ

スコープ	許可される操作
mcp:read	プロジェクト、顧客、請求書、提案書、作業指示書、作業員、スケジュール、現場報告書、機材、タイムカード、通信履歴、在庫、井戸の掘削記録の読み取り
mcp:write:low	メモの添付や現場報告書の提出など、簡単に取り消せる書き込み操作
mcp:write:high	案件のスケジュール設定や出動指示、請求書の送信など、状態を変更する書き込み操作
mcp:proposals:write	提案書の作成と送付

リスクの高い書き込みツールには承認が必要です。ツールはまずapproval-requiredの結果を返し、DrillerDBコンソールで承認した後にのみ操作が実行されます。顧客への連絡や金銭の移動を伴う操作は、明示的な確認なしには行われません。

---

セキュリティ

• テナントの分離。 すべてのクエリは、ツールの入力ではなく、OAuth トークンに紐付けられた company_id でフィルタリングされます。他の請負業者のデータにアクセスする方法はありません。
• 監査ログ。 すべてのツール呼び出しが記録されます。呼び出したユーザー、使用したツール、呼び出し日時、結果が記録されます。
• アクセスの取り消しが可能。 DrillerDB アカウントからいつでもコネクターのアクセスを取り消せます。取り消すと、トークンは直ちに無効になります。
• レート制限。 利用者ごとの制限によって、サービスとアカウントが保護されます。
• ファーストパーティ。 API とデータは DrillerDB が所有しています。コネクターのデータが販売されたり、広告に使用されたりすることはありません。

データの収集、使用、保持方法については、DrillerDB プライバシーポリシーをご覧ください。

---

ツール一覧

読み取りツール（37）

ツール	タイトル
ar_aging_report	売掛金経過期間レポート
customer_ltv_report	顧客生涯価値レポート
get_communication_detail	コミュニケーションの詳細を取得
get_company_proposal_habits	会社の提案傾向を取得
get_compliance_form	コンプライアンスフォームを取得
get_equipment_detail	機器の詳細を取得
get_geology_at_location	場所の地質情報を取得
get_invoice_detail	請求書の詳細を取得
get_job_profitability	作業の収益性を取得
get_maintenance_due	期限の近いメンテナンスを取得
get_project_compliance_status	プロジェクトのコンプライアンス状況を取得
get_project_detail	プロジェクトの詳細を取得
get_project_financials	プロジェクトの財務情報を取得
get_proposal_detail	提案書の詳細を取得
get_quote_detail	見積書の詳細を取得
get_quote_engagement	見積書への反応を取得
get_timecard_summary	タイムカードの概要を取得
get_work_order_detail	作業指示書の詳細を取得
list_communications	コミュニケーションの一覧
list_contacts	連絡先の一覧
list_crews	作業班の一覧
list_customers	顧客の一覧
list_equipment	機器の一覧
list_field_reports	現場レポートの一覧
list_inventory	在庫の一覧
list_invoices	請求書の一覧
list_my_projects	自分のプロジェクトの一覧
list_project_files	プロジェクトファイルの一覧
list_projects_by_customer	顧客別プロジェクトの一覧
list_proposals	提案書の一覧
list_timecards	タイムカードの一覧
list_work_orders	作業指示書の一覧
query_schedule	スケジュールを検索
query_well_logs	井戸記録を検索
revenue_pipeline	売上パイプライン
run_report	レポートを実行
total_billed_by_contact	連絡先別請求総額

書き込みツール（8）

ツール	タイトル	スコープ	承認が必要
attach_note_to_project	プロジェクトにメモを添付	mcp:write:low	いいえ
dispatch_project	プロジェクトを派遣	mcp:write:high	はい
import_vendor_invoice	仕入先の請求書をインポート	mcp:write:high	はい
plan_crew_route	作業班のルートを計画	mcp:write:low	いいえ
schedule_project	プロジェクトをスケジュール	mcp:write:high	はい
send_invoice	請求書を送信	mcp:write:high	はい
submit_field_report	現場レポートを提出	mcp:write:low	いいえ
update_project_status	プロジェクトの状況を更新	mcp:write:high	はい
すべてのツールで openWorldHint: false が宣言されています。各ツールは、呼び出し元の会社自身の DrillerDB テナントデータのみを操作します。

---

サポート

• ドキュメント：https://drillerdb.com/connectors/mcp
• メール：[email protected]
• ドキュメントに関する問題：このリポジトリで issue を作成してください。

DrillerDB について

DrillerDB は、水井戸掘削業者や掘削請負業者向けに、プロジェクト管理、井戸記録、スケジュール管理、提案書、請求書、機器の追跡、顧客履歴をひとつのシステムで提供します。詳しくはdrillerdb.comをご覧ください。

ライセンス

このリポジトリのドキュメントは MIT ライセンスです。ホスト型 DrillerDB MCP サーバーの利用には、DrillerDB 利用規約が適用されます。