Wavix

공식

Wavix는 음성, SMS, 2FA 및 전화번호를 위한 API를 제공하는 글로벌 커뮤니케이션 플랫폼입니다. 당사의 MCP 서버는 이러한 기능을 AI 에이전트 및 에이전틱 워크플로우에 제공합니다.

GitHub

이 MCP 사용해 보기스폰서

Wavix MCP(으)로 무엇을 할 수 있나요?

트랜잭션 SMS/MMS 전송 — sms_and_mms_messages_send를 통해 메시지 전송을 요청하고, 메시지 ID와 전송 상태를 반환받습니다.
2FA 인증 흐름 실행 — two_fa_verification_create로 코드를 생성한 후, two_fa_verification_check로 검증합니다.
전화번호 검색 및 구매 — buy_numbers_list로 사용 가능한 번호를 찾고, cart_add로 장바구니에 추가한 뒤, cart_checkout으로 구매를 완료합니다.
통화 기록 검색 — cdrs_search를 사용하여 전사 키워드로 통화를 찾고, cdrs_get으로 결과를 보강합니다.
녹음 파일 가져오기 및 전사 — call_recording_get으로 녹음을 가져오고, cdrs_retranscribe로 전사를 요청한 뒤, cdrs_transcription_get으로 결과를 가져옵니다.
청구 및 인보이스 감사 — billing_transactions_list로 지출 내역을 검토하고, billing_invoices_download로 인보이스 PDF를 다운로드합니다.

문서

Wavix MCP 서버

LLM과 AI 에이전트가 Wavix 통신 플랫폼 — SMS/MMS, 음성 통화, 2FA, SIP 트렁킹, 전화번호 관리, 10DLC 등록, 통화 녹음, 음성 분석, 청구 — 에 직접 접근할 수 있게 해주는 Model Context Protocol 서버입니다.

Wavix는 단일 API로 SMS 전송, 음성 통화, 2FA 흐름을 실행할 수 있는 글로벌 통신 플랫폼입니다. 무료 평가판을 이용할 수 있으며, 유료 사용은 계정에 연결된 Wavix 요금제를 따릅니다.

이 MCP 서버를 사용하는 가장 빠른 방법은 https://mcp.wavix.com/mcp 의 호스팅 엔드포인트입니다 — MCP 호환 클라이언트를 연결하고 Wavix API 키로 인증하면 됩니다. 자체 호스팅이 필요한 경우(사용자 지정 Wavix 배포, 방화벽 뒤, 전용 인스턴스)에는 직접 실행을 참조하세요.

엔드포인트
설치 — 원클릭, Claude Code, Claude Desktop / Web, Cursor, VS Code, Codex CLI, Windsurf
직접 실행 (자체 호스팅)
예시
도구 → 전체 카탈로그는 TOOLS.md
리소스
인증 (모범 사례, 토큰이 유출된 경우)
문제 해결
호환성 및 제한
지원, 기여, 보안, 라이선스

엔드포인트

필드	값
URL	`https://mcp.wavix.com/mcp`
전송 방식	Streamable HTTP
인증	`Authorization: Bearer <api_key>`
도구	TOOLS.md 참조
리소스	Wavix 문서 + OpenAPI 스펙 (자동 발견)

Wavix 콘솔 → 관리 → API 키 → 새로 만들기 에서 Wavix API 키를 받으세요.

설치

시작 전: Wavix API 키를 준비하세요.

https://wavix.com 에 로그인합니다.
관리 → API 키 를 엽니다.
새로 만들기 를 클릭합니다(또는 기존 키를 복사). 아래의 YOUR_API_KEY 자리에 붙여넣을 수 있도록 준비해 두세요.

원클릭 설치

⚠️ 아래 버튼은 편집기의 MCP 설정에 플레이스홀더 토큰 YOUR_API_KEY 을 채워 넣습니다. 편집기가 설치를 마친 후, 생성된 설정을 열고 요청을 보내기 전에 플레이스홀더를 실제 API 키로 교체하세요 — 그렇지 않으면 모든 호출이 401 Unauthorized 를 반환합니다.

나중에 제거하려면: 동일한 설정 파일(~/.cursor/mcp.json, .vscode/mcp.json, 또는 편집기에 해당하는 파일)을 열고 wavix 항목을 삭제하거나, 편집기의 MCP / 커넥터 UI를 통해 커넥터를 제거하세요.

Claude Code

claude mcp add --transport http wavix https://mcp.wavix.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

확인하려면 claude mcp list 를 사용하고, 세션 내에서 상태를 확인하려면 /mcp 를 사용하세요.

Claude Desktop / Claude Web

설정 → 커넥터 → 사용자 지정 커넥터 추가:

이름: Wavix
URL: https://mcp.wavix.com/mcp
전송 방식: Streamable HTTP
인증 헤더: Authorization: Bearer <api_key>

Cursor (수동)

~/.cursor/mcp.json (또는 프로젝트 수준의 .cursor/mcp.json)에 추가:

{
  "mcpServers": {
    "wavix": {
      "url": "https://mcp.wavix.com/mcp",
      "headers": {
        "Authorization": "Bearer <api_key>"
      }
    }
  }
}

Cursor 2.4+는 전체 카탈로그를 노출하며, 이전 버전은 40개로 제한됩니다.

VS Code (수동, GitHub Copilot Chat)

작업 공간에 .vscode/mcp.json 를 생성하거나(또는 사용자 settings.json 의 "mcp" 키 아래에 동일한 servers 객체를 추가):

{
  "servers": {
    "wavix": {
      "type": "http",
      "url": "https://mcp.wavix.com/mcp",
      "headers": {
        "Authorization": "Bearer <api_key>"
      }
    }
  }
}

최신 스키마는 VS Code MCP 서버 가이드를 참조하세요.

Codex CLI

Codex CLI는 stdio를 통한 MCP를 지원합니다. mcp-remote를 통해 호스팅 서버에 브리지하세요. ~/.codex/config.toml 를 편집합니다:

[mcp_servers.wavix]
command = "npx"
args = [
  "-y",
  "mcp-remote",
  "https://mcp.wavix.com/mcp",
  "--header",
  "Authorization:Bearer ${WAVIX_API_KEY}"
]

[mcp_servers.wavix.env]
WAVIX_API_KEY = "YOUR_API_KEY"

Windsurf / 기타 클라이언트

Streamable HTTP 전송 방식과 사용자 지정 헤더를 지원하는 모든 MCP 클라이언트에서 작동합니다. 사용 방법:

URL: https://mcp.wavix.com/mcp
헤더: Authorization: Bearer <api_key>

AI 에이전트로 설정하시나요? 에이전트를 llms-install.md로 연결하세요 — 모델에게 URL, 헤더, 클라이언트별 구성을 결정적 형식으로 제공하여 엔드포인트 값을 임의로 추측하지 않도록 하는 기계 판독 가능한 설치 가이드입니다.

직접 실행

호스팅 서버는 대부분의 사용자에게 바로 작동합니다. 공개되지 않은 Wavix 배포를 사용해야 하거나, 방화벽 뒤에서 실행해야 하거나, 자체 인프라 내에서 운영해야 하는 경우 자체 호스팅하세요.

Docker

docker build -t wavix-mcp-server .
docker run --rm -p 8000:8000 wavix-mcp-server

서버는 포트 8000에서 수신 대기하며 /mcp 에서 MCP 엔드포인트를 노출합니다. 클라이언트를 http://<host>:8000/mcp 에 연결하세요.

소스에서

git clone https://github.com/Wavix/wavix-mcp-server.git
cd wavix-mcp-server
pip install -e .
wavix-mcp

Python 3.10+ 필요.

구성

환경 변수	기본값	용도
`WAVIX_API_BASE_URL`	`https://api.wavix.com`	업스트림 Wavix API 엔드포인트 재정의 (내부 배포 또는 스테이징용)

서버를 실행하는 데 Wavix 자격 증명은 필요하지 않습니다 — MCP 클라이언트의 Authorization: Bearer <api_key> 헤더에서 요청별로 전달됩니다. 자체 호스팅 사용자는 공개적으로 노출하기 전에 서버 앞에서 TLS 종료를 처리해야 합니다(nginx, Caddy, 클라우드 로드 밸런서).

예시

연결된 모든 클라이언트에서 바로 사용할 수 있는 구체적인 프롬프트입니다.

아래 전화번호(+1 310 555 0100, +44 7700 900123)는 예약된 테스트 범위(NANP 555 및 Ofcom 070 09xx)에 있으므로 그대로 복사해도 안전하며, 실제 가입자에게는 연결되지 않습니다.

거래 SMS 보내기

프롬프트: "+13105550100에서 +447700900123으로 'Your verification code is 4821'이라는 SMS를 보내주세요."

에이전트는 from, to, text 와 함께 sms_and_mms_messages_send 를 호출합니다. 메시지 ID와 전송 상태를 반환합니다.

2FA 검증 실행

프롬프트: "+13105550100으로 SMS를 통해 2FA 인증 코드를 보내주세요. 제가 받은 코드를 알려드리면 맞는지 확인해 주세요."

에이전트는 two_fa_verification_create 를 호출하고, SMS로 도착한 코드를 공유할 때까지 기다린 후 two_fa_verification_check 를 호출합니다. 통합 코드를 작성하지 않고 비밀번호 없는 흐름을 프로토타이핑하는 데 유용합니다.

전화번호 찾기 및 구매

프롬프트: "SMS 기능이 있는 사용 가능한 미국 무료 전화번호를 찾아 장바구니에 추가하고 결제해 주세요."

에이전트는 buy_numbers_list(국가 및 기능별 필터링), cart_add, cart_checkout 를 연결합니다. 결제는 계정에 요금이 부과되므로 체크아웃 전에 사용자에게 확인하세요.

통화 기록 검색

프롬프트: "어제 2분 이상 지속된 인바운드 통화 중 발신자가 'refund'를 언급한 통화를 모두 보여주세요."

에이전트는 전사본에 대해 cdrs_search 를 사용한 다음, 각 결과를 cdrs_get 를 통해 전체 통화 메타데이터로 보강합니다.

녹음 가져오기 및 전사

프롬프트: "abc-123 통화의 녹음을 가져와 Wavix에 전사를 요청하고 전사 결과를 반환해 주세요."

에이전트는 call_recording_get(사전 서명된 다운로드 URL 반환), cdrs_retranscribe 를 호출한 다음 cdrs_transcription_get 를 폴링합니다.

청구 감사

프롬프트: "지난달 SMS에 얼마를 지출했나요? 가장 최근 인보이스 PDF의 다운로드 링크를 주세요."

에이전트는 유형과 날짜로 필터링된 billing_transactions_list 를 호출한 다음 billing_invoices_list + billing_invoices_download 를 호출합니다. 다운로드 도구는 파일 자체가 아닌 PDF에 대한 사전 서명된 URL을 반환합니다 — 브라우저에서 URL을 열거나 클라이언트에 전달하여 실제 문서를 가져오세요.

도구

Wavix OpenAPI 스펙에서 생성된 122개의 도구입니다. 인수는 요청 매개변수와 본문 필드를 반영합니다.

그룹	#	범위
SMS 및 MMS	10	메시지 전송, 목록, 조회; 발신자 ID; 수신 거부
통화 제어	9	통화 시작 / 응답 / 종료; 오디오 재생; DTMF 수집
통화 녹음	4	목록, 다운로드(사전 서명된 URL), 삭제
통화 스트리밍	2	미디어 스트림 시작 / 중지
통화 웹훅	3	목록, 생성, 삭제
CDR	7	목록, 내보내기, 조회; 전사 검색 및 재전사
음성 분석	4	업로드, 전사, 원본 파일 검색
2FA	6	검증 생성 / 확인 / 취소 / 재전송; 이벤트
내 번호	6	목록, 업데이트, 해제; SMS / 음성 라우팅; 문서 업로드
구매	5	국가, 지역, 도시; 사용 가능한 번호 검색
장바구니	4	추가, 제거, 조회, 결제
번호 검증기	3	단일 및 일괄 검증
SIP 트렁크	5	전체 CRUD
10DLC	30	브랜드, 캠페인, 검증, 증거, 이벤트 구독
프로필	3	프로필 조회 / 업데이트; 계정 구성
API 키	4	목록, 생성, 활성화 / 비활성화, 삭제
하위 계정	5	목록, 생성, 조회, 업데이트; 거래
청구	3	거래, 인보이스, 명세서 다운로드
음성 캠페인	2	트리거 및 조회
Wavix Embeddable (WebRTC)	5	위젯 토큰 CRUD
링크 단축	2	단축 링크 생성; 지표

전체 도구 목록과 한 줄 설명은 TOOLS.md 를 참조하세요. 권위 있는 소스는 Wavix OpenAPI 스펙입니다 — 클라이언트는 항상 현재 라이브 카탈로그를 확인합니다.

리소스

도구 외에도 서버는 Wavix 문서를 MCP 리소스로 노출하므로, 모델이 사전 지식에 의존해 추측하는 대신 필요할 때 권위 있는 컨텍스트를 가져올 수 있습니다.

URI 스키마	내용
`wavix://docs/<path>`	docs.wavix.com의 문서 페이지 (`llms.txt`를 통해 자동 발견).
`wavix://api/openapi.yaml`	전체 Wavix OpenAPI 3.0 스펙.

두 소스 — docs.wavix.com 및 Wavix OpenAPI 스펙 — 모두 공개적으로 이용 가능하며 인증 없이 직접 탐색할 수 있습니다.

리소스는 resources/read 에서 지연 로드되며 서버 측에서 1시간 TTL로 캐시됩니다. 업스트림 Bearer 토큰은 문서 호스트로 절대 전달되지 않습니다 — api.wavix.com 에만 전달됩니다.

인증

클라이언트의 모든 요청에는 다음이 포함되어야 합니다:

Authorization: Bearer <api_key>

서버는 이 헤더를 요청별로 api.wavix.com 에 전달합니다. 토큰은:

절대 기록되지 않으며,
크로스 호스트 리디렉션(예: 사전 서명된 S3 다운로드 URL)에서 절대 전달되지 않으며,
문서 호스트로 절대 전송되지 않습니다.

클라이언트가 call_recording_get, billing_invoices_download, speech_analytics_file_get 또는 ten_dlc_brand_evidence_get 에서 반환된 사전 서명된 다운로드 URL을 따라가는 경우 Authorization 헤더 없이 직접 가져오세요.

모범 사례

MCP 전용 API 키를 사용하세요. https://wavix.com → 관리 → API 키 에서 별도의 API 키를 생성하거나(또는 다른 세션에서 api_keys_create 도구를 통해) MCP 액세스를 다른 통합에 영향을 주지 않고 해지할 수 있습니다.
정기적으로 교체하세요. API 키를 프로덕션 비밀처럼 취급하세요: 정기적으로 그리고 유출이 의심되는 경우 교체하세요.
API 키를 git에 보관하지 마세요. MCP 클라이언트 설정은 실수로 커밋하기 쉬우며, 토큰이 히스토리와 CI 로그에 남을 수 있습니다. 대부분의 클라이언트는 헤더 값에서 ${env:VAR} 치환을 지원합니다 — API 키를 환경 변수나 OS 키체인에 저장하고 설정에서 참조하세요. 안전망으로, 일반적인 클라이언트 설정 경로를 프로젝트의 .gitignore 에 추가하세요:
```
.cursor/mcp.json
.vscode/mcp.json
claude_desktop_config.json
.claude/mcp.json
.codex/config.toml
```

토큰이 유출된 경우

Wavix 콘솔에서 키를 즉시 비활성화하세요(또는 api_keys_deactivate 호출).
api_keys_create 또는 콘솔을 통해 교체 키를 생성하세요.
클라이언트 구성을 업데이트하고 다시 연결하세요.
예상치 못한 활동이 있는지 billing_transactions_list 및 cdrs_list를 검토하세요.

문제 해결

증상	예상 원인 / 해결 방법
모든 도구에서 `401 Unauthorized` 발생	`Authorization: Bearer …` 헤더 누락 또는 잘못됨. Wavix 콘솔에서 API 키가 활성 상태인지 확인하세요.
도구가 파일 자체가 아닌 `download_url` 반환	예상된 동작입니다. 녹음, 인보이스, 음성 분석, 10DLC 증빙 엔드포인트는 사전 서명된 URL을 반환합니다(인증 참조). `Authorization` 헤더 없이 해당 URL을 직접 가져오세요.
클라이언트에 전체 카탈로그가 아닌 약 40개의 도구만 표시됨	이전 클라이언트는 서버당 도구 상한을 적용합니다. 업그레이드하세요(Cursor 2.4+, 최신 VS Code, 최신 Claude).
이 README에 나열된 도구에 대해 `Tool not found` 발생	로컬 클라이언트가 이전 도구 목록을 캐싱 중일 수 있습니다. 클라이언트를 다시 시작하거나 서버를 제거 후 다시 추가하세요.
`errors` 배열과 함께 4xx 발생	Wavix API의 검증 오류입니다. `errors`를 검사하고 관련 `wavix://docs/*` 페이지 또는 OpenAPI 사양을 대조하세요.
서버에 연결할 수 없음	`mcp.wavix.com:443`에 대한 DNS 및 아웃바운드 HTTPS를 확인하세요.
에이전트가 예기치 않게 파괴적 도구를 호출함	대부분의 클라이언트는 도구 호출 전 확인을 요구할 수 있습니다. 해당 설정을 활성화하고 전용 MCP API 키로 교체하세요(모범 사례 참조).

호환성 및 제한 사항

Streamable HTTP 전송을 지원하는 모든 MCP 클라이언트(Claude Desktop / Web / Code, Cursor 2.4+, VS Code, Windsurf, 사용자 정의 MCP SDK) 및 MCP 클라이언트 어댑터가 있는 모든 에이전트 프레임워크와 호환됩니다.
이전 클라이언트는 서버당 도구 상한을 적용할 수 있습니다. 전체 카탈로그에 접근하려면 최신 버전으로 업그레이드하세요.
속도 제한 및 사용 요금은 Wavix 계정 플랜에 따라 다릅니다. Wavix 요금을 참조하세요.

변경 로그

호스팅 서버는 Wavix OpenAPI 사양이 발전함에 따라 지속적으로 업데이트됩니다. 새 도구가 자동으로 나타나고 기존 도구 인수에 선택적 필드가 추가될 수 있습니다. 이 저장소의 문서 변경 사항은 릴리스에서 추적됩니다. 도구 입력 또는 인증에 영향을 미치는 주요 동작 변경의 경우 해당 릴리스 노트와 Wavix 릴리스 노트에 공지사항을 게시합니다.

지원

제품 문서: https://docs.wavix.com
API 참조: https://docs.wavix.com/api-reference
질문 / 피드백: support@wavix.com

기여

이 저장소는 소스 공개이지만 외부 기여는 허용되지 않습니다. Pull Request는 자동으로 닫히며, Issues / Discussions는 비활성화되어 있습니다. 버그 신고, 기능 요청, 피드백은 support@wavix.com로 보내주세요. 자세한 내용은 CONTRIBUTING.md를 참조하세요.

기본 FastMCP 프레임워크에서 버그를 발견한 경우 해당 상위 프로젝트에 보고해 주세요.

보안

보안 취약점을 신고하려면 공개 이슈를 열지 말고 Security: <short summary> 제목으로 support@wavix.com에 이메일을 보내주세요. 자세한 내용은 SECURITY.md를 참조하세요.