MCP 문서 관리

메뉴

홈
문서 목록
관리자 로그인

문서 정보

최종 수정일:
2025-05-13 00:59
태그:
#써드파티 #회계 #결제 #인보이스

링크된 문서

역링크

Xero MCP 서버

Xero MCP 서버

Xero Logo

개요

Xero MCP 서버는 Model Context Protocol (MCP)과 Xero API 사이의 브릿지 역할을 수행하는 공식 서버입니다. 이 서버를 통해 AI 어시스턴트가 Xero의 회계 및 비즈니스 기능에 접근할 수 있으며, 회계 데이터를 관리하고 비즈니스 운영을 효율화할 수 있습니다.

특징

  • Xero OAuth2 인증: 커스텀 연결을 통한 인증 지원
  • 연락처 관리: 연락처 목록 조회, 생성 및 업데이트
  • 계정 차트 관리: 모든 계정 목록 조회
  • 인보이스 관리: 인보이스 생성, 조회, 업데이트
  • 견적 및 신용 노트 관리: 견적서 및 신용 노트 작성, 조회, 업데이트
  • 급여 관리: 직원 급여, 휴가 등 급여 관련 기능
  • 보고서: 손익 계산서, 시산표, 대차 대조표 등 다양한 회계 보고서 생성

API

리소스

  • 연락처(Contact)
  • 계정(Account)
  • 인보이스(Invoice)
  • 품목(Item)
  • 신용 노트(Credit Note)
  • 견적서(Quote)
  • 세율(Tax Rate)
  • 결제(Payment)
  • 급여(Payroll)
  • 보고서(Report)

도구

계정 관리

  • list-accounts: Xero에 등록된 모든 계정을 조회합니다
  • 입력: 없음
  • 출력: 계정 목록

연락처 관리

  • list-contacts: 등록된 모든 연락처를 조회합니다
  • 입력: page (선택적) - 페이지 번호
  • 출력: 연락처 목록
  • create-contact: 새로운 연락처를 생성합니다
  • 입력: 연락처 정보 (이름, 이메일, 주소 등)
  • 출력: 생성된 연락처 정보
  • update-contact: 기존 연락처 정보를 업데이트합니다
  • 입력: 연락처 ID, 업데이트할 정보
  • 출력: 업데이트된 연락처 정보
  • list-contact-groups: 모든 연락처 그룹을 조회합니다
  • 입력: 없음
  • 출력: 연락처 그룹 목록

인보이스 관리

  • list-invoices: 모든 인보이스를 조회합니다
  • 입력: 없음
  • 출력: 인보이스 목록
  • create-invoice: 새 인보이스를 생성합니다
  • 입력: 인보이스 정보(연락처, 항목, 금액 등)
  • 출력: 생성된 인보이스 정보
  • update-invoice: 초안 상태의 인보이스를 업데이트합니다
  • 입력: 인보이스 ID, 업데이트할 정보
  • 출력: 업데이트된 인보이스 정보

견적 관리

  • list-quotes: 모든 견적서를 조회합니다
  • 입력: 없음
  • 출력: 견적서 목록
  • create-quote: 새 견적서를 생성합니다
  • 입력: 견적서 정보(연락처, 항목, 금액 등)
  • 출력: 생성된 견적서 정보
  • update-quote: 초안 상태의 견적서를 업데이트합니다
  • 입력: 견적서 ID, 업데이트할 정보
  • 출력: 업데이트된 견적서 정보

신용 노트 관리

  • list-credit-notes: 모든 신용 노트를 조회합니다
  • 입력: 없음
  • 출력: 신용 노트 목록
  • create-credit-note: 새 신용 노트를 생성합니다
  • 입력: 신용 노트 정보(연락처, 항목, 금액 등)
  • 출력: 생성된 신용 노트 정보
  • update-credit-note: 초안 상태의 신용 노트를 업데이트합니다
  • 입력: 신용 노트 ID, 업데이트할 정보
  • 출력: 업데이트된 신용 노트 정보

품목 관리

  • list-items: 모든 품목을 조회합니다
  • 입력: 없음
  • 출력: 품목 목록

결제 관리

  • list-payments: 모든 결제를 조회합니다
  • 입력: 없음
  • 출력: 결제 목록
  • create-payment: 새 결제를 생성합니다
  • 입력: 결제 정보(인보이스 ID, 금액, 결제 일자 등)
  • 출력: 생성된 결제 정보

급여 관리

  • list-payroll-employees: 급여 관리 대상 직원 목록을 조회합니다
  • 입력: 없음
  • 출력: 직원 목록
  • list-payroll-employee-leave: 직원의 휴가 기록을 조회합니다
  • 입력: 직원 ID
  • 출력: 휴가 기록 목록
  • list-payroll-employee-leave-balances: 직원의 휴가 잔여일수를 조회합니다
  • 입력: 직원 ID
  • 출력: 휴가 잔여일수 정보
  • create-payroll-timesheet: 새 근무 시간표를 생성합니다
  • 입력: 근무 시간표 정보
  • 출력: 생성된 근무 시간표 정보
  • update-payroll-timesheet-line: 근무 시간표 항목을 업데이트합니다
  • 입력: 근무 시간표 ID, 항목 ID, 업데이트 정보
  • 출력: 업데이트된 근무 시간표 정보
  • approve-payroll-timesheet: 근무 시간표를 승인합니다
  • 입력: 근무 시간표 ID
  • 출력: 승인 상태
  • revert-payroll-timesheet: 승인된 근무 시간표를 되돌립니다
  • 입력: 근무 시간표 ID
  • 출력: 되돌림 상태

보고서 생성

  • list-profit-and-loss: 손익 계산서를 조회합니다
  • 입력: 없음
  • 출력: 손익 계산서 데이터
  • list-trial-balance: 시산표를 조회합니다
  • 입력: 없음
  • 출력: 시산표 데이터
  • list-report-balance-sheet: 대차 대조표를 조회합니다
  • 입력: 없음
  • 출력: 대차 대조표 데이터
  • list-aged-receivables-by-contact: 연락처별 미수금 에이징 리포트를 조회합니다
  • 입력: 연락처 ID
  • 출력: 미수금 에이징 데이터
  • list-aged-payables-by-contact: 연락처별 미지급금 에이징 리포트를 조회합니다
  • 입력: 연락처 ID
  • 출력: 미지급금 에이징 데이터

조직 정보

  • list-organisation-details: Xero 조직 세부 정보를 조회합니다
  • 입력: 없음
  • 출력: 조직 정보

사용 방법

사전 요구사항

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

설치 및 구성

  1. Xero 계정 생성
  2. Xero 계정이 없는 경우 여기에서 무료 평가판으로 가입합니다.

  3. 데모 데이터가 포함된 Demo Company를 사용하는 것이 좋습니다.

  4. 인증 설정

  5. Xero MCP 서버는 두 가지 인증 모드를 지원합니다:

    1. 커스텀 연결 (개발 및 테스트용 권장)
    2. 베어러 토큰 (여러 Xero 계정 지원 시 사용)

  6. 클라이언트 연결

  7. Claude Desktop에 MCP 서버 추가: 
    {
  "mcpServers": {
    "xero": {
      "command": "npx",
      "args": ["-y", "@xeroapi/xero-mcp-server@latest"],
      "env": {
        "XERO_CLIENT_ID": "your_client_id_here",
        "XERO_CLIENT_SECRET": "your_client_secret_here"
      }
    }
  }
}

주의사항

  • Payroll 관련 쿼리를 사용하려면 지역이 NZ 또는 UK여야 합니다.
  • 현재 다음 스코프가 모든 세션에 필요합니다: accounting.transactions, accounting.contacts, accounting.settings, payroll.employees

연결된 구성 요소

참조 링크