figuard-mcp

figuard-mcp

FiGuard MCP サーバー — SDK コードを書かずに、Claude Code、Cursor、または Claude Desktop から FiGuard を直接使用できます。

できること

14 個の FiGuard ツールを AI アシスタントに追加します。SDK コードを書く代わりに、Claude に話しかけるだけです。

「500 ドルの旅行予算を作成し、航空券に 300 ドル、ホテルに 200 ドルを割り当ててください」 → Claude が figuard_create_budget を呼び出します

「この予算からエコノミークラスの航空券 149 ドルを承認してください」 → Claude が figuard_authorize を呼び出し、AUTHORIZED または DENIED を返します

「航空券の実際の料金は 147 ドルでした。実際の金額を確定してください」 → Claude が figuard_confirm を呼び出します

必要条件

• Node.js 18 以降
• FiGuard サーバーが稼働していること（ローカルまたはサンドボックス）

セットアップ

Claude Code

claude mcp add figuard-mcp \
  --env FIGUARD_API_KEY=fg_live_... \
  --env FIGUARD_BASE_URL=http://localhost:8080

または、~/.claude/claude_desktop_config.json に手動で追加します。

{
  "mcpServers": {
    "figuard": {
      "command": "npx",
      "args": ["figuard-mcp"],
      "env": {
        "FIGUARD_API_KEY": "fg_live_...",
        "FIGUARD_BASE_URL": "http://localhost:8080"
      }
    }
  }
}

Cursor

プロジェクトの .cursor/mcp.json（またはグローバル設定の ~/.cursor/mcp.json）に追加します。

{
  "mcpServers": {
    "figuard": {
      "command": "npx",
      "args": ["figuard-mcp"],
      "env": {
        "FIGUARD_API_KEY": "fg_live_...",
        "FIGUARD_BASE_URL": "http://localhost:8080"
      }
    }
  }
}

Claude Desktop

macOS の場合、~/Library/Application Support/Claude/claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "figuard": {
      "command": "npx",
      "args": ["figuard-mcp"],
      "env": {
        "FIGUARD_API_KEY": "fg_live_...",
        "FIGUARD_BASE_URL": "http://localhost:8080"
      }
    }
  }
}

サンドボックスを使用する（Docker 不要）

FIGUARD_BASE_URL にホストされたサンドボックスを指定すると、ローカルサーバーを実行せずに FiGuard を試せます。

{
  "FIGUARD_API_KEY": "sb_live_demo",
  "FIGUARD_BASE_URL": "https://figuard-sandbox-g1ha.onrender.com"
}

利用可能なツール

ツール	機能
figuard_create_budget	支出用の予算枠を作成します。session_token を返します
figuard_authorize	事前確認を行い、理由とともに AUTHORIZED または DENIED を返します
figuard_confirm	成功後、実際の金額で予約を確定します
figuard_fail	処理が失敗した場合に予約を解放します
figuard_void	未使用の予約をキャンセルします
figuard_get_budget	予算の状態、使用済み額、予約額、利用可能額を確認します
figuard_get_ledger	絞り込み条件を指定して、すべての支出イベントを一覧表示します
figuard_resume_budget	異常検知によって一時停止された予算を再開します
figuard_extend_budget	予算の有効期限を延長します
figuard_cancel_batch	1 回の呼び出しで最大 100 件の予算をキャンセルします
figuard_fund_budget	予算の総上限を調整します（CREDIT ／ DEBIT ／ RESET ／ RESET_SPENT）
figuard_create_delegation_token	フリート予算に対する、エージェントごとにスコープが限定されたトークンを作成します
figuard_revoke_delegation_token	委任トークンを取り消します（冪等）
figuard_get_delegation_token	委任トークンの状態と上限の使用状況を確認します

セキュリティに関する注意

FIGUARD_API_KEY はツールの引数ではなく、環境変数として設定します。ツールの引数は LLM のコンテキストウィンドウに表示されるため、API キーをツールのパラメーターとして渡してはいけません。

figuard_create_budget が返すセッショントークンは短時間で期限切れになります（予算の期限とともに失効します）。セッション内でツールの引数として安全に使用できます。

FiGuard をローカルで実行する

git clone https://github.com/figuard/figuard-core
cd figuard-core
docker compose up -d

FiGuard は http://localhost:8080 で利用できます。