lawmatics-mcp

Lawmatics MCP サーバー

Claude を Lawmatics の法律業務向け CRM に接続します。Lawmatics では標準機能で作成できないパイプラインレポートの取得、案件や連絡先の検索、インテークフォームの送信内容の確認、フォローアップタスクの作成などを、会話を離れることなく Claude に依頼できます。

Oktopeak が開発 — 法律事務所向け AI トランスフォーメーションと自動化

法律・医療関連事業者のデジタルトランスフォーメーション。 事務所が完全に所有できる AI 連携、ワークフロー自動化、カスタムソフトウェアを開発しています。このコネクターもその一つです。→ 30 分の相談を予約

ヒント

開発者でなくても大丈夫です。

以下の README は、JSON 設定ファイルを編集できる方を想定しています。ご自身やチームが該当しない場合は、法律事務所向けに導入を支援します。認証情報の範囲設定、ご希望に応じた読み取り専用モード、監査ログの設定、カスタムワークフロー 1 件、トレーニングが含まれます。

→ 事務所全体で利用する場合は、ファームプランをご利用ください。月額 $300 です。 お客様のクラウド環境にセットアップし、弁護士がそれぞれ自身のログイン情報でサインインできます。監査ログは 1 つに集約され、毎月お客様向けの自動化を 1 件構築します。セットアップ料金は不要で、いつでも解約できます。→ oktopeak.com/firm-plan/、または30 分の相談を予約

目次： できること · インストール · API アクセスの取得 · 利用可能なツール · 読み取り専用モード · セキュリティ · 既知の API の制限 · その他のコネクター · 導入支援をご希望ですか？

---

できること

接続すると、Claude が Lawmatics の事務所データに直接アクセスできるようになります。たとえば、次のように依頼できます。

• 「診療分野ごとに、未解決の PNC はいくつありますか？」
• 「今四半期に実際に受任した案件は、どのマーケティング経路から来ましたか？」
• 「『Consult Completed』のステージにあり、タスクが紐付いていない案件をすべて表示してください」
• 「7 月の人身傷害の見込み客を、カスタムのインテーク項目とあわせてすべてエクスポートしてください」
• 「今週、Smith のインテークフォームに送信された内容を教えてください」
• 「Jones の案件に、金曜日を期限として Sarah に割り当てるフォローアップタスクを作成してください」

Lawmatics の標準レポート機能は、多くの事務所でよく不満の声が上がっています。このコネクターを使うと、Claude がレポート作成を担います。カスタム項目を含む元データを取得し、集計、クロス集計、書式設定を行います。

プロジェクトの状況

このサーバーは、Lawmatics 公式 API ドキュメント（v1.22）と公開されているリクエスト例に厳密に基づいて構築されており、80 件を超える単体テストで、文書化されたリクエスト／レスポンスの仕様を検証しています。実際の事務所アカウントではまだ実行されていません。 実際の API との不一致に遭遇した場合は、ツール名とエラーテキストを添えてイシューを作成してください。これがオープンソースにしている理由です。実際の利用報告によって、誰もが安心して使えるものになります。

---

前提条件：Lawmatics API へのアクセスを取得する

• Node.js 18+
• 管理者アクセス権を持つ Lawmatics アカウント
• アカウントで Developer Settings が有効になっていること。Lawmatics では、API アクセスを有効にするためにサポートへのリクエストが必要です。Lawmatics サポートに連絡するか、[email protected] にメールを送り、Developer Settings を有効にするよう依頼してください。無料ですが、デフォルトでは有効になっていません。
• 開発者アプリ：Developer Settings を有効にしたら、Lawmatics の Settings → Developers に移動してアプリを作成し、Callback URL に http://localhost:5678/callback を設定してください。Client ID と Client Secret が発行されます。

アクセストークンを取得する（初回のみ）

Lawmatics のアクセストークンは有効期限がないため、この操作は一度だけ行います。

LAWMATICS_CLIENT_ID=your_client_id LAWMATICS_CLIENT_SECRET=your_client_secret npx -y @oktopeak/lawmatics-mcp auth

表示された URL を開いてアクセスを許可すると、コマンドからトークンと、そのまま貼り付けて使える設定スニペットが出力されます。トークンはパスワードと同じように保管してください。トークンを持っている人は誰でも、開発者アプリを削除するまで、法律事務所の Lawmatics データにフルアクセスできます。

インストール

Claude Desktop を使用する（推奨）

以下を Claude Desktop の設定ファイルに追加します。

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json Windows： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "lawmatics": {
      "command": "npx",
      "args": ["-y", "@oktopeak/lawmatics-mcp"],
      "env": {
        "LAWMATICS_ACCESS_TOKEN": "your_token_here"
      }
    }
  }
}

Claude Desktop を再起動します。接続を確認するには、「Lawmatics には誰としてログインしていますか？」 と尋ねてください（get-current-user が呼び出されます）。

Claude Code を使用する

claude mcp add lawmatics -e LAWMATICS_ACCESS_TOKEN=your_token_here -- npx -y @oktopeak/lawmatics-mcp

---

利用可能なツール

37 個のツール。 Lawmatics では「prospects」と呼ばれる案件（Matters）には、PNC、受任、失注を問わず、すべてのリードと案件が含まれます。

グループ	ツール
案件	list-matters、get-matter、find-matter（メールアドレス／電話番号／名前で検索）、create-matter、update-matter
連絡先	list-contacts、get-contact、find-contact、create-contact、update-contact
企業	list-companies、get-company、find-company
パイプラインと法律事務所のデータ	list-pipelines、list-stages、list-practice-areas、list-sources、list-sub-statuses、list-users、get-current-user
タスク	list-tasks、create-task、update-task
イベント	list-events、create-event
メモとタイムライン	list-notes、create-note、list-activities
タグ	list-tags、attach-tags、detach-tags
カスタムフィールド	list-custom-fields（および実験的な set-matter-custom-fields。詳細は以下を参照）
インテークフォーム	list-forms、get-form、get-form-entries、submit-form
請求	list-invoices（Lawmatics API では読み取り専用）

すべてのリストツールは、Lawmatics のクエリ機能を全面的にサポートしています。単一のフィルター（filter_by／filter_on／filter_with と =、!=、<、>、like、ilike、null、not_null）、並べ替え、フィールド選択（custom_fields を含む fields）、ページネーションを利用できます。さらに、ページネーションをたどって最大 1,000 件を取得し、結果が途中で切り詰められた場合は必ず通知する fetch_all オプションもあります。

カスタムフィールド

Lawmatics を利用する法律事務所では、カスタムフィールドが重要です。読み取るには、任意の get／list ツールの fields パラメーターに custom_fields を追加してください。list-custom-fields は、選択肢リストのオプションを含め、すべてのフィールド定義を表示するため、Claude が値を解釈できます。

カスタムフィールド値の書き込みについては、Lawmatics のドキュメントが十分に整備されていません。そのため、実際のアカウントでリクエスト形式が確認されるまで、set-matter-custom-fields はフラグで無効化されています。有効にするには LAWMATICS_EXPERIMENTAL_TOOLS=1 を設定してください。動作を確認した場合は、ぜひご報告ください。

読み取り専用モード

サーバーの環境設定で LAWMATICS_READ_ONLY=1 を設定すると、すべての書き込みツール（作成／更新／タグ付け／送信）が完全に削除されます。単にブロックされるのではなく、Claude からは存在しないものとして扱われます。初回導入時、レポート作成のみの用途、慎重に導入したいパートナーにおすすめです。

設定リファレンス

環境変数	用途
LAWMATICS_ACCESS_TOKEN	必須。 OAuth アクセストークン（有効期限はありません）。
LAWMATICS_READ_ONLY	1 = すべての書き込みツールを無効にします。
LAWMATICS_EXPERIMENTAL_TOOLS	1 = Lawmatics が API 仕様をまだ完全には文書化していないツールを有効にします。
LAWMATICS_RATE_LIMIT_PER_MIN	クライアント側のスロットリングです。デフォルトは 50 です（Lawmatics は 50/分と 150/分の両方を案内しているため、安全な方をデフォルトにしています）。
LAWMATICS_AUDIT_LOG	0 = ローカル監査ログを無効にします。
LAWMATICS_AUDIT_LOG_PATH	監査ログの保存先（デフォルトは ~/.lawmatics-mcp/audit.log）。
LAWMATICS_CLIENT_ID / LAWMATICS_CLIENT_SECRET	1 回限りの auth コマンドでのみ使用します。
LAWMATICS_REDIRECT_PORT	OAuth コールバックポート（デフォルトは 5678）。
LAWMATICS_API_BASE	API ベース URL の上書き（デフォルトは https://api.lawmatics.com/v1）。

セキュリティ

• トークンはお使いのマシンから外に出ません。 MCP 設定ファイルに保存され、api.lawmatics.com にのみ送信されます。このサーバーにはバックエンドもテレメトリーもなく、外部に情報を送信することもありません。
• 監査ログ。 各ツール呼び出し（名前、引数、結果）は、ローカルの JSONL ファイル ~/.lawmatics-mcp/audit.log に追記されるため、事務所の管理者はいつでも「AI が何に触れたか」を確認できます。ツールの引数にはクライアントデータ（氏名、メールアドレス、メモのテキストなど）が含まれる場合があります。ログはお使いのマシンにのみ保存されますが、事務所のデータ保持ポリシーに含めるか、LAWMATICS_AUDIT_LOG=0 で無効にしてください。
• 最小権限に関する注意点。 Lawmatics API にはスコープがなく、すべてのトークンが完全な CRUD アクセス権を持ちます。読み取り専用モードは Lawmatics ではなく、このサーバーによって適用されます。監査ログと併用し、アクセスを完全に取り消すには開発者アプリを削除してください。
• データフロー。 Claude が要求したレコードデータは、Lawmatics からこのローカルプロセスを経由して MCP クライアントとそのモデルコンテキストに流れます。クライアントデータを扱う他のベンダーと同様に、AI プロバイダーのデータ取り扱い条件を確認してください。

Lawmatics API の既知の制限事項

基盤となる API がサポートしていないため、このコネクターでは実行できない操作（API v1.22 時点）：

• パイプラインのステージ移動はできません。 API でステージは読み取り専用として公開されます。更新時の sub_status_id が最も近い制御手段です。
• 1 リクエストにつきフィルターは 1 つです。 複雑なクエリでは fetch_all を使用し、Claude に結果を絞り込ませる必要があります。
• ページサイズは 25 件に固定されています。 大量のエクスポートでは、25 件ごとに 1 回のリクエストが必要です（組み込みのスロットリングがレート制限を遵守します）。
• 請求書、パイプライン、ソース、キャンペーンは読み取り専用です。
• API 経由での電子署名、ドキュメントテンプレート、メール送信、自動化の管理には対応していません。
• Webhook は Lawmatics ダッシュボードでのみ設定できます（API による管理には対応していません）。

ロードマップ

ファイルのアップロード／ダウンロード、時間記録と経費、関係性、タスクのサブタスク／コメント、Collections（Lawmatics のカスタムデータテーブル）を、需要のおおよその順に追加する予定です。より早い対応が必要な場合は、issue を作成してください。

Oktopeak のその他のコネクター

各コネクターには、oktopeak.com にセットアップ手順と FAQ を掲載した専用の概要ページがあります。

• Clio MCP：Clio の業務管理。ソース：github.com/oktopeak/clio-mcp
• MyCase MCP：MyCase の業務管理。ソース：github.com/oktopeak/mycase-mcp
• Filevine MCP：Filevine の案件管理。ソース：github.com/oktopeak/filevine-mcp
• IntakeQ MCP：IntakeQ / PracticeQ の受付（医療）

同じアーキテクチャで、監査ログ機能も共通です。すべて MIT ライセンスです。

コネクター以上のものが必要ですか？

コネクターは無料で、今後も無料です。企業が当社に依頼するのは、その周辺のサービスです。すべての弁護士のマシンへの導入、範囲を限定した認証情報、カスタムワークフロー（「毎朝、昨日の新規リードを流入元別に、問い合わせへの回答とともに一覧表示する」）、Lawmaticsにない連携機能、そしてZapierでは手に負えなくなったときの本番環境向けソフトウェアレイヤーなどです。

→ 事務所全体でのご利用ですか？ファームプランは月額$300です。 お客様のクラウドにセットアップし、各弁護士がそれぞれのログイン情報でサインイン。監査ログを一元化し、毎月1つの自動化をお客様向けに構築します。セットアップ料金は不要で、いつでも解約できます。→ oktopeak.com/firm-plan/ · 30分の相談を予約

このコネクターの概要やよくある質問をご覧になりますか？ → oktopeak.com/lawmatics-mcp/

このプロジェクトを支援する

このコネクターは無料で、MITライセンスのもとで提供され、Oktopeakが保守しています。今後も無料で提供し、寄付は受け付けていません。時間の節約に役立った場合は、次の方法でご支援いただけます。

• このリポジトリにスターを付けてください。 他の事務所がこのプロジェクトを見つけるうえで、本当に役立ちます。
• Lawmaticsを利用している別の事務所にもお知らせください。
• 直接お役に立てた場合は、**レビューを投稿**してください。
• 事務所向けの導入、拡張、保守が必要ですか？ **商用サポート**をご利用ください。これが無料の取り組みを支える資金になります。

開発

npm install
npm test          # 80+ unit tests against the documented API contract
npm run build
npm run inspect   # MCP Inspector against the built server

コントリビューションを歓迎します。特に、実際のLawmaticsアカウントでの動作報告をお待ちしています。

ライセンス

MIT © Oktopeak