@mobilpay/mcp-server
@mobilpay/mcp-server
Это сервер MCP (Model Context Protocol) для интеграции платежных сервисов KG Financial.
Если вы зададите вопрос на естественном языке в инструментах ИИ-кодинга (Cursor, Claude Code, Kiro, VS Code, Windsurf, Claude Desktop и т. д.), он автоматически выполнит поиск по документации по интеграции платежей (27 документов) и сгенерирует точный код.
Поддерживаемые сервисы
Сервис | Описание | Кол-во документов |
MOBILPAY REST API | Универсальная интеграция платежей (мобильный телефон/кредитная карта/банковский перевод/виртуальный счет/простая оплата/Mobile T-money) | 18 |
NEZO (내죠여왕) | Сервис запроса платежей через Kakao AlimTalk | 9 |
Related MCP server: samsung-checkout-mcp
Установка и настройка
Требуется Node.js 18+ (цель ES2022)
Используется протокол передачи stdio — сеть не требуется, возможна автономная работа
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@latestVS 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"]
}
}
}Предоставляемые инструменты
Общие
Инструмент | Ввод | Функция |
|
| Интегрированный поиск по документам на основе BM25 (интеграция платежей + 27 документов NEZO) |
|
| Просмотр полного содержимого по ID документа. Используйте |
Интеграция платежей MOBILPAY
Инструмент | Ввод | Функция |
|
| Просмотр полной спецификации MOBILPAY API |
|
| Извлечение примеров кода MOBILPAY по языкам |
NEZO (내죠여왕)
Инструмент | Ввод | Функция |
|
| Просмотр полной спецификации API NEZO |
|
| Извлечение примеров кода NEZO по языкам |
Поддерживаемая документация
MOBILPAY REST API
Категория | Документы |
API | Регистрация транзакции (включая T-money Pay), вызов платежного окна, ответ аутентификации/одобрения, одобрение платежа (TID), ручное списание, виртуальный счет, отмена платежа ( |
Руководство | Руководство по применению, поток обычных платежей, поток гибридных платежей, обработка noti_url, настройка брандмауэра |
Справочник | Таблица кодов способов оплаты/карточных компаний/финансовых учреждений, таблица кодов ошибок |
NEZO (내죠여왕)
Категория | Документы |
API | Запрос платежа (/send), URL обратного вызова/возврата, запрос платежа (/send/view), отмена платежа (/cancel), повторный запрос платежа |
Руководство | Начало работы, настройка брандмауэра |
Справочник | Общие коды ответов, руководство по созданию/проверке MAC |
Примеры использования
В инструментах ИИ-кодинга можно задавать вопросы следующим образом:
MOBILPAY
"Напиши код для интеграции оплаты мобильным телефоном через MOBILPAY"
"Покажи полную спецификацию API регистрации транзакций"
"Дай пример кода на Python для проверки HMAC"
"Какие параметры у API отмены платежа?"
NEZO
"Напиши код для запроса платежа через AlimTalk в NEZO"
"Реализуй обработчик обратного вызова NEZO на Node.js"
"Покажи пример на Java для создания MAC в NEZO"
"Создай код для запроса платежа в NEZO, а затем его отмены"
Правила безопасности
MCP-сервер автоматически применяет следующие правила при генерации кода:
MOBILPAY
skey(сервисный ключ) категорически запрещено включать в клиентский код — загружайте из переменных окруженияПроверка целостности HMAC должна выполняться только на стороне сервера — структура сообщений различается для разных эндпоинтов (регистрация/одобрение транзакции / отмена/возврат / регистрация доставки эскроу)
При обработке
noti_urlобязательна логика защиты от дублирования транзакций (идемпотентность на основеtid)API одобрения платежа (
/MUP/api/approval) должен вызываться только с бэкендаДля отмены/возврата платежа используйте
/MUP/api/cancellationс проверкой хеша (старый/cancelзапрещен)Тест:
test.mobilians.co.kr/ Продакшн:mup.mobilians.co.kr
NEZO
svc_idиMAC_KEYкатегорически запрещено включать в клиентский код — загружайте из переменных окруженияСоздание/проверка HmacSHA256 MAC должны выполняться только на стороне сервера
В обработчике
callback_urlобязательна логика защиты от дублирования транзакций (идемпотентность на основеtrade_no)Тест:
test.mpps.co.kr/ Продакшн:www.nezo.co.kr
Принцип работы
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 → 내죠여왕 코드 예제При запуске сервера выполняется разбиение на чанки входящих в комплект документов в формате Markdown (27 шт.) и построение индекса BM25.
Available Tools
6 toolsdocument-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]
skey(서비스키)는 절대 클라이언트 코드에 포함 금지. 환경변수에서 로드.
HMAC 무결성 검증은 반드시 서버 사이드에서 처리.
noti_url 처리 시 중복 거래 방어 로직(tid 기반 멱등성) 필수.
결제 승인 API(/MUP/api/approval)는 반드시 백엔드에서 호출.
테스트: test.mobilians.co.kr / 운영: mup.mobilians.co.kr [내죠여왕]
svc_id와 MAC_KEY는 절대 클라이언트 코드에 포함 금지. 환경변수에서 로드.
HmacSHA256 MAC 생성/검증은 반드시 서버 사이드에서 처리.
callback_url 처리 시 중복 거래 방어 로직(trade_no 기반 멱등성) 필수.
테스트: 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)
보안 규칙:
svc_id와 MAC_KEY는 절대 클라이언트 코드에 포함 금지. 환경변수에서 로드.
HmacSHA256 MAC 생성/검증은 반드시 서버 사이드에서 처리.
callback_url 핸들러에 trade_no 기반 멱등성 로직 필수.
테스트: test.mpps.co.kr / 운영: www.nezo.co.kr
Inputs: api_name (required).
get-nezo-code-exampleB
내죠여왕(NEZO) 알림톡 결제서비스의 언어별 예제 코드를 조회합니다.
문서에 포함된 코드 블록을 언어 필터링하여 반환합니다. MAC 가이드 문서에 Java, C#, Node.js, Python, PHP 예제가 포함되어 있습니다.
보안 규칙:
svc_id와 MAC_KEY는 환경변수에서 로드. 절대 클라이언트 코드에 포함 금지.
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검증)
보안 규칙:
skey(서비스키)는 절대 클라이언트 코드에 포함 금지. 환경변수에서 로드.
HMAC 무결성 검증은 반드시 서버 사이드에서 처리.
결제 승인 API(/MUP/api/approval)는 반드시 백엔드에서 호출.
Inputs: api_name (required).
get-payment-code-exampleA
MOBILPAY REST API의 언어별 예제 코드를 조회합니다.
문서에 포함된 코드 블록을 언어 필터링하여 반환합니다. HMAC 검증 문서에는 Java, C#, Node.js, Python, PHP 예제가 포함되어 있습니다.
보안 규칙:
skey는 환경변수에서 로드. 절대 클라이언트 코드에 포함 금지.
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
Scored across 6 tools
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.
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.
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.
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
Related MCP Connectors
The CustomGPT.ai MCP server is a fully managed, RAG-powered endpoint that connects large language models with private knowledge bases and external data sources. It provides tools for retrieval-augmented generation queries (send_message), data ingestion (upload_file), and source listing, enabling AI agents to query private documents like PDFs with high accuracy and real-time citations.
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
The Fireflies MCP Server enables AI tools to connect directly to meeting data from Fireflies.ai, providing access to meeting transcripts, summaries, action items, and insights without switching platforms. It includes capabilities for querying cross-meeting data for analysis (such as sales insights or product feedback), and a separate Documentation MCP Server that allows searching the Fireflies knowledge base for API references, guides, and code examples.
Korea-native MCP gateway: Korean commerce, payments, messaging, gov & finance APIs for AI agents.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceMCP server providing a searchable security knowledge base for AI coding assistants, enabling retrieval of secure-coding instructions and feature-specific security guidance.3 npmMIT
- AlicenseAqualityDmaintenanceMCP server for Samsung Smart TV in-app payment (Samsung Checkout/DPI) development, enabling AI coding tools to provide real-time API references, code generation, troubleshooting, and implementation guides.7MIT
- AlicenseNot gradedqualityDmaintenanceA secure MCP server providing intelligent documentation search across multiple frameworks using ChromaDB vector storage, enabling semantic search and integration with AI tools.MIT
- FlicenseNot gradedqualityDmaintenanceMCP server that provides a searchable knowledge base of internal development standards, enabling AI coding agents to consistently reference and comply with them.-