Brex MCP サーバー

Brex API と統合し、AI エージェントが金融データやリソースと対話できるようにするモデル コンテキスト プロトコル (MCP) サーバー。

概要

この MCP サーバーは、AI エージェントと Brex 金融プラットフォーム間のブリッジを提供し、エージェントが次のことを実行できるようにします。

• アカウント情報と取引を取得する

• 経費データと領収書にアクセスする

• 予算リソースと支出限度額を管理する

• チーム情報を見る

サーバーは、MCP 仕様に準拠した標準化されたリソース ハンドラーとツールを実装し、財務データへの安全で効率的なアクセスを可能にします。

Related MCP server: YNAB MCP Server

特徴

リソース

アカウントリソース

• brex://accounts - すべてのアカウントを一覧表示する

• brex://accounts/{id} - 特定のアカウントの詳細にアクセスする

経費リソース

• brex://expenses - ページ区切りですべての経費をリストします

• brex://expenses/{id} - 特定の経費の詳細にアクセスする

• brex://expenses/card - すべてのカード経費を一覧表示する

• brex://expenses/card/{id} - 特定のカード経費の詳細にアクセスする

注: 経費リソースは、販売業者と予算の情報を自動的に拡張し、ID の代わりに人間が判読できる名前を表示します。

予算リソース

• brex://budgets - ページ区切りですべての予算を一覧表示します

• brex://budgets/{id} - 特定の予算の詳細にアクセスする

• brex://spend_limits - すべての支出限度額を一覧表示する

• brex://spend_limits/{id} - 特定の支出限度額の詳細にアクセスする

• brex://budget_programs - すべての予算プログラムを一覧表示する

• brex://budget_programs/{id} - 特定の予算プログラムの詳細にアクセスする

チームリソース

• brex://users/me - 現在のユーザー情報を取得する

ツール

領収書管理

• match_receipt - 領収書と既存の経費を照合する

• upload_receipt - 特定の経費の領収書をアップロードする

経費管理

• update_expense - カード経費の詳細（メモ、カテゴリなど）を更新します

• get_all_expenses - フィルタリングオプションと拡張された販売者/予算情報を使用してすべての経費を取得します

• get_all_card_expenses - フィルタリングオプションと拡張された加盟店/予算情報を使用して、すべてのカード経費を取得します

注: セキュリティ上の理由から、予算、支出限度額、予算プログラムを作成、更新、削除するツールはこのバージョンでは実装されていません。

インストール

前提条件

• Node.js v18以上

• Brex API アクセストークン

設定

1. このリポジトリをクローンします:

git clone https://github.com/dennisonbertram/brex-mcp-server.git
cd brex-mcp-server

2. 依存関係をインストールします:

npm install

3. Brex API トークンを使用して.envファイルを作成します。

BREX_API_KEY=your_token_here
BREX_API_URL=https://platform.brexapis.com
PORT=3000
NODE_ENV=development
RATE_LIMIT_REQUESTS=1000
RATE_LIMIT_WINDOW_MS=60000
LOG_LEVEL=info

4. サーバーを構築します。

npm run build

クロードとの構成

Claude Desktop で使用するには、Claude の構成ファイルにサーバーを追加する必要があります。

macOS の場合: ~/Library/Application Support/Claude/claude_desktop_config.json Windows の場合: %APPDATA%\Claude\claude_desktop_config.json

1. Claude for Desktop を開き、Claude メニューをクリックして「設定...」を選択し、設定に移動します。

2. 左側のサイドバーの「開発者」をクリックし、「設定の編集」をクリックします。

3. Brex MCP サーバー設定で構成ファイルを更新します。

{
  "mcpServers": {
    "brex-server": {
      "command": "node",
      "args": [
        "/path/to/brex-mcp-server/build/index.js"
      ],
      "env": {
        "BREX_API_KEY": "your_brex_api_key_here",
        "BREX_API_URL": "https://platform.brexapis.com",
        "PORT": "3000",
        "NODE_ENV": "development",
        "RATE_LIMIT_REQUESTS": "1000",
        "RATE_LIMIT_WINDOW_MS": "60000",
        "LOG_LEVEL": "info"
      }
    }
  }
}

必ず次の点に注意してください:

• /path/to/brex-mcp-serverサーバーをインストールした実際のパスに置き換えます。

• your_brex_api_key_here実際の Brex API キーに置き換えます。

• サーバーの場所に絶対パスを使用する

必須なのはBREX_API_KEY値とBREX_API_URL値だけです。他の環境変数には適切なデフォルトが設定されていますが、必要に応じてカスタマイズできます。

4. ファイルを保存し、Claude for Desktopを再起動します。

5. 入力ボックスの右下隅にあるハンマーアイコンをチェックして、サーバーが動作していることを確認します。

発達

自動リビルドを使用した開発の場合:

npm run dev

コードをリントする:

npm run lint

テストを実行します:

npm run test

デバッグ

MCPサーバーはstdio経由で通信するため、デバッグが困難になる場合があります。デバッグにはMCP Inspectorの使用をお勧めします。

セキュリティに関する考慮事項

このサーバーはいくつかのセキュリティ対策を実装しています。

• 機密性の高い財務リソースに対する読み取り専用操作

• コード内に API 認証情報を保存しない

• APIリクエストのレート制限

• 適切なエラー処理とログ記録

実施状況

詳細な実装計画とさまざまな機能のステータスについては、 documentation/implementation_plan.mdを参照してください。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

著者

デニソン・バートラム - dennison@dennisonbertram.com