Wavix

공식

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

GitHub

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

SMS 또는 MMS 메시지 보내기 — sms_and_mms_messages_send를 사용하여 어시스턴트가 문자 또는 미디어 메시지를 보내도록 요청합니다.
2FA 인증 흐름 실행 — 어시스턴트가 two_fa_verification_create로 인증을 생성하고 two_fa_verification_check를 통해 수신한 코드를 확인하도록 합니다.
전화번호 검색 및 구매 — buy_numbers_list로 국가 및 기능별로 사용 가능한 번호를 찾고, 장바구니에 추가한 후 구매를 완료합니다.
통화 기록 분석 — cdrs_search를 사용하여 특정 구문에 대한 통화 기록을 검색하고 cdrs_get으로 전체 메타데이터를 검색합니다.
녹음 및 전사 파일 다운로드 — call_recording_get을 통해 통화 녹음 URL을 가져오고, cdrs_retranscribe로 전사를 요청한 후 결과를 가져옵니다.
청구 감사 및 인보이스 다운로드 — billing_transactions_list로 거래를 검토하고 billing_invoices_download를 통해 사전 서명된 PDF 다운로드 링크를 받습니다.

문서

Wavix MCP 서버

LLM과 AI 에이전트가 Wavix 통신 플랫폼에 직접 접근할 수 있게 해주는 모델 컨텍스트 프로토콜 서버입니다 — SMS/MMS, 음성 통화, 2FA, SIP 트렁킹, 전화번호 관리, 10DLC 등록, 통화 녹음, 음성 분석, 그리고 과금 기능을 제공합니다.

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`
전송 방식	스트리밍 가능 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 / 기타 클라이언트

커스텀 헤더를 지원하는 스트리밍 가능 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으로 '인증 코드는 4821입니다'라는 SMS를 보내줘."

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

2FA 인증 실행하기

프롬프트: "SMS로 +13105550100에 2FA 인증 코드를 보내줘. 내가 받은 코드를 알려주면, 그 코드가 올바른지 확인해줘."

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

전화번호 찾기 및 구매하기

프롬프트: "SMS 기능이 있는 사용 가능한 미국 수신자 부담 번호를 찾아서 장바구니에 추가하고 결제해줘."

에이전트가 buy_numbers_list(국가 및 기능별 필터링), cart_add, cart_checkout를 연쇄적으로 호출합니다. 결제 전에 사용자에게 확인을 요청하세요 — 계정에 요금이 청구됩니다.

통화 녹취록 검색하기

프롬프트: "어제 수신된 통화 중 2분 이상이고 발신자가 '환불'을 언급한 모든 통화를 보여줘."

에이전트가 녹취록에 대해 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 수집
통화 녹음	3	목록 조회, 다운로드(미리 서명된 URL), 삭제
통화 스트리밍	2	미디어 스트림 시작 / 중지
통화 웹훅	3	목록 조회, 생성, 삭제
CDR	6	목록 조회, 내보내기, 검색; 녹취록 검색 및 재변환
음성 분석	4	업로드, 텍스트 변환, 원본 파일 검색
2FA	6	인증 생성 / 확인 / 취소 / 재전송; 이벤트
내 번호	7	목록 조회, 업데이트, 해제; SMS / 음성 라우팅; 문서 업로드
구매	5	국가, 지역, 도시; 사용 가능한 번호 검색
장바구니	4	추가, 제거, 조회, 결제
번호 검증기	3	단일 및 대량 검증
SIP 트렁크	5	전체 CRUD
10DLC	30	브랜드, 캠페인, 심사, 증거, 이벤트 구독
프로필	3	프로필 조회 / 업데이트; 계정 설정
API 키	5	목록 조회, 생성, 활성화 / 비활성화, 삭제
하위 계정	5	목록 조회, 생성, 조회, 업데이트; 거래 내역
과금	3	거래 내역, 청구서, 명세서 다운로드
음성 캠페인	2	트리거 및 검색
Wavix 임베더블 (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_keys_create 도구 자체를 통해)에서 별도의 API 키를 생성하세요. 이렇게 하면 다른 통합을 중단하지 않고 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 사양을 상호 참조하세요.
서버에 연결할 수 없음	DNS 및 `mcp.wavix.com:443`에 대한 아웃바운드 HTTPS를 확인하세요.
에이전트가 예상치 않게 파괴적인 도구를 호출함	대부분의 클라이언트는 도구 호출 전 확인을 요구할 수 있습니다. 이 설정을 활성화하고 전용 MCP API 키로 교체하세요(모범 사례 참조).

호환성 및 제한 사항

스트리밍 가능 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

기여

이 리포지토리는 소스 공개이지만 외부 기여는 받지 않습니다. 풀 리퀘스트는 자동으로 닫히며, 이슈/토론은 비활성화되어 있습니다. 버그 신고, 기능 요청 및 피드백은 support@wavix.com(으)로 보내주세요. 자세한 내용은 CONTRIBUTING.md을(를) 참조하세요.

기본 FastMCP 프레임워크에서 버그를 발견하면 해당 업스트림에 보고해 주세요.

보안

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