브렉스 MCP 서버

Brex API와 통합하여 AI 에이전트가 재무 데이터 및 리소스와 상호 작용할 수 있도록 하는 MCP(모델 컨텍스트 프로토콜) 서버입니다.

개요

이 MCP 서버는 AI 에이전트와 Brex 금융 플랫폼 간의 브리지를 제공하여 에이전트가 다음을 수행할 수 있도록 합니다.

계좌 정보 및 거래 내역 검색
비용 데이터 및 영수증에 액세스
예산 리소스 및 지출 한도 관리
팀 정보 보기

서버는 MCP 사양을 따르는 표준화된 리소스 핸들러와 도구를 구현하여 재무 데이터에 대한 안전하고 효율적인 액세스를 가능하게 합니다.

특징

자원

계정 리소스

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

종속성 설치:

npm install

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

서버를 빌드하세요:

npm run build

Claude를 사용한 구성

Claude Desktop을 사용하려면 Claude의 구성 파일에 서버를 추가해야 합니다.

macOS의 경우: ~/Library/Application Support/Claude/claude_desktop_config.json Windows의 경우: %APPDATA%\Claude\claude_desktop_config.json

데스크톱용 Claude를 열고 Claude 메뉴를 클릭하고 "설정..."을 선택하여 설정으로 이동합니다.
왼쪽 사이드바에서 "개발자"를 클릭한 다음 "구성 편집"을 클릭하세요.
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 값만 필요합니다. 다른 환경 변수에는 적절한 기본값이 있지만 필요한 경우 사용자 정의가 가능합니다.

파일을 저장하고 Claude for Desktop을 다시 시작하세요.
입력 상자의 오른쪽 하단에 있는 망치 아이콘을 확인하여 서버가 작동하는지 확인하세요.

개발

자동 재빌드를 사용한 개발의 경우:

npm run dev

코드를 린트하세요:

npm run lint

테스트 실행:

npm run test

디버깅

MCP 서버는 stdio를 통해 통신하므로 디버깅이 어려울 수 있습니다. 디버깅에는 MCP Inspector를 사용하는 것이 좋습니다.

보안 고려 사항

이 서버는 여러 가지 보안 조치를 구현하고 있습니다.

민감한 재정 리소스에 대한 읽기 전용 작업
코드에 API 자격 증명을 저장하지 않음
API 요청에 대한 속도 제한
적절한 오류 처리 및 로깅

구현 상태

다양한 기능의 자세한 구현 계획과 상태를 보려면 documentation/implementation_plan.md 참조하세요.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

작가

데니슨 버트램 - dennison@dennisonbertram.com

Brex MCP Server

Integrations