Xero MCP 서버
Xero용 모델 컨텍스트 프로토콜(MCP) 서버 구현입니다. MCP 프로토콜과 Xero API를 연결하여 Xero의 회계 및 비즈니스 기능에 대한 표준화된 액세스를 제공합니다.
특징
사용자 정의 연결을 사용한 Xero OAuth2 인증
연락처 관리
계정 차트 관리
송장 생성 및 관리
MCP 프로토콜 준수
Related MCP server: ABAP-ADT-API MCP-Server
필수 조건
Node.js(v18 이상)
npm 또는 pnpm
API 자격 증명이 있는 Xero 개발자 계정
문서 및 링크
설정
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 에 포함되어 있습니다).