@treebeam/mcp

Servidor MCP (Model Context Protocol) para TreeBeam, una plataforma de gestión financiera y contabilidad. Este servidor permite a los asistentes de IA interactuar con tus organizaciones y proyectos de TreeBeam a través de cualquier cliente compatible con MCP.

Requisitos previos

• Node.js 18 o superior — Cómo instalar Node.js

• Git (solo necesario si se instala desde el código fuente) — Cómo instalar Git

• Claude Code (si se utiliza como asistente de IA) — Cómo instalar Claude Code

• Una cuenta de TreeBeam — regístrate en treebeam.com

¿Eres nuevo en estas herramientas? Cada enlace anterior contiene una guía sencilla que te llevará paso a paso por la instalación.

Related MCP server: freee Accounting MCP Server

Instalación

npm (recomendado)

npm install -g @treebeam/mcp

Desde el código fuente

git clone https://github.com/treebeam-code/tb-mcpserver.git
cd tb-mcpserver
npm install

Autenticación

El servidor utiliza el flujo de dispositivo OAuth 2.0 para la autenticación. Los tokens se almacenan de forma segura en el llavero de tu sistema operativo (Llavero de macOS, Administrador de credenciales de Windows o Secret Service de Linux). Una vez autenticado, los tokens se almacenan en caché y se actualizan automáticamente.

En tu asistente de IA (recomendado)

La forma más fácil de autenticarse es directamente dentro de tu conversación con la IA. Solo pídele al asistente que inicie sesión en TreeBeam; utilizará la herramienta treebeam_login para iniciar el flujo de dispositivo, proporcionarte un enlace y gestionar el resto automáticamente. No se necesitan comandos de terminal.

También puedes pedirle al asistente que verifique tu estado de autenticación o que cierre sesión en cualquier momento utilizando las herramientas treebeam_auth_status y treebeam_logout.

Línea de comandos (alternativa)

Si prefieres autenticarte fuera de tu cliente de IA, puedes usar la CLI directamente:

treebeam-mcp login       # Opens browser to complete sign-in
treebeam-mcp status      # Check current auth status
treebeam-mcp logout      # Remove stored credentials

Si ejecutas desde el código fuente, reemplaza treebeam-mcp con npm run en los comandos anteriores.

Configuración del cliente

Añade el servidor MCP de TreeBeam al archivo de configuración de tu cliente. La estructura JSON es la misma en todos los clientes; solo cambia la ubicación del archivo.

Ubicaciones de los archivos de configuración:

Si se instaló globalmente mediante npm:

{
  "mcpServers": {
    "treebeam": {
      "command": "treebeam-mcp"
    }
  }
}

Si se ejecuta desde el código fuente:

{
  "mcpServers": {
    "treebeam": {
      "command": "node",
      "args": ["/absolute/path/to/tb-mcpserver/src/index.js"]
    }
  }
}

Otros clientes MCP

Cualquier cliente compatible con MCP puede usar este servidor. Configúralo como un transporte stdio: el cliente inicia el proceso y se comunica a través de stdin/stdout.

Herramientas disponibles

Una vez conectado, las siguientes herramientas estarán disponibles para tu asistente de IA. Aquí tienes algunos puntos destacados:

El servidor proporciona 47 herramientas en total que cubren operaciones CRUD completas para entidades, cuentas, grupos de cuentas, periodos, saldos sin ajustar, ajustes, partidas de ajuste y conjuntos de relaciones de entidades. Cada recurso admite operaciones search_*, get_*, create_*, update_* y delete_*. Consulta src/tool.js para ver la lista completa.

La autenticación se gestiona automáticamente: si tu token caduca durante una sesión, el servidor inicia la reautenticación mediante el flujo de dispositivo.

Solución de problemas

Errores de "No autenticado"

Ejecuta treebeam-mcp login (o npm run login desde el código fuente) para volver a autenticarte. Si el problema persiste, ejecuta primero treebeam-mcp logout para borrar las credenciales obsoletas y luego inicia sesión de nuevo.

Problemas de acceso al llavero

El servidor utiliza keytar para el almacenamiento en el llavero del SO. En Linux, asegúrate de que libsecret esté instalado:

# Debian/Ubuntu
sudo apt install libsecret-1-dev

# Fedora
sudo dnf install libsecret-devel

Versión de Node.js

Verifica que estás ejecutando Node.js 18 o superior:

node --version

Licencia

Licencia Apache 2.0 — Copyright 2026 TNS Solutions, Inc.