Vapi MCP Server

Official

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Allows the MCP server to be installed and run via NPX, making it easy to integrate Vapi's capabilities through the NPM package ecosystem.

Vapi MCP 서버

Vapi 모델 컨텍스트 프로토콜 서버를 사용하면 함수 호출을 통해 Vapi API와 통합할 수 있습니다.

클로드 데스크탑 설정

  1. Claude Desktop 열고 CMD + , 눌러 Settings 으로 이동합니다.
  2. Developer 탭을 클릭하세요.
  3. Edit Config 버튼을 클릭하세요.
  4. 이렇게 하면 파일 탐색기에서 claude_desktop_config.json 파일이 열립니다.
  5. Vapi 대시보드( https://dashboard.vapi.ai/org/api-keys )에서 Vapi API 키를 받으세요.
  6. claude_desktop_config.json 파일에 다음을 추가하세요. 자세한 내용은 여기를 참조하세요.
  7. 구성 파일을 편집한 후 Claude Desktop을 다시 시작합니다.

지엑스피1

Claude Desktop을 사용한 예시 사용

  1. Vapi 대시보드( https://dashboard.vapi.ai/phone-numbers )를 사용하여 전화번호를 만들거나 가져옵니다.
  2. Vapi 대시보드( https://dashboard.vapi.ai/assistants )에 있는 기존 '약속 일정 관리' 템플릿을 사용하여 새로운 비서를 만듭니다.
  3. Claude Desktop이 Vapi MCP 서버를 사용하도록 구성하고 Claude Desktop 앱을 다시 시작하세요.
  4. 클로드에게 전화 통화를 시작하거나 일정을 예약해 달라고 요청하세요. 아래 예시를 참조하세요.

예 1: 즉시 전화 요청

I'd like to speak with my ShopHelper assistant to talk about my recent order. Can you have it call me at +1234567890?

예 2: 향후 통화 예약

I need to schedule a call with Mary assistant for next Tuesday at 3:00 PM. My phone number is +1555123456.

원격 SSE 연결

SSE(Server-Sent Events) 전송을 통해 Vapi의 MCP 서버에 연결하려면:

  • SSE Transport를 사용하여 모든 MCP 클라이언트에서 https://mcp.vapi.ai/sse 에 연결합니다.
  • 요청 헤더에 Vapi API 키를 전달 토큰으로 포함합니다.
  • 헤더 예: Authorization: Bearer your_vapi_api_key_here

이 연결을 사용하면 로컬 서버를 실행하지 않고도 원격으로 Vapi 기능에 액세스할 수 있습니다.

개발

# Install dependencies npm install # Build the server npm run build

로컬 서버를 사용하려면 claude_desktop_config.json 업데이트하세요.

{ "mcpServers": { "vapi-local": { "command": "node", "args": [ "<path_to_vapi_mcp_server>/dist/index.js" ], "env": { "VAPI_TOKEN": "<your_vapi_token>" } }, } }

테스트

이 프로젝트에는 두 가지 유형의 테스트가 있습니다.

단위 테스트

단위 테스트는 Vapi에 실제 API 호출을 하지 않고 모의 테스트를 사용하여 MCP 서버를 테스트합니다.

# Run unit tests npm run test:unit

종단간 테스트

E2E 테스트는 Vapi에 대한 실제 API 호출을 통해 전체 MCP 서버를 실행합니다.

# Set your Vapi API token export VAPI_TOKEN=your_token_here # Run E2E tests npm run test:e2e

참고: E2E 테스트를 수행하려면 유효한 Vapi API 토큰을 환경에 설정해야 합니다.

모든 테스트 실행

모든 테스트를 한 번에 실행하려면:

npm test

참고문헌

지원되는 작업

Vapi MCP 서버는 통합을 위한 다음과 같은 도구를 제공합니다.

보조 도구

  • list_assistants : 모든 Vapi 어시스턴트를 나열합니다.
  • create_assistant : 새로운 Vapi 어시스턴트를 생성합니다.
  • get_assistant : ID로 Vapi 어시스턴트를 가져옵니다.

통화 도구

  • list_calls : 모든 Vapi 호출을 나열합니다.
  • create_call : 아웃바운드 호출을 생성합니다.
  • get_call : 특정 통화에 대한 세부 정보를 가져옵니다.

참고: create_call 액션은 즉시 실행이나 나중에 실행하기 위한 호출 예약을 지원합니다.

전화번호 도구

  • list_phone_numbers : 모든 Vapi 전화번호를 나열합니다.
  • get_phone_number : 특정 전화번호의 세부 정보를 가져옵니다.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

모델 컨텍스트 프로토콜을 통한 함수 호출을 통해 Vapi API와의 통합을 지원하여 AI 모델이 Vapi 기능에 액세스할 수 있도록 합니다.

  1. Claude Desktop Setup
    1. Example Usage with Claude Desktop
  2. Remote SSE Connection
    1. Development
      1. Testing
    2. References
      1. Supported Actions
        1. Assistant Tools
        2. Call Tools
        3. Phone Number Tools
      ID: 36gq6pif6r