Xero MCP 서버

Xero용 모델 컨텍스트 프로토콜(MCP) 서버 구현입니다. MCP 프로토콜과 Xero API를 연결하여 Xero의 회계 및 비즈니스 기능에 대한 표준화된 액세스를 제공합니다.

특징

• 사용자 정의 연결을 사용한 Xero OAuth2 인증
• 연락처 관리
• 계정 차트 관리
• 송장 생성 및 관리
• MCP 프로토콜 준수

필수 조건

• Node.js(v18 이상)
• npm 또는 pnpm
• API 자격 증명이 있는 Xero 개발자 계정

문서 및 링크

• Xero 공개 API 문서
• 제로 API 탐색기
• Xero OpenAPI 사양
• Xero-Node 공개 API SDK 문서
• 개발자 문서

설정

Xero 계정 만들기

아직 Xero 계정과 조직이 없으신 경우, 여기에서 무료 평가판을 사용하여 가입하고 계정을 만드실 수 있습니다.

데모 회사에는 미리 로드된 샘플 데이터가 포함되어 있으므로, 데모 회사를 먼저 사용하는 것이 좋습니다. 로그인 후 왼쪽 상단 드롭다운 메뉴에서 "데모 회사"를 선택하여 데모 회사로 전환하세요. 데모 회사의 데이터를 재설정하거나 국가를 변경하려면 왼쪽 상단 드롭다운 메뉴에서 "내 Xero" 로 이동하세요. 언제든지 데모 회사의 데이터를 재설정하거나 국가를 변경할 수 있습니다.

참고: 급여 관련 쿼리를 사용하려면 지역을 NZ 또는 영국으로 지정해야 합니다.

입증

Xero MCP 서버에서는 2가지 인증 모드가 지원됩니다.

1. 사용자 정의 연결

이 방식은 테스트 및 개발에 더 적합한 선택이며, 특정 조직의 클라이언트 ID와 비밀번호를 지정할 수 있습니다. Claude Desktop과 같은 타사 MCP 클라이언트에 통합하는 경우에도 권장되는 방식입니다.

Xero 개발자 계정 구성

다음 지침에 따라 사용자 지정 연결을 설정하세요: https://developer.xero.com/documentation/guides/oauth2/custom-connections/

현재 모든 세션에는 다음 범위가 필요합니다. 범위

MCP 서버를 Claude Desktop과 통합

Claude에 MCP 서버를 추가하려면 설정 > 개발자 > 구성 편집으로 이동하여 claude_desktop_config.json 파일에 다음을 추가합니다.

지엑스피1

참고: Node Version Manager "command": "npx" 섹션을 사용하는 경우 실행 파일의 전체 경로로 변경하세요. 예: Mac/Linux의 경우 your_home_directory/.nvm/versions/node/v22.14.0/bin/npx Windows의 경우 "your_home_directory\\.nvm\\versions\\node\\v22.14.0\\bin\\npx"

2. 베어러 토큰

런타임에 여러 Xero 계정을 지원하고 MCP 클라이언트가 필요에 따라 인증 흐름(예: PKCE)을 실행할 수 있도록 허용하려는 경우 이 구성이 더 좋습니다. 이 경우 다음 구성을 사용하세요.

참고: XERO_CLIENT_BEARER_TOKEN 이 정의된 경우 XERO_CLIENT_ID 보다 우선합니다.

사용 가능한 MCP 명령

• list-accounts : 계정 목록을 검색합니다.
• list-contacts : Xero에서 연락처 목록을 검색합니다.
• list-credit-notes : 신용 메모 목록을 검색합니다.
• list-invoices : 송장 목록을 검색합니다
• list-items : 항목 목록을 검색합니다
• list-organisation-details : 조직에 대한 세부 정보를 검색합니다.
• list-profit-and-loss : 손익 보고서 검색
• list-quotes : 인용문 목록을 검색합니다.
• list-tax-rates : 세율 목록을 검색합니다.
• list-payments : 지불 목록을 검색합니다.
• list-trial-balance : 시범 결산서 보고서 검색
• list-profit-and-loss : 손익 보고서 검색
• list-bank-transactions : 은행 계좌 거래 목록을 검색합니다.
• list-payroll-employees : 급여 직원 목록을 검색합니다.
• list-report-balance-sheet : 대차대조표 보고서를 검색합니다.
• list-payroll-employee-leave : 급여 직원의 휴가 기록을 검색합니다.
• list-payroll-employee-leave-balances : 급여 직원의 휴가 잔액을 검색합니다.
• list-payroll-employee-leave-types : 급여 휴가 유형 목록을 검색합니다.
• list-payroll-leave-periods : 급여 직원의 휴가 기간 목록을 검색합니다.
• list-payroll-leave-types : Xero Payroll에서 사용 가능한 모든 휴가 유형 목록을 검색합니다.
• list-aged-receivables-by-contact : 연락처에 대한 오래된 미수금을 검색합니다.
• list-aged-payables-by-contact : 연락처에 대한 오래된 지불금을 검색합니다.
• list-contact-groups : 연락처 그룹 목록을 검색합니다.
• create-contact : 새로운 연락처를 만듭니다
• create-credit-note : 새로운 신용 메모를 만듭니다
• create-invoice : 새로운 송장을 생성합니다
• create-payment : 새로운 결제 생성
• create-quote : 새로운 견적을 만듭니다
• create-credit-note : 새로운 신용 메모를 만듭니다
• create-payroll-timesheet : 새로운 급여 타임시트를 만듭니다.
• update-contact : 기존 연락처 업데이트
• update-invoice : 기존 초안 송장 업데이트
• update-quote : 기존 초안 견적을 업데이트합니다.
• update-credit-note : 기존 신용 메모 초안을 업데이트합니다.
• update-payroll-timesheet-line : 기존 급여 타임시트의 라인을 업데이트합니다.
• approve-payroll-timesheet : 급여 타임시트 승인
• revert-payroll-timesheet : 승인된 급여 타임시트를 되돌립니다.
• add-payroll-timesheet-line : 기존 급여 타임시트에 새 줄을 추가합니다.
• delete-payroll-timesheet : 기존 급여 시간표를 삭제합니다.
• get-payroll-timesheet : 기존 급여 시간표를 검색합니다.

자세한 API 문서는 MCP 프로토콜 사양을 참조하세요.

개발자를 위한

설치

빌드 실행

Claude Desktop과 통합

개발 중인 Xero MCP 서버를 Claude Desktop에 연결하려면 설정 > 개발자 > 구성 편집으로 이동하여 claude_desktop_config.json 파일에 다음을 추가합니다.

참고: Windows의 경우 args 경로가 폴더 사이에 \ 이스케이프해야 합니다(예 "C:\\projects\xero-mcp-server\\dist\\index.js"

특허

MIT

보안

.env 파일이나 기타 민감한 자격 증명을 버전 제어에 커밋하지 마세요(이는 안전한 기본값으로 .gitignore 에 포함되어 있습니다).