Brex MCP Server

Brex MCP Server

Brex API 用の Model Context Protocol（MCP）サーバーです。投影とバッチ処理により、安全で小規模な読み取り専用レスポンスを最適化しています。

インストール

Claude Code

# Install the package
npm install -g mcp-brex

# Add to Claude Code with your API key
claude mcp add brex --env BREX_API_KEY=your_brex_api_key -- npx mcp-brex

Claude Desktop

claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "brex": {
      "command": "npx",
      "args": ["mcp-brex"],
      "env": {
        "BREX_API_KEY": "your_brex_api_key"
      }
    }
  }
}

手動セットアップ（開発）

git clone https://github.com/dennisonbertram/mcp-brex.git
cd mcp-brex
npm install
npm run build
claude mcp add brex --env BREX_API_KEY=your_key -- node build/index.js

リソース

• brex://expenses | brex://expenses/{id} | brex://expenses/card | brex://expenses/card/{id}
• brex://budgets | brex://budgets/{id}
• brex://spend_limits | brex://spend_limits/{id}
• brex://budget_programs | brex://budget_programs/{id}
• brex://transactions/card/primary | brex://transactions/cash/{id}
• brex://docs/usage（エージェント向けの簡潔な使用ガイド）

注意：

• リソースでは、ペイロードサイズを調整するために ?summary_only=true&fields=id,status,... を指定できます。
• 経費リソースでは、読みやすさのために merchant と budget が自動的に展開されます。

ツール（特記がない限り読み取り専用）

• 予算：get_budgets、get_budget
• 支出限度額：get_spend_limits、get_spend_limit
• 予算プログラム：get_budget_programs、get_budget_program
• 経費（単一ページ）：get_expenses
• 経費（ページネーション対応）：get_all_expenses、get_all_card_expenses
• ID で経費を取得：get_expense、get_card_expense
• カード明細：get_card_statements_primary
• 取引：get_card_transactions、get_cash_transactions
• 現金口座明細：get_cash_account_statements
• アカウント：get_all_accounts、get_account_details
• 領収書（書き込み）：match_receipt、upload_receipt
• 更新（書き込み）：update_expense

ツールの呼び出し方

パラメーターは必ず arguments の下に指定してください（input ではありません）。ページネーションとフィルタリングを使って、ペイロードを小さく保ってください。

一般的なパラメーター：

• ページネーション：page_size（<=50）、max_items（<=200 を推奨）
• 日付フィルタリング：start_date、end_date、window_days
• ステータスフィルタリング：経費／取引用の status 配列
• 金額フィルタリング：経費用の min_amount、max_amount
• 加盟店フィルタリング：経費用の merchant_name
• 展開の制御：ネストされたオブジェクトを含めるための expand 配列（例：["merchant", "budget"]）

推奨例：

{
  "name": "get_all_card_expenses",
  "arguments": {
    "page_size": 10,
    "max_items": 20,
    "start_date": "2025-08-25T00:00:00Z",
    "end_date": "2025-08-26T00:00:00Z",
    "status": ["APPROVED"],
    "min_amount": 100
  }
}

{
  "name": "get_expenses",
  "arguments": {
    "limit": 5,
    "status": "APPROVED"
  }
}

{
  "name": "get_card_transactions",
  "arguments": {
    "limit": 10,
    "posted_at_start": "2025-08-25T00:00:00Z"
  }
}

{
  "name": "get_all_accounts",
  "arguments": {
    "page_size": 10,
    "max_items": 20,
    "status": "ACTIVE"
  }
}

{
  "name": "get_transactions",
  "arguments": {
    "accountId": "acc_123456789",
    "limit": 10
  }
}

{
  "name": "get_expenses",
  "arguments": {
    "limit": 5,
    "expand": ["merchant", "user"]
  }
}

ページネーションとフィルタリングのベストプラクティス

重要：サマリーに頼るのではなく、ページネーション、フィルタリング、並べ替えを使ってレスポンスサイズを制御してください。

データ制御に使用する主なパラメーター：

• page_size: number — 1ページあたりの項目数（推奨：≤50）
• max_items: number — 全ページを通じた最大項目数（推奨：≤200）
• start_date/end_date: string — ISO 日付範囲によるフィルタリング
• window_days: number — 大きな日付範囲を小さなバッチに分割
• status: string[] — ステータスによるフィルタリング（例：["APPROVED", "PENDING"]）
• min_amount/max_amount: number — 経費の金額によるフィルタリング

ベストプラクティス：

• 大量のリクエストでは、巨大なレスポンスを避けるために必ず日付範囲を指定してください
• 小さなページサイズ（≤50）と適切な max_items（≤200）を使用してください
• 必要なデータだけを取得できるよう、ステータスフィルターを適用してください
• window_days（例：7）を使って、大きな日付範囲をバッチ処理してください
• expand パラメーターでネストされたオブジェクトの展開を制御してください：
  • デフォルト：expand: [] は、簡潔なオブジェクト（各約500～1000トークン）を返します
  • 展開時：expand: ["merchant", "budget"] は、完全なオブジェクト（各約15K以上のトークン）を返します
  • 使用可能な expand オプション：merchant、budget、user、department、location、receipts
• 上限を増やす前に、小さな上限でテストしてください
• 現金関連エンドポイントには追加の Brex スコープが必要です。403 エラーは適切に処理してください

公開

公開されるのは build/、README.md、LICENSE のみです。

ライセンス

MIT — LICENSE を参照してください。