Moneybird MCP 서버
API를 통해 Claude와 같은 AI 도우미를 Moneybird 회계 소프트웨어에 연결하는 MCP(Model Context Protocol) 서버입니다.
특징
연락처 관리 : 연락처 나열, 검색, 필터링, 생성 및 업데이트
생성 날짜, 업데이트 날짜, 이름 등을 기준으로 고급 필터링
재무 데이터 : 판매 송장, 재무 계정 및 지불에 액세스
사업 운영 : 제품, 프로젝트 및 시간 항목 관리
사용자 정의 요청 : Moneybird 엔드포인트에 대한 사용자 정의 API 요청 만들기
대화형 어시스턴트 : Moneybird 어시스턴트를 위한 사전 구성된 프롬프트
Related MCP server: Ledger CLI MCP Server
새로운 개발
향상된 연락처 필터링 : 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-serverMCP 서버 구성을 포함하도록 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 .envMoneybird API 자격 증명으로
.env파일을 편집합니다.MONEYBIRD_API_TOKEN: 귀하의 Moneybird API 토큰( https://moneybird.com/user/applications 에서 생성)MONEYBIRD_ADMINISTRATION_ID: Moneybird 관리 ID(로그인 시 URL에서 확인 가능)MCP_SERVER_PORT: MCP 서버를 실행할 포트(기본값: 3000)
서버 실행
개발을 위해:
생산을 위해:
AI 어시스턴트와 함께 사용
이 MCP 서버는 모델 컨텍스트 프로토콜(MCP)을 지원하는 모든 AI 어시스턴트와 호환됩니다. 실행 후 서버 URL을 입력하여 AI 어시스턴트에 연결할 수 있습니다.
사용 가능한 도구
서버는 다음과 같은 도구를 제공합니다.
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