Skip to main content
Glama
@mobilpay/mcp-server

@mobilpay/mcp-server

by KGMobilians

@mobilpay/mcp-server

npm version License: MIT

Dies ist ein MCP-Server (Model Context Protocol) für die Integration der Zahlungsdienste von KG Financial.

Wenn Sie in KI-Coding-Tools (Cursor, Claude Code, Kiro, VS Code, Windsurf, Claude Desktop usw.) Fragen in natürlicher Sprache stellen, werden die Zahlungs-Integrationsdokumente (27 an der Zahl) automatisch durchsucht, um präzisen Code zu generieren.

Unterstützte Dienste

Dienst

Beschreibung

Anzahl Dokumente

MOBILPAY REST API

Universelle Zahlungsintegration (Mobiltelefon/Kreditkarte/Überweisung/Virtuelles Konto/Einfache Zahlung/Mobile T-Money)

18

NEZO (내죠여왕)

Kakao AlimTalk Zahlungsanfragedienst

9

Related MCP server: samsung-checkout-mcp

Installation und Konfiguration

  • Node.js 18+ erforderlich (Ziel: ES2022)

  • Verwendet stdio-Übertragung — kein Netzwerk erforderlich, Offline-Betrieb möglich

Cursor

.cursor/mcp.json:

{
  "mcpServers": {
    "mobilpay": {
      "command": "npx",
      "args": ["-y", "@mobilpay/mcp-server@latest"]
    }
  }
}

Claude Code (CLI)

claude mcp add mobilpay -- npx -y @mobilpay/mcp-server@latest

VS Code (GitHub Copilot)

.vscode/mcp.json:

{
  "servers": {
    "mobilpay": {
      "command": "npx",
      "args": ["-y", "@mobilpay/mcp-server@latest"]
    }
  }
}

Windsurf

.windsurf/mcp.json:

{
  "mcpServers": {
    "mobilpay": {
      "command": "npx",
      "args": ["-y", "@mobilpay/mcp-server@latest"]
    }
  }
}

Kiro (AWS)

.kiro/settings/mcp.json:

{
  "mcpServers": {
    "mobilpay": {
      "command": "npx",
      "args": ["-y", "@mobilpay/mcp-server@latest"]
    }
  }
}

Claude Desktop

claude_desktop_config.json:

{
  "mcpServers": {
    "mobilpay": {
      "command": "npx",
      "args": ["-y", "@mobilpay/mcp-server@latest"]
    }
  }
}

Verfügbare Tools

Allgemein

Tool

Eingabe

Funktion

get-docs

keywords: string[]

BM25-basierte integrierte Dokumentensuche (Zahlungsintegration + NEZO, insgesamt 27 Dokumente)

document-by-id

id: number

Abruf des vollständigen Inhalts per Dokument-ID. Verwenden Sie id=0, um die Dokumentenliste anzuzeigen

MOBILPAY Zahlungsintegration

Tool

Eingabe

Funktion

get-payment-api-spec

api_name: string

Abruf der vollständigen MOBILPAY API-Spezifikation

get-payment-code-example

api_name, language?

Extraktion von Beispielcode für MOBILPAY nach Sprache

NEZO (내죠여왕)

Tool

Eingabe

Funktion

get-nezo-api-spec

api_name: string

Abruf der vollständigen NEZO API-Spezifikation

get-nezo-code-example

api_name, language?

Extraktion von Beispielcode für NEZO nach Sprache

Unterstützte Dokumente

MOBILPAY REST API

Kategorie

Dokument

API

Transaktionsregistrierung (inkl. T-Money Pay), Aufruf des Zahlungsfensters, Authentifizierungs-/Genehmigungsantwort, Zahlungsfreigabe (TID), manuelle Einziehung, virtuelles Konto, Zahlungsstornierung (/MUP/api/cancellation), Rückerstattung, Treuhand-Versandregistrierung, Barzahlungsbeleg, HMAC-Integritätsprüfung

Leitfaden

Anwendungsleitfaden, allgemeiner Zahlungsablauf, Hybrid-Zahlungsablauf, noti_url-Verarbeitung, Firewall-Einstellungen

Referenz

Zahlungsmittel-/Kartenanbieter-/Finanzinstitut-Codetabelle, Fehlercodetabelle

NEZO (내죠여왕)

Kategorie

Dokument

API

Zahlungsanfrage (/send), Callback/Return URL, Zahlungsabfrage (/send/view), Zahlungsstornierung (/cancel), erneute Zahlungsanfrage

Leitfaden

Erste Schritte, Firewall-Einstellungen

Referenz

Allgemeine Antwortcodes, Leitfaden zur MAC-Erstellung/-Prüfung

Anwendungsbeispiele

Sie können in KI-Coding-Tools wie folgt fragen:

MOBILPAY

  • "Schreibe Code für die MOBILPAY Mobiltelefon-Zahlungsintegration"

  • "Zeige mir die vollständige Spezifikation der Transaktionsregistrierungs-API"

  • "Zeige mir ein Python-Beispiel für die HMAC-Prüfung"

  • "Welche Parameter hat die Zahlungsstornierungs-API?"

NEZO

  • "Schreibe Code für eine NEZO AlimTalk Zahlungsanfrage"

  • "Implementiere einen NEZO Callback-Handler in Node.js"

  • "Zeige mir ein Java-Beispiel für die NEZO MAC-Erstellung"

  • "Erstelle Code, um eine NEZO-Zahlung abzufragen und dann zu stornieren"

Sicherheitsregeln

Der MCP-Server wendet bei der Codegenerierung automatisch folgende Regeln an:

MOBILPAY

  1. skey (Service-Key) darf niemals im Client-Code enthalten sein — aus Umgebungsvariablen laden

  2. Die HMAC-Integritätsprüfung muss zwingend serverseitig erfolgen — die Nachrichtenstruktur variiert je nach Endpunkt (Transaktionsregistrierung/Freigabe / Stornierung/Rückerstattung / Treuhand-Versandregistrierung)

  3. Bei der noti_url-Verarbeitung ist eine Logik zur Vermeidung doppelter Transaktionen (Idempotenz basierend auf tid) erforderlich

  4. Die Zahlungsfreigabe-API (/MUP/api/approval) muss zwingend vom Backend aus aufgerufen werden

  5. Für Zahlungsstornierungen/Rückerstattungen ist /MUP/api/cancellation mit Hash-Prüfung zu verwenden (altes /cancel ist untersagt)

  6. Test: test.mobilians.co.kr / Produktion: mup.mobilians.co.kr

NEZO

  1. svc_id und MAC_KEY dürfen niemals im Client-Code enthalten sein — aus Umgebungsvariablen laden

  2. Die HmacSHA256 MAC-Erstellung/-Prüfung muss zwingend serverseitig erfolgen

  3. Im callback_url-Handler ist eine Logik zur Vermeidung doppelter Transaktionen (Idempotenz basierend auf trade_no) erforderlich

  4. Test: test.mpps.co.kr / Produktion: www.nezo.co.kr

Funktionsweise

AI 도구 → MCP 프로토콜 → 6개 Tool 중 선택 → 문서 검색/조회 → 결과 반환
                          ├── get-docs                → 통합 BM25 키워드 검색
                          ├── document-by-id           → 문서 ID 기반 조회
                          ├── get-payment-api-spec     → MOBILPAY API 명세
                          ├── get-payment-code-example → MOBILPAY 코드 예제
                          ├── get-nezo-api-spec        → 내죠여왕 API 명세
                          └── get-nezo-code-example    → 내죠여왕 코드 예제

Beim Start des Servers werden die gebündelten Markdown-Dokumente (27 Stück) in Chunks unterteilt und ein BM25-Index erstellt.

Available Tools

6 tools
document-by-idA

문서 ID로 KG파이낸셜 결제서비스 연동 문서 전체를 조회합니다. (MOBILPAY REST API + 내죠여왕 알림톡 결제)

get-docs 검색 결과에서 특정 문서의 전체 내용이 필요할 때 사용합니다. ID 목록은 이 Tool을 id=0으로 호출하면 확인할 수 있습니다.

Inputs: id (required).

get-docsC

KG파이낸셜 결제서비스 연동 문서를 검색합니다. (MOBILPAY REST API + 내죠여왕 알림톡 결제)

지원 문서: [MOBILPAY] 거래등록(티머니페이 포함), 결제창 호출, 인증/승인 응답, 결제승인(TID), 수동매입, 가상계좌, 결제취소(/cancellation), 환불, 에스크로 배송등록, 현금영수증, HMAC 무결성 검증, 결제플로우(일반/하이브리드), noti_url 처리, 방화벽 설정, 에러코드표, 결제수단/카드사/금융기관 코드표 [내죠여왕] 결제요청(/send), 콜백/리턴URL, 결제조회(/send/view), 결제취소(/cancel), 결제재요청, MAC 생성/검증, 응답코드, 방화벽 설정

보안 규칙 (생성 코드에 반드시 준수): [MOBILPAY]

  1. skey(서비스키)는 절대 클라이언트 코드에 포함 금지. 환경변수에서 로드.

  2. HMAC 무결성 검증은 반드시 서버 사이드에서 처리.

  3. noti_url 처리 시 중복 거래 방어 로직(tid 기반 멱등성) 필수.

  4. 결제 승인 API(/MUP/api/approval)는 반드시 백엔드에서 호출.

  5. 테스트: test.mobilians.co.kr / 운영: mup.mobilians.co.kr [내죠여왕]

  6. svc_id와 MAC_KEY는 절대 클라이언트 코드에 포함 금지. 환경변수에서 로드.

  7. HmacSHA256 MAC 생성/검증은 반드시 서버 사이드에서 처리.

  8. callback_url 처리 시 중복 거래 방어 로직(trade_no 기반 멱등성) 필수.

  9. 테스트: test.mpps.co.kr / 운영: www.nezo.co.kr

Inputs: keywords (required).

get-nezo-api-specA

내죠여왕(NEZO) 알림톡 결제서비스 API의 전체 명세를 조회합니다.

요청/응답 파라미터, 예제 코드를 포함한 전체 문서를 반환합니다. 키워드 검색이 아닌 특정 API를 정확히 조회할 때 사용합니다.

사용 가능한 api_name: send(결제요청), callback(콜백/리턴URL), search(결제조회), cancel(결제취소), resend(재요청), start(시작하기), mac(MAC검증가이드), 응답코드(response-codes), 방화벽(firewall)

보안 규칙:

  1. svc_id와 MAC_KEY는 절대 클라이언트 코드에 포함 금지. 환경변수에서 로드.

  2. HmacSHA256 MAC 생성/검증은 반드시 서버 사이드에서 처리.

  3. callback_url 핸들러에 trade_no 기반 멱등성 로직 필수.

  4. 테스트: test.mpps.co.kr / 운영: www.nezo.co.kr

Inputs: api_name (required).

get-nezo-code-exampleB

내죠여왕(NEZO) 알림톡 결제서비스의 언어별 예제 코드를 조회합니다.

문서에 포함된 코드 블록을 언어 필터링하여 반환합니다. MAC 가이드 문서에 Java, C#, Node.js, Python, PHP 예제가 포함되어 있습니다.

보안 규칙:

  1. svc_id와 MAC_KEY는 환경변수에서 로드. 절대 클라이언트 코드에 포함 금지.

  2. MAC 생성/검증은 반드시 서버 사이드에서 처리.

Inputs: api_name (required), language.

get-payment-api-specA

MOBILPAY REST API의 전체 명세를 조회합니다.

요청/응답 파라미터, 예제 코드를 포함한 전체 문서를 반환합니다. 키워드 검색이 아닌 특정 API를 정확히 조회할 때 사용합니다.

사용 가능한 api_name: registration(거래등록), payment-window(결제창), auth-response(인증응답), approval-tid(결제승인), purchase(수동매입), virtual-account(가상계좌), cancellation(결제취소), refund(환불), escrow-delivery(에스크로 배송등록), cash-receipt(현금영수증), hmac(HMAC검증)

보안 규칙:

  1. skey(서비스키)는 절대 클라이언트 코드에 포함 금지. 환경변수에서 로드.

  2. HMAC 무결성 검증은 반드시 서버 사이드에서 처리.

  3. 결제 승인 API(/MUP/api/approval)는 반드시 백엔드에서 호출.

Inputs: api_name (required).

get-payment-code-exampleA

MOBILPAY REST API의 언어별 예제 코드를 조회합니다.

문서에 포함된 코드 블록을 언어 필터링하여 반환합니다. HMAC 검증 문서에는 Java, C#, Node.js, Python, PHP 예제가 포함되어 있습니다.

보안 규칙:

  1. skey는 환경변수에서 로드. 절대 클라이언트 코드에 포함 금지.

  2. HMAC 검증, 결제 승인은 반드시 서버 사이드에서 처리.

Inputs: api_name (required), language.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool has a distinct purpose: searching docs, retrieving a specific doc by ID, and fetching API specs or code examples for two separate services (MOBILPAY and NEZO). No overlap or ambiguity.

    Naming Consistency4/5

    Most tools follow a 'get-{service}-{type}' pattern for specs and examples, but 'document-by-id' and 'get-docs' break the pattern slightly. Overall, the naming is clear and predictable.

    Tool Count5/5

    6 tools cover all essential needs for a documentation server: search, ID-based retrieval, specs, and code examples for two APIs. Neither too few nor too many.

    Completeness5/5

    The set provides complete access to documentation: search, full document retrieval, specific API specs, and code examples. No obvious gaps in coverage for the stated domain.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers