본문으로 건너뛰기

SOLAPI MCP 서버

MCP란?
Model Context Protocol(MCP)는 대규모 언어 모델(LLM)이 특정 도메인에 대한 깊은 이해를 바탕으로 더 정확하고 유용한 응답을 생성 또는 행동하도록 돕기 위해 Anthropic 사가 제안한 개방형 표준입니다.


SOLAPI는 AI 어시스턴트와의 완벽한 통합을 통해 자사의 서비스를 빠르고 정확하게 연동할 수 있도록 공식 MCP 서버를 제공합니다.

  • 검증된 출처 보장: 모든 코드와 정보는 SOLAPI 공식 문서와 검증된 SDK 예제에서만 추출되므로 정확성이 보장됩니다.
  • 최신 정보 반영: 항상 SOLAPI API의 최신 버전 명세를 기준으로 컨텍스트를 제공합니다.
  • 코드 정확성 향상: 인증, 엔드포인트, 파라미터 등에서 발생할 수 있는 오류를 최소화하고 LLM이 더 정확한 코드를 생성하도록 유도합니다.
  • 개발 시간 단축: SDK 예제 및 API 문서를 일일이 찾아보지 않아도 AI 도구 내에서 바로 신뢰도 높은 코드 스니펫을 얻을 수 있습니다.

SOLAPI MCP 서버가 제공하는 도구​

tooldescription
get-internal-doc
MCP에 내장되어 있는 SDK 예제 또는 문서를 검색합니다. 다양한 프로그래밍 언어별 예제를 빠르게 찾을 수 있습니다.
get-internal-doc-detail
get-internal-doc로 찾은 문서의 상세 정보를 조회합니다. 코드 스니펫, 설명, 사용법 등을 확인할 수 있습니다.
get-solapi-doc
솔라피 공식 개발 문서(웹)를 실시간으로 검색합니다. 최신 API 문서와 가이드를 확인할 수 있습니다.
get-solapi-overview
솔라피 서비스의 기본 정보를 조회합니다. 서비스 개요, 주요 기능, 사용 가능한 API 등을 확인할 수 있습니다.

설치 및 설정​

사전 요구사항: Node.js 16.0 이상

자동 설정 (권장)​

가장 간단한 방법으로, 전역 설치 과정에서 실행되는 스크립트가 Cursor 및 Claude Desktop의 MCP 설정 파일을 찾아 자동으로 SOLAPI 서버 정보를 추가합니다.

npm install -g @solapi/mcp-server

수동 설정​

전역 설치가 불가능한 환경이거나 수동 설정이 필요한 경우 또는 전역 설치 후 자동 설정에 실패한 경우 시도해주세요.

npm install @solapi/mcp-server

설치 후 아래 경로의 설정 파일을 직접 열어 SOLAPI MCP 서버 정보를 올바르게 추가해 주세요.

osCursorClaude Desktop
Mac
~/Library/Application Support
/cursor/mcp_servers.json
~/Library/Application Support
/Claude/mcp_servers.json
Windows
%APPDATA%\cursor\mcp_servers.json
%APPDATA%\Claude\mcp_servers.json
Linux
~/.config/cursor/mcp_servers.json
~/.config/Claude/mcp_servers.json

위 경로는 일반적인 설치 경로이며, 사용자 설정에 따라 다를 수 있습니다.
경로를 찾기 어려우신 경우 Cursor 또는 Claude Desktop 등 사용하시는 애플리케이션의 설정에서도 확인이 가능합니다.

올바른 설정 상태
{
  "mcpServers": {
    "solapi": {
      "command": "npx",
      "args": ["--latest", "-y", "@solapi/mcp-server"],
      "env": {}
    }
  }
}

사용 예시​

성공적으로 MCP 서버와 연결한 뒤에 사용자의 질문, 즉 프롬프트를 통해 AI 코드 에디터나 챗봇에게 SOLAPI와 관련된 구체적인 작업을 요청하거나 정보를 검색할 수 있습니다.

사용자가 AI에게 SOLAPI 관련 프롬프트를 전달하면 다음과 같이 동작하게 됩니다.

  • LLM은 먼저 자신이 사용할 수 있는 도구 목록을 검토하고 질문의 맥락을 분석하여 가장 적합한 SOLAPI MCP 서버를 도구로 선택합니다.
  • 그 다음, 선택된 서버는 LLM의 요청에 따라 SOLAPI의 SDK 예제, 최신 API 명세 등의 공식 문서를 실시간으로 탐색하여 질문 해결에 필요한 가장 정확한 정보 조각을 찾아냅니다.
  • 마지막으로 LLM은 이 검증된 정보를 자신의 언어 능력과 결합하여 신뢰도 높은 코드나 명확한 답변을 최종적으로 생성하여 사용자에게 제공합니다.

다양한 비즈니스 환경에서의 활용​

시나리오프롬프트 예시
E-commerce
온라인 쇼핑몰에서 주문 완료 시 고객에게 SMS와 알림톡을 동시에 발송하는 시스템을 구축해주세요
금융 서비스 OTP
은행 앱에서 계좌 이체 시 보안을 위한 SMS OTP 발송 및 검증 로직을 구현해주세요
헬스케어 예약 관리
병원 예약 시스템에서 예약 확인, 변경, 취소 알림을 자동으로 발송하는 기능을 추가해주세요
교육 플랫폼 알림
온라인 강의 플랫폼에서 수강생에게 강의 시작 알림과 과제 마감 알림을 발송하는 시스템을 만들어주세요
부동산 중개 서비스
부동산 앱에서 매물 등록 시 중개사와 구매자에게 실시간 알림을 발송하는 기능을 구현해주세요
배송 추적 시스템
택배 회사에서 배송 상태 변경 시 고객에게 자동 알림을 발송하는 시스템을 구축해주세요

프롬프트는 구체적일수록 더 정확한 결과를 얻을 수 있습니다. 다음 요소들을 포함해보세요!​

  • 서비스 명시: "SOLAPI를 사용해서" 또는 "솔라피 SDK로"
  • 구현 환경: "Node.js로", "Python에서", "Java Spring Boot로"
  • 메시지 타입: "SMS로", "알림톡으로", "LMS로"
  • 비즈니스 맥락: "주문 완료 시", "회원가입 후", "결제 성공 시"
  • 기술적 요구사항: "대량 발송", "예약 발송", "템플릿 사용"

예시: "솔라피 Node.js SDK를 사용해서 온라인 쇼핑몰에서 주문 완료 시 고객에게 알림톡으로 주문 정보를 전송하는 코드를 작성해주세요"

실제 사용 예시: 솔라피 단일 연동​

Cursor에서 "솔라피 Node.js SDK를 이용해서 대량의 메시지를 전송하는 코드를 작성해주세요." 프롬프트 예시 SOLAPI MCP 서버

실제 사용 예시: 다른 서비스와 통합​

Cursor에서 "결제 승인 요청 결과에 따라 알림톡을 전송하도록 해주세요." 프롬프트 예시 SOLAPI MCP 서버2