local-only server
The server can only run on the client’s local machine because it depends on local resources.
Integrations
Links to demonstration videos showing how the Voyp MCP server works with Claude Desktop and Goose
Voyp 모델 컨텍스트 프로토콜 서버
MCP(Model Context Protocol)는 AI 시스템이 다양한 데이터 소스 및 도구와 원활하게 상호 작용할 수 있도록 하는 개방형 표준으로, 안전한 양방향 연결을 용이하게 합니다.
Anthropic에서 개발한 모델 컨텍스트 프로토콜(MCP)은 Claude와 같은 AI 비서가 VOYP의 통화 기능과 원활하게 통합될 수 있도록 지원합니다. 이러한 통합을 통해 AI 모델은 전화를 걸고 진행 상황을 모니터링할 수 있습니다.
Voyp MCP 서버를 사용하면 다음 작업을 수행할 수 있습니다.
- 통화 시 사용할 수 있는 강력한 통화 컨텍스트를 구성합니다.
- 식당, 치과 등에 전화할 때 사업체 정보를 검색해 보세요.
- 전화로 예약, 상담, 문의 등을 하세요.
- 통화 상태 제공
- 전화 끊기
필수 조건 🔧
Voyp를 사용하기 전에 다음이 필요합니다.
- Voyp API 키
- 통화 시 사용할 크레딧도 구매해야 합니다. 여기에서도 크레딧을 구매하실 수 있습니다.
- Claude Desktop , Goose 또는 기타 호환 클라이언트
- Node.js (v20 이상)
- 다음을 실행하여 Node.js 설치를 확인할 수 있습니다.
node --version
- 다음을 실행하여 Node.js 설치를 확인할 수 있습니다.
- Git 설치됨(Git 설치 방법을 사용하는 경우에만 필요)
- macOS에서:
brew install git
- Linux의 경우:
- Debian/Ubuntu:
sudo apt install git
- RedHat/CentOS:
sudo yum install git
- Debian/Ubuntu:
- Windows에서: Windows용 Git 다운로드
- macOS에서:
Goose ⚡를 위한 Voyp MCP 서버 설치
voyp-mcp 서버를 설치하려면 확장 프로그램을 수동으로 추가해야 합니다.
Voyp + Goose 데모:
Claude Desktop ⚡을 위한 Voyp MCP 서버 설치
voyp-mcp 서버를 설치하려면 다음 방법을 사용할 수 있습니다.
- Smithery를 통해 설치
- NPX로 실행
- Git 설치
1. Smithery를 통한 설치
Smithery를 통해 Claude Desktop용 Voyp Model Context Protocol 서버를 자동으로 설치하려면:
지엑스피1
2. NPX로 실행
서버를 단독으로 실행할 수는 있지만, 단독으로는 그다지 유용하지 않습니다. 대신 MCP 클라이언트에 통합하는 것이 좋습니다. 아래는 Claude Desktop 앱을 voyp-mcp 서버와 함께 사용하도록 구성하는 방법의 예입니다.
Claude Desktop 앱 구성 ⚙️
macOS의 경우:
Windows의 경우:
Voyp 서버 구성을 추가합니다.
your-VOYP-api-key
실제 VOYP API 키로 바꾸세요.
3. Git 설치
- 저장소를 복제합니다.
- 종속성 설치:
- 프로젝트를 빌드하세요:
Claude Desktop 앱 구성 ⚙️
위의 Claude Desktop 앱 구성 섹션에 설명된 구성 단계를 따르고 아래 JSON 구성을 사용하세요.
your-VOYP-api-key-here
실제 VOYP API 키로 바꾸고 /path/to/voyp-mcp
시스템에서 저장소를 복제한 실제 경로로 바꾸세요.
Claude 데스크톱 앱에서의 사용법 🎯
설치가 완료되고 Claude 데스크톱 앱 구성이 완료되면, Claude 데스크톱 앱을 완전히 닫았다가 다시 열어야 voyp-mcp 서버를 확인할 수 있습니다. 앱 왼쪽 하단에 사용 가능한 MCP 도구를 나타내는 망치 아이콘이 표시됩니다. 망치 아이콘을 클릭하면 start_call 및 hangup_call 도구에 대한 자세한 내용을 확인할 수 있습니다.
이제 클로드는 start_call 및 hangup_call 도구를 포함하여 voyp-mcp 서버에 대한 전체 액세스 권한을 갖게 됩니다.
Voyp + Claude 데스크톱 데모:
문제 해결 🛠️
일반적인 문제
- 서버를 찾을 수 없습니다
npm --verison
실행하여 npm 설치를 확인하세요.code ~/Library/Application\ Support/Claude/claude_desktop_config.json
실행하여 Claude Desktop 구성 구문을 확인하세요.node --version
실행하여 Node.js가 제대로 설치되었는지 확인하세요.
- NPX 관련 문제
npx
와 관련된 오류가 발생하는 경우, 대신 npx 실행 파일의 전체 경로를 사용해야 할 수 있습니다.- 터미널에서
which npx
실행한 다음 구성에서"command": "npx"
줄을"command": "/full/path/to/npx"
로 바꾸면 이 경로를 찾을 수 있습니다.
- API 키 문제
- VOYP API 키가 유효한지 확인하세요
- 구성에서 API 키가 올바르게 설정되었는지 확인하세요.
- API 키 주위에 공백이나 따옴표가 없는지 확인하세요.
감사의 말 ✨
- MCP 사양을 위한 모델 컨텍스트 프로토콜
- 클로드 데스크탑을 위한 인류학
You must be authenticated.
Voyp MCP 서버를 사용하면 AI 시스템이 VOYP의 통화 기능과 통합되어 모델 컨텍스트 프로토콜을 통해 전화 걸기, 약속 일정 잡기, 통화 상태 추적 등의 안전한 전화 작업이 가능합니다.
- Prerequisites 🔧
- Voyp MCP server installation for Goose ⚡
- Voyp MCP server installation for Claude Desktop ⚡
- Usage in Claude Desktop App 🎯
- Troubleshooting 🛠️
- Acknowledgments ✨