mcpField
M
mycase-mcp

mycase-mcp

ローカル
github.com/oktopeak法務・行政62 週間前に更新
リポジトリ

mycase-mcp について

mycase-mcpは、法律事務所向けにClaudeからMyCaseの業務データへアクセスするMCPサーバーです。案件、連絡先、タスク、文書、カレンダー、スタッフ、請求情報を扱い、OAuthトークンをローカルで暗号化します。

主な機能

  1. 01案件の検索と管理
  2. 02連絡先とスタッフの検索
  3. 03案件タスクの一覧と作成
  4. 04文書とカレンダー予定の確認
  5. 05時間記録と請求情報の確認
  6. 06OAuthトークンのローカル暗号化

活用シーン

  1. 01顧客の未完了案件を探す
  2. 02今週が期限のタスクを確認する
  3. 03案件の未払い残高を確認する
  4. 04案件に関連する顧客との通話を記録する

MCP 対応

Claude DesktopなどのMCPクライアントに、MyCaseの認証および業務管理ツールを公開します。APIリクエストはローカルマシンからMyCaseへ直接送信されます。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "oktopeak-mycase": {
      "command": "npx",
      "args": [
        "-y",
        "@oktopeak/mycase-mcp"
      ],
      "env": {
        "MYCASE_CLIENT_ID": "<MYCASE_CLIENT_ID>",
        "MYCASE_CLIENT_SECRET": "<MYCASE_CLIENT_SECRET>",
        "ENCRYPTION_KEY": "<ENCRYPTION_KEY>",
        "MYCASE_REDIRECT_PORT": "<MYCASE_REDIRECT_PORT>",
        "MYCASE_EXPERIMENTAL_TOOLS": "<MYCASE_EXPERIMENTAL_TOOLS>"
      }
    }
  }
}
起動コマンドnpx -y @oktopeak/mycase-mcp
設定が必要な環境変数
MYCASE_CLIENT_IDMyCase OAuth client ID issued by MyCase support for your firm
MYCASE_CLIENT_SECRETシークレットMyCase OAuth client secret issued by MyCase support
ENCRYPTION_KEYシークレット64-character hex key for encrypting stored OAuth tokens (generate with: node -e "console.log(require('crypto').randomBytes(32).toString('hex'))")
MYCASE_REDIRECT_PORTLocal port for the OAuth callback listener (default: 5678). Must match the redirect URI registered with MyCase support.
MYCASE_EXPERIMENTAL_TOOLSSet to '1' to enable experimental tools (log-call) whose API endpoints are unverified.

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@oktopeak/mycase-mcp1.0.4

ツール

17

掲載時のツール一覧 · 2 週間前に更新

このツールにパラメーターはありません。

詳細

MyCase MCP Server

Claude を MyCase の法律業務管理システムに接続します。会話を離れることなく、Claude に事件の検索、連絡先の確認、カレンダーの確認、請求の確認などを依頼できます。

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

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

ヒント

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

以下の README は、JSON 設定ファイルを編集できる方を想定しています。ご自身やチームが該当しない場合は、法律事務所への導入を支援します。対象を絞った認証情報、監査ログの設定、カスタムワークフロー 1 つ、トレーニングを提供します。

→ 事務所全体でのご利用には、月額 300 ドルの Firm Plan をご利用ください。 独自のクラウドにセットアップし、弁護士全員がそれぞれのアカウントでサインインできます。監査ログは 1 つにまとめられ、毎月カスタム自動化を 1 つ構築します。初期費用は不要で、いつでも解約できます。→ oktopeak.com/firm-plan/、または 30 分の相談を予約

ジャンプ先： デモ · インストール · 利用可能なツール · セキュリティ · 導入を依頼するには

デモ

Claude が 1 分足らずで MyCase から事件、連絡先、書類、カレンダーの最新データを取得する様子をご覧ください。チャットにクライアント情報をコピーする必要はありません。

MyCase MCP — Claude が最新データを取得

▶  YouTube で 60 秒のデモを見る

Claude と MyCase を導入する事務所向けのセットアップのヒントと、ABA Opinion 512 のコンプライアンス最新情報。

→ Oktopeak Builder Notes に登録 — 短いメールでお届けします。配信停止も簡単です。

できること

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

  • 「Jane Smith の係属中の事件は何件ありますか？」
  • 「今週が期限のタスクをすべて表示して」
  • 「Anderson 事件の未払い残高はいくらですか？」
  • 「和解についてクライアント #1234 と 20 分間電話した記録を残して」
  • 「事件 98765 に添付された書類を一覧表示して」

すべて MyCase の公式 OAuth 2.0 API を経由します。認証情報が端末の外に出ることはありません。トークンはローカルに保存され、AES-256-GCM で暗号化されます。

前提条件

  • Node.js 18 以降
  • 事務所管理者のアクセス権がある MyCase アカウント
  • MyCase API 認証情報 — 事務所用の OAuth クライアント認証情報を申請するには、MyCase サポートにお問い合わせください。client_id と client_secret が発行されます。

インストール

Claude Desktop を使用する場合（推奨）

次の内容を Claude Desktop の設定ファイルに追加します。

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

{
  "mcpServers": {
    "mycase": {
      "command": "npx",
      "args": ["-y", "@oktopeak/mycase-mcp"],
      "env": {
        "MYCASE_CLIENT_ID": "your_client_id",
        "MYCASE_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

Claude Desktop を再起動すれば完了です。

ヒント

Windows をお使いですか？ 上記の設定は macOS では動作しますが、Windows ではそのままでは動作しません。Could not attach to MCP server mycase（npx の呼び出し）、UNABLE_TO_VERIFY_LEAF_SIGNATURE（企業向けウイルス対策ソフトによる SSL 検査）、OAuth のリダイレクトポートの不一致が発生する可能性があります。Windows 対応の設定と 5 つすべての修正方法は、インストールガイドをご覧ください。

→ MyCase MCP on Windows: The Install Guide We Wish Existed — Windows で発生する 5 つの問題と、MyCase API の認証情報を取得するまでに実際にかかる 13 営業日のスケジュールをすべて解説しています。

単体／開発環境
npm install -g @oktopeak/mycase-mcp

ヒント

設定ファイルを編集する担当者ではありませんか？

上記のインストール方法が大変そうであれば、貴所への導入をお任せいただけます。対象を限定した OAuth 認証情報、貴所のスタックに組み込まれた監査ログ、チームと設計するカスタムワークフロー 1 つ、トレーニングをご提供します。ほとんどの法律事務所にとって、こちらのほうが迅速な方法です。

→ 事務所全体で利用しますか？ 事務所プラン：月額 $300。 貴所専用のクラウドにセットアップし、弁護士全員が各自のログインでサインインできます。監査ログは 1 つ、毎月カスタムの自動化を 1 つ構築します。セットアップ料金は不要で、いつでも解約できます。→ oktopeak.com/firm-plan/、または30 分の導入相談を予約

設定

ローカルで実行する場合（Claude Desktop の環境変数を使用しない場合）は、.env.example を .env にコピーして、値を入力します。

cp .env.example .env

# From MyCase support
MYCASE_CLIENT_ID=your_client_id
MYCASE_CLIENT_SECRET=your_client_secret

# OAuth callback port (default: 5678)
# Must match the redirect URI registered with MyCase support
MYCASE_REDIRECT_PORT=5678

# ENCRYPTION_KEY is optional — a key is auto-generated on first run and
# stored in your OS keychain. Only set this for CI or headless environments.
# ENCRYPTION_KEY=your_64_char_hex_encryption_key

注： MyCase サポートに登録したリダイレクト URI は、http://127.0.0.1:{MYCASE_REDIRECT_PORT}/callback と一致している必要があります。登録したポートがわからない場合は、MyCase サポートにお問い合わせください。

シークレットの取り扱い

MYCASE_CLIENT_SECRET は、設定ファイルに保存する必要がある唯一の機密認証情報です。暗号化キーは OS のキーチェーンによって自動的に管理され、設定ファイルに記載されることはありません。

claude_desktop_config.json を使用する場合は、同じマシン上のほかのユーザーがクライアントシークレットを読み取れないように、ファイルのアクセス許可を制限してください。

macOS：

chmod 600 ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows： ファイルを右クリック → プロパティ → セキュリティ → 編集 → 自分のユーザー以外のすべてのアカウントのアクセスを削除します。

log-call（実験的機能）

API エンドポイントの検証中は、log-call ツールは環境変数で制御されます。

MYCASE_EXPERIMENTAL_TOOLS=1

有効にするには、この設定を claude_desktop_config.json の env ブロックまたは .env ファイルに追加します。Claude に表示しない場合は、設定せずにおきます。

認証

初回使用時に、MyCase で認証する必要があります。

  1. Claude で authenticate ツールを呼び出します
  2. MyCase のログインページがブラウザーで開きます
  3. ログインしてアクセスを許可します
  4. Claude に戻ると接続されています

アクセストークンの有効期間は 24 時間 で、自動的に更新されます。リフレッシュトークンの有効期間は通常 2 週間 です（MyCase API による設定）。リフレッシュトークンの有効期限が切れたら、再認証が必要です。

暗号化されたトークンファイルは ~/.oktopeak-mycase/tokens.enc にあります。ログアウトしてこのファイルを削除するには、logout ツールを呼び出します。

注： OS のキーチェーンが消去された場合や、暗号化キーが失われた場合、既存のトークンファイルは復号できなくなります。サーバーはこれをトークンが存在しないものとして処理し、再認証が必要になります。データが失われることはなく、保存されたセッションが削除されるだけです。

利用可能なツール

認証
ツール説明
authenticateMyCase OAuth ページを開き、トークンを保存します
auth-status接続状況とトークンの有効期限を確認します
logout保存されているトークンをディスクから削除します
ケース
ツール説明
list-casesケースを一覧表示します。ステータス（open／closed）または更新日で絞り込むこともできます
get-caseID を指定してケースの詳細を取得します
create-caseクライアント、スタッフ、メタデータを指定して新しいケースを作成します
連絡先
ツール説明
search-contacts名前、メールアドレス、電話番号でクライアント、人物、会社を検索します
get-contactID を指定して連絡先の詳細を取得します
タスク
ツール説明
list-tasksタスクを一覧表示します。ケースまたは完了状況で絞り込むこともできます
create-taskケースに関連付けられた新しいタスクを作成します
ドキュメント
ツール説明
list-documentsドキュメントを一覧表示します。ケースで絞り込むこともできます
get-document-url指定したドキュメントのダウンロード URL を取得します
カレンダー
ツール説明
list-calendar-events指定した期間内の今後のイベントを一覧表示します
通話
ツール説明
log-callケースまたは連絡先に関連付けて電話の通話記録を登録します（実験的 — MYCASE_EXPERIMENTAL_TOOLS=1 が必要です）
スタッフ
ツール説明
list-staff事務所のスタッフ全員を一覧表示します
get-staffID を指定してスタッフの詳細を取得します
請求
ツール説明
list-time-entries請求対象の作業時間を一覧表示します。ケースまたは期間で絞り込みます
get-billing-summaryケースの請求済み、未払い、支払い済みの合計額を取得します

複数ユーザーへの対応について

このサーバーは設計上、シングルテナントです。一度に保存できる認証情報は1組で、ローカルで実行する単一の事務所向けです。別のユーザーで認証すると、以前のトークンは上書きされます。

複数の事務所またはユーザーで利用するには、個別の設定でインスタンスを別々に実行する必要があります。

開発

git clone https://github.com/oktopeak/mycase-mcp.git
cd mycase-mcp
npm install
cp .env.example .env   # fill in your credentials
npm run build
npm run inspect        # opens the MCP inspector in your browser
テストの実行
npm test               # run once
npm run test:watch     # watch mode

セキュリティ

  • OAuth トークンは、保存時に AES-256-GCM で暗号化されます
  • 暗号化キーは初回実行時に自動生成され、OS のキーチェーン（macOS Keychain／Linux Secret Service／Windows Credential Manager）に保存されます。設定ファイルに記載されることはありません
  • トークンと監査ログのファイルは ~/.oktopeak-mycase/ に保存され、Unix／macOS ではモード 0600（所有者のみ読み書き可能）に設定されます
  • Windows では、フォルダーのプロパティ → セキュリティから %APPDATA%\.oktopeak-mycase のアクセスを制限してください
  • すべての API 呼び出しは、お使いのマシンから external-integrations.mycase.com に直接送信されます
脆弱性スキャン

npm audit --omit=dev では、本番環境の脆弱性は 0 件と報告されます。vitest の開発依存関係には中程度の問題が 5 件（esbuild、vite）ありますが、本番環境からは到達できず、解決には vitest のメジャーバージョンの更新が必要です。デプロイ済みのサーバーインスタンスへの影響はありません。

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

オープンソースのコネクターはMyCaseのデータを読み取り、Claudeが利用できるようにします。多くの法律事務所が最終的に求める機能の約20％をカバーします。

ご要望の範囲に応じて、2つの方法でご支援します。

→ 法律事務所全体向け？ファームプラン：月額300ドル。 お客様のクラウド環境にセットアップし、すべての弁護士が各自のログイン情報でサインイン。監査ログは1つに集約し、毎月お客様向けの自動化を1つ構築します。セットアップ料金なし、いつでも解約できます。→ oktopeak.com/firm-plan/

→ リーガルAIインテグレーション — 複数のワークフローの構築、文書の自動化、インテークの自動化、カスタムAIエージェント、技術スタック全体にわたるコンプライアンスアーキテクチャに対応します。 → oktopeak.com/services/legal-ai-integration/

初日からABA意見書512に準拠しています。動画デモとFAQを含む、このコネクターの概要をご覧になりますか？ → oktopeak.com/mycase-mcp/

まずは相談をご希望ですか？ → 30分のスコープ確認ミーティングを予約

Oktopeakのその他のコネクター

他の業務管理プラットフォーム向けにも、同種のコネクターを提供しています。それぞれにoktopeak.com上の概要ページがあります。

同じアーキテクチャ、同じ監査ログ、同じ保存時暗号化を採用しています。すべてMITライセンスです。

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

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

  • このリポジトリにスターを付けてください。 他の法律事務所がこのプロジェクトを見つけるうえで、本当に役立ちます。
  • MyCaseを利用している他の法律事務所に紹介してください。
  • 直接ご支援できた場合は、レビューを投稿してください。
  • 法律事務所向けの導入、拡張、保守をご希望ですか？ 商用サポート — それが無料の取り組みを支えています。

私たちについて

Oktopeak — 法律事務所および医療分野のデジタルトランスフォーメーション。

私たちは、規制の厳しい業界向けにAIソリューションを開発する、7人の社内プロダクトチームです。AI連携、ワークフローの自動化、お客様が完全に所有できるカスタムソフトウェアを提供しています。5つのオープンソースMCPコネクター — Clio、MyCase、Filevine、Lawmatics、IntakeQ — を保守し、スコープを限定した認証情報、監査ログ、チームの実際の業務に合わせて構築したワークフローを用いて、実際の事業所に導入しています。

ライセンス

MIT — LICENSEをご覧ください。

AnthropicのModel Context Protocol SDKで構築されています。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。