xendit-mcp (읽기 전용)

Xendit을 위한 최소한의 읽기 전용 MCP 서버입니다. CareNow 이슈 해결사 에이전트를 위해 구축되었으며, 결제, 지급, 환불 및 가상 계좌(VA) 거래를 조회합니다. 절대로 자금을 이동하지 않습니다.

비공식 프로젝트입니다. Xendit과 제휴하거나 보증하지 않습니다.

왜 읽기 전용인가요?

에이전트는 Xendit 측 필드의 프롬프트 인젝션을 통해서라도 create_disbursement, create_refund 또는 expire_invoice를 호출할 수 없어야 합니다. 이 서버는 GET 엔드포인트만 노출합니다. 심층 방어를 위해 *_READ 권한으로 범위가 지정된 Xendit API 키를 사용하십시오.

설치 및 실행

복제할 필요가 없습니다. npx를 통해 GitHub에서 직접 설치하세요:

{
  "mcpServers": {
    "xendit": {
      "command": "npx",
      "args": ["-y", "github:indratjhai/xendit-mcp"],
      "env": {
        "XENDIT_API_KEY": "xnd_development_..."
      }
    }
  }
}

처음 실행 시 npm이 저장소를 복제하고, 종속성을 설치하며, prepare 스크립트를 통해 npm run build를 실행합니다. 그 이후에는 캐시된 설치본에서 실행됩니다.

재현성을 위해 특정 커밋을 고정하세요:

"args": ["-y", "github:indratjhai/xendit-mcp#<commit-sha>"]

로컬 개발

git clone https://github.com/indratjhai/xendit-mcp.git
cd xendit-mcp
npm install
cp .env.example .env  # fill in XENDIT_API_KEY
npm run dev

API 키

1. https://dashboard.xendit.co/settings/developers#api-keys 로 이동합니다.

2. 읽기 전용(READ-only) 권한이 있는 키를 생성합니다:

   • BALANCE_READ

   • INVOICE_READ

   • TRANSACTION_READ

   • DISBURSEMENT_READ

   • REFUND_READ

   • PAYMENT_REQUEST_READ

3. 개발 중에는 xnd_development_... 테스트 키를 사용하세요.

도구

포함되지 않은 기능 (의도적)

• create_invoice, expire_invoice

• create_disbursement

• create_refund

• create_payment_request

• 모든 POST / PATCH / DELETE

워크플로우에 변경 작업이 필요한 경우, Xendit 대시보드에서 수동으로 수행하거나 사람이 검토하는 별도의 승인 절차를 통해 수행해야 합니다. 에이전트 세션에서 직접 수행해서는 안 됩니다.

보안 참고 사항

• API 키는 XENDIT_API_KEY 환경 변수에서 읽어옵니다. 로그에 기록되거나 도구 출력으로 전송되지 않습니다.

• 네트워크 송신은 https://api.xendit.co로 하드코딩되어 있으며, 다른 호스트는 허용되지 않습니다.

• 경로 구성 요소 ID는 ^[a-zA-Z0-9_-]+$에 대해 검증되고 URL 인코딩됩니다.

• 모든 도구 입력은 zod로 검증됩니다.

• 런타임 종속성: @modelcontextprotocol/sdk, zod만 사용합니다.

라이선스

MIT