Servidor Brex MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) para la integración con la API de Brex, lo que permite a los agentes de IA interactuar con datos y recursos financieros.

Descripción general

Este servidor MCP proporciona un puente entre los agentes de IA y la plataforma financiera Brex, lo que permite a los agentes:

Recuperar información de la cuenta y transacciones
Acceda a datos de gastos y recibos
Administrar los recursos presupuestarios y los límites de gasto
Ver información del equipo

El servidor implementa manejadores de recursos y herramientas estandarizados siguiendo la especificación MCP, lo que permite un acceso seguro y eficiente a los datos financieros.

Características

Recursos

Recursos de la cuenta

brex://accounts - Listar todas las cuentas
brex://accounts/{id} - Acceder a detalles específicos de la cuenta

Recursos de gastos

brex://expenses - Lista todos los gastos con paginación
brex://expenses/{id} - Acceda a detalles de gastos específicos
brex://expenses/card - Lista todos los gastos de la tarjeta
brex://expenses/card/{id} - Acceda a los detalles específicos de gastos de la tarjeta

Nota : Los recursos de gastos expanden automáticamente la información del comerciante y del presupuesto para mostrar nombres legibles por humanos en lugar de identificaciones.

Recursos presupuestarios

brex://budgets - Lista todos los presupuestos con paginación
brex://budgets/{id} - Acceda a detalles presupuestarios específicos
brex://spend_limits - Lista todos los límites de gasto
brex://spend_limits/{id} - Acceda a detalles específicos del límite de gasto
brex://budget_programs - Lista de todos los programas presupuestarios
brex://budget_programs/{id} - Acceda a los detalles específicos del programa presupuestario

Recursos del equipo

brex://users/me - Obtener información actual del usuario

Herramientas

Gestión de recibos

match_receipt - Emparejar un recibo con los gastos existentes
upload_receipt - Sube un recibo para un gasto específico

Gestión de gastos

update_expense - Actualizar los detalles de un gasto de tarjeta (memo, categoría, etc.)
get_all_expenses : obtenga todos los gastos con opciones de filtrado e información ampliada del comerciante y el presupuesto
get_all_card_expenses : obtenga todos los gastos de la tarjeta con opciones de filtrado e información ampliada del comerciante y el presupuesto

Nota : Por razones de seguridad, las herramientas que crean, actualizan o eliminan presupuestos, límites de gasto y programas de presupuesto no están implementadas en esta versión.

Instalación

Prerrequisitos

Node.js v18 o superior
Token de acceso a la API de Brex

Configuración

Clonar este repositorio:

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

Instalar dependencias:

npm install

Cree un archivo .env con su token de API de Brex:

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

Construir el servidor:

npm run build

Configuración con Claude

Para utilizar con Claude Desktop, debe agregar el servidor al archivo de configuración de Claude:

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

Abra Claude for Desktop y vaya a la configuración haciendo clic en el menú Claude y seleccionando "Configuración..."
Haga clic en "Desarrollador" en la barra lateral izquierda, luego haga clic en "Editar configuración".
Actualice el archivo de configuración con la configuración del servidor 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"
      }
    }
  }
}

Asegúrese de:

Reemplace /path/to/brex-mcp-server con la ruta real donde instaló el servidor
Reemplace your_brex_api_key_here con su clave API de Brex real
Utilice rutas absolutas para la ubicación del servidor

Solo se requieren los valores BREX_API_KEY y BREX_API_URL ; las demás variables de entorno tienen valores predeterminados razonables, pero se pueden personalizar si es necesario.

Guarde el archivo y reinicie Claude for Desktop
Verifique que el servidor esté funcionando verificando el ícono del martillo en la esquina inferior derecha del cuadro de entrada

Desarrollo

Para desarrollo con reconstrucción automática:

npm run dev

Limpia tu código:

npm run lint

Ejecutar pruebas:

npm run test

Depuración

Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser complicada. Recomendamos usar el Inspector MCP para depurar.

Consideraciones de seguridad

Este servidor implementa varias medidas de seguridad:

Operaciones de solo lectura para recursos financieros sensibles
No se almacenan credenciales de API en el código
Limitación de velocidad para solicitudes de API
Manejo y registro de errores adecuados

Estado de implementación

Para obtener un plan de implementación detallado y el estado de las distintas funciones, consulte documentation/implementation_plan.md .

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Autor

Dennison Bertram - dennison@dennisonbertram.com

Brex MCP Server

Integrations