Moneybird MCP 서버

API를 통해 Claude와 같은 AI 도우미를 Moneybird 회계 소프트웨어에 연결하는 MCP(Model Context Protocol) 서버입니다.

특징

연락처 관리 : 연락처 나열, 검색, 필터링, 생성 및 업데이트
- 생성 날짜, 업데이트 날짜, 이름 등을 기준으로 고급 필터링
재무 데이터 : 판매 송장, 재무 계정 및 지불에 액세스
사업 운영 : 제품, 프로젝트 및 시간 항목 관리
사용자 정의 요청 : Moneybird 엔드포인트에 대한 사용자 정의 API 요청 만들기
대화형 어시스턴트 : Moneybird 어시스턴트를 위한 사전 구성된 프롬프트

새로운 개발

향상된 연락처 필터링 : Moneybird의 고급 쿼리 구문을 사용하여 연락처 필터링
- 생성 날짜로 필터링: created_after:2023-01-01 00:00:00 UTC
- 업데이트 날짜로 필터링: updated_after:2023-01-01 10:45:35 UTC
- 속성별로 필터링: first_name:value 등.
개선된 오류 처리 : 더 나은 오류 메시지 및 복구
성능 최적화 : 대용량 데이터 세트에 대한 응답 청킹
TypeScript 통합 : Zod 스키마 검증을 통한 전체 유형 안전성

설치 지침

기본 설정

패키지를 설치하세요 :지엑스피1
Moneybird 자격 증명으로 .env 파일을 만듭니다 .
MONEYBIRD_API_TOKEN=your_api_token MONEYBIRD_ADMINISTRATION_ID=your_administration_id
서버를 실행합니다 :
npx moneybird-mcp-server

클로드 데스크탑 설정

Claude Desktop에서 이 MCP 서버를 설정하려면:

아직 설치하지 않았다면 패키지를 전역으로 설치하세요 .
npm install -g moneybird-mcp-server
MCP 서버 구성을 포함하도록 Claude Desktop 구성 파일(일반적으로 ~/Library/Application Support/Claude/claude_desktop_config.json 에 있음)을 만들거나 편집합니다 .
{ "mcpServers": { "moneybird": { "command": "npx", "args": [ "-y", "moneybird-mcp-server" ], "env": { "MONEYBIRD_API_TOKEN": "your_api_token_here", "MONEYBIRD_ADMINISTRATION_ID": "your_administration_id_here" } } } }
변경 사항을 적용하려면 Claude Desktop을 다시 시작하세요.
Claude 채팅 입력란에 /mcp moneybird 입력하여 MCP 서버에 연결합니다.

사용 예

기본 연락처 목록

개요

이 서버는 AI 비서가 모델 컨텍스트 프로토콜(Model Context Protocol)을 사용하여 Moneybird 회계 데이터와 상호 작용할 수 있도록 지원합니다. 다음과 같은 다양한 도구를 제공합니다.

연락처 나열 및 검색
판매 송장 보기
금융 계좌 확인
제품 및 프로젝트에 액세스하세요
시간 항목 보기
사용자 정의 Moneybird API 요청 만들기

필수 조건

Node.js(v18 이상 권장)
API 접근이 가능한 Moneybird 계정
Moneybird API 토큰

설정

이 저장소를 복제하세요:
git clone https://github.com/vanderheijden86/moneybird-mcp-server.git cd moneybird-mcp-server
종속성 설치:
npm install
다음 예제에서 .env 파일을 만듭니다.
cp .env.example .env
Moneybird API 자격 증명으로 .env 파일을 편집합니다.
- MONEYBIRD_API_TOKEN : 귀하의 Moneybird API 토큰( https://moneybird.com/user/applications 에서 생성)
- MONEYBIRD_ADMINISTRATION_ID : Moneybird 관리 ID(로그인 시 URL에서 확인 가능)
- MCP_SERVER_PORT : MCP 서버를 실행할 포트(기본값: 3000)

서버 실행

개발을 위해:

npm run dev

생산을 위해:

npm run build
npm start

AI 어시스턴트와 함께 사용

이 MCP 서버는 모델 컨텍스트 프로토콜(MCP)을 지원하는 모든 AI 어시스턴트와 호환됩니다. 실행 후 서버 URL을 입력하여 AI 어시스턴트에 연결할 수 있습니다.

http://your-server-address:3000

사용 가능한 도구

서버는 다음과 같은 도구를 제공합니다.

list_contacts : Moneybird의 모든 연락처를 나열합니다.
get_contact : ID로 특정 연락처에 대한 세부 정보를 가져옵니다.
list_sales_invoices : 모든 판매 송장을 나열합니다
get_sales_invoice : ID별로 특정 판매 송장에 대한 세부 정보를 가져옵니다.
list_financial_accounts : 모든 금융 계좌를 나열합니다
list_products : 모든 제품 나열
list_projects : 모든 프로젝트 나열
list_time_entries : 모든 시간 항목을 나열합니다
moneybird_request : Moneybird API에 대한 사용자 정의 요청을 만듭니다.

보안

이 서버는 Moneybird 데이터에 대한 액세스를 제공하므로 적절한 보안 조치를 취해야 합니다. 다음 사항을 고려하세요.

보안 프록시 뒤에서 실행
MCP 서버에 대한 인증 구현
HTTPS 사용
네트워크 접근 제한

특허

MIT

Moneybird MCP Server

Integrations