@treebeam/mcp

TreeBeam을 위한 MCP(Model Context Protocol) 서버 — 재무 관리 및 회계 플랫폼입니다. 이 서버를 사용하면 AI 어시스턴트가 MCP 호환 클라이언트를 통해 TreeBeam 조직 및 프로젝트와 상호 작용할 수 있습니다.

사전 요구 사항

• Node.js 18 이상 — Node.js 설치 방법

• Git (소스에서 설치하는 경우에만 필요) — Git 설치 방법

• Claude Code (AI 어시스턴트로 사용하는 경우) — Claude Code 설치 방법

• TreeBeam 계정 — treebeam.com에서 가입하세요.

이러한 도구가 처음이신가요? 위 링크마다 설치 과정을 단계별로 안내하는 쉬운 가이드가 있습니다.

Related MCP server: CashChat MCP Server

설치

npm (권장)

npm install -g @treebeam/mcp

소스에서 설치

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

인증

이 서버는 인증을 위해 OAuth 2.0 장치 흐름(device flow)을 사용합니다. 토큰은 OS 키체인(macOS 키체인, Windows 자격 증명 보관소 또는 Linux Secret Service)에 안전하게 저장됩니다. 인증이 완료되면 토큰이 캐시되고 자동으로 갱신됩니다.

AI 어시스턴트에서 (권장)

가장 쉬운 인증 방법은 AI 대화 내에서 직접 수행하는 것입니다. 어시스턴트에게 TreeBeam에 로그인해 달라고 요청하기만 하면 됩니다. 그러면 treebeam_login 도구를 사용하여 장치 흐름을 시작하고, 링크를 제공하며, 나머지는 자동으로 처리합니다. 터미널 명령어가 필요하지 않습니다.

또한 treebeam_auth_status 및 treebeam_logout 도구를 사용하여 언제든지 어시스턴트에게 인증 상태를 확인하거나 로그아웃하도록 요청할 수 있습니다.

명령줄 (대안)

AI 클라이언트 외부에서 인증하는 것을 선호한다면 CLI를 직접 사용할 수 있습니다:

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

소스에서 실행하는 경우, 위 명령어의 treebeam-mcp를 npm run으로 대체하세요.

클라이언트 구성

클라이언트의 구성 파일에 TreeBeam MCP 서버를 추가하세요. JSON 구조는 클라이언트마다 동일하며 파일 위치만 다릅니다.

구성 파일 위치:

npm을 통해 전역으로 설치한 경우:

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

소스에서 실행하는 경우:

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

기타 MCP 클라이언트

MCP 호환 클라이언트라면 이 서버를 사용할 수 있습니다. stdio 전송 방식으로 구성하세요. 클라이언트가 프로세스를 시작하고 stdin/stdout을 통해 통신합니다.

사용 가능한 도구

연결되면 AI 어시스턴트에서 다음 도구를 사용할 수 있습니다. 주요 내용은 다음과 같습니다:

이 서버는 엔티티, 계정, 계정 그룹, 기간, 미조정 잔액, 조정, 조정 항목, 엔티티 관계 세트에 대한 전체 CRUD 작업을 포함하여 총 47개의 도구를 제공합니다. 각 리소스는 search_*, get_*, create_*, update_* 및 delete_* 작업을 지원합니다. 전체 목록은 src/tool.js를 참조하세요.

인증은 자동으로 처리됩니다. 세션 중에 토큰이 만료되면 서버가 장치 흐름을 통해 재인증을 시작합니다.

문제 해결

"Not authenticated" 오류

treebeam-mcp login (또는 소스에서 npm run login)을 실행하여 재인증하세요. 문제가 지속되면 먼저 treebeam-mcp logout을 실행하여 오래된 자격 증명을 지운 다음 다시 로그인하세요.

키체인 액세스 문제

이 서버는 OS 키체인 저장을 위해 keytar를 사용합니다. Linux에서는 libsecret이 설치되어 있는지 확인하세요:

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

# Fedora
sudo dnf install libsecret-devel

Node.js 버전

Node.js 18 이상을 실행 중인지 확인하세요:

node --version

라이선스

Apache License 2.0 — Copyright 2026 TNS Solutions, Inc.