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.

Related MCP server: YNAB MCP Server

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

1. Clonar este repositorio:

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

2. Instalar dependencias:

npm install

3. 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

4. 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

1. Abra Claude for Desktop y vaya a la configuración haciendo clic en el menú Claude y seleccionando "Configuración..."

2. Haga clic en "Desarrollador" en la barra lateral izquierda, luego haga clic en "Editar configuración".

3. 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.

4. Guarde el archivo y reinicie Claude for Desktop

5. 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