MCP

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

• 검증된 출처 보장: 모든 코드와 정보는 SOLAPI 공식 문서와 검증된 SDK 예제에서만 추출되므로 정확성이 보장됩니다.

• 최신 정보 반영: 항상 SOLAPI API의 최신 버전 명세를 기준으로 컨텍스트를 제공합니다.

• 코드 정확성 향상: 인증, 엔드포인트, 파라미터 등에서 발생할 수 있는 오류를 최소화하고 LLM이 더 정확한 코드를 생성하도록 유도합니다.

• 운영 작업 자동화: 문서 검색뿐 아니라 메시지 발송과 발신번호·카카오 템플릿 관리 등 실제 SOLAPI 운영 작업도 AI 어시스턴트에서 직접 수행할 수 있습니다.

SOLAPI MCP 서버가 제공하는 도구

SOLAPI MCP 서버는 다음 두 부류의 도구를 제공합니다.

solactl 기반 실행 도구 카테고리

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

설치 및 설정

자동 설정 (권장)

가장 간단한 방법으로, 전역 설치 과정에서 실행되는 스크립트가 Cursor 및 Claude Desktop의 MCP 설정 파일을 찾아 자동으로 SOLAPI 서버 정보를 추가합니다. 또한 플랫폼에 맞는 solactl 바이너리도 함께 자동 다운로드됩니다.

npm install -g @solapi/mcp-server

yarn global add @solapi/mcp-server

pnpm add -g @solapi/mcp-server

bun add --global @solapi/mcp-server

수동 설정

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

npm install @solapi/mcp-server

yarn add @solapi/mcp-server

pnpm add @solapi/mcp-server

bun add @solapi/mcp-server

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

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

// 설정 예시
{
  "mcpServers": {
    "solapi": {
      "command": "npx",
      "args": ["--latest", "-y", "@solapi/mcp-server"],
      "env": {}
    }
  }
}

인증 설정

solactl 기반 도구를 사용하려면 SOLAPI API Key가 필요합니다. 별도의 CLI 설치나 파일 편집 없이 AI 어시스턴트와의 대화만으로 자격 증명을 등록할 수 있습니다.

"내 솔라피 키 등록해줘. apiKey는 NCS..., apiSecret은 ..., 프로필 이름은 prod"

위와 같이 요청하면 MCP가 configure_setup을 호출하여 ~/.solactl/credentials.json에 프로필을 저장합니다. 운영/스테이징 등 여러 프로필을 두고 도구 호출 시마다 profile 인자로 환경을 분리할 수 있습니다.

발송 안전 가드

LLM이 사용자 동의 없이 메시지를 발송하는 사고를 막기 위해, 발송 도구는 기본적으로 비활성화 상태로 동작합니다. 카카오 템플릿 변경, 발신번호 삭제 등 변경 도구도 같은 가드를 사용합니다.

• 2단계 발송: 모든 발송·변경 도구는 confirmed 인자를 가집니다. 기본값(false)에서는 미리보기만 반환하고, 사용자 확인 후 confirmed=true로 다시 호출해야 실제 실행됩니다.

• 세션 한정 활성화: "발송 활성화해줘" 한 마디로 update_mcp_policy를 호출해 세션 동안만 발송이 허용되며, MCP 서버 재시작 시 다시 비활성화됩니다.

• 부팅부터 활성화: 항상 발송이 가능하도록 하려면 mcp.json의 env에 SOLAPI_MCP_ENABLE_SEND=true를 추가합니다.

• 환경변수 ceiling: SOLAPI_MCP_DISABLE_SEND(하드 락), SOLAPI_MCP_MAX_RECIPIENTS(수신자 최대치), SOLAPI_MCP_ALLOWED_SENDERS(발신번호 화이트리스트) 등으로 한계를 강제할 수 있으며, 이 값들은 MCP 도구로 풀 수 없습니다.

사용 예시

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

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

• LLM은 먼저 자신이 사용할 수 있는 도구 목록을 검토하고 질문의 맥락을 분석하여 가장 적합한 SOLAPI MCP 서버 도구를 선택합니다.

• 선택된 도구는 LLM의 요청에 따라 SOLAPI의 SDK 예제, 최신 API 명세 등의 공식 문서를 실시간으로 탐색하거나, solactl을 통해 실제 SOLAPI 운영 작업을 수행합니다.

• 마지막으로 LLM은 이 검증된 정보 또는 실행 결과를 자신의 언어 능력과 결합하여 신뢰도 높은 코드나 명확한 답변을 최종적으로 생성하여 사용자에게 제공합니다.

실제 사용 예시