Moneybird MCP Server

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

클로드 데스크탑 설정

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

1. 아직 설치하지 않았다면 패키지를 전역으로 설치하세요 .
   npm install -g moneybird-mcp-server
2. 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" } } } }
3. 변경 사항을 적용하려면 Claude Desktop을 다시 시작하세요.
4. Claude 채팅 입력란에 /mcp moneybird 입력하여 MCP 서버에 연결합니다.

사용 예

기본 연락처 목록

개요

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

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

필수 조건

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

설정

1. 이 저장소를 복제하세요:
   git clone https://github.com/vanderheijden86/moneybird-mcp-server.git cd moneybird-mcp-server
2. 종속성 설치:
   npm install
3. 다음 예제에서 .env 파일을 만듭니다.
   cp .env.example .env
4. Moneybird 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