Servidor MCP de Vapi

El servidor del Protocolo de Contexto del Modelo Vapi le permite integrarse con las API de Vapi a través de llamadas de funciones.

Configuración del escritorio de Claude

1. Abra Claude Desktop y presione CMD + , para ir a Settings .

2. Haga clic en la pestaña Developer .

3. Haga clic en el botón Edit Config .

4. Esto abrirá el archivo claude_desktop_config.json en su explorador de archivos.

5. Obtén tu clave API de Vapi desde el panel de Vapi ( https://dashboard.vapi.ai/org/api-keys ).

6. Añade lo siguiente a tu archivo claude_desktop_config.json . Consulta aquí para más detalles.

7. Reinicie Claude Desktop después de editar el archivo de configuración.

{
  "mcpServers": {
    "vapi-mcp-server": {
      "command": "npx",
      "args": [
          "-y",
          "@vapi-ai/mcp-server"
      ],
      "env": {
        "VAPI_TOKEN": "<your_vapi_token>"
      }
    }
  }
}

Ejemplo de uso con Claude Desktop

1. Cree o importe un número de teléfono utilizando el panel de Vapi ( https://dashboard.vapi.ai/phone-numbers ).

2. Cree un nuevo asistente utilizando la plantilla 'Programador de citas' existente en el panel de Vapi ( https://dashboard.vapi.ai/assistants ).

3. Asegúrese de configurar Claude Desktop para usar el servidor Vapi MCP y reiniciar la aplicación Claude Desktop.

4. Pídele a Claude que inicie o programe una llamada. Mira los ejemplos a continuación:

Ejemplo 1: Solicitar una llamada inmediata

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

Ejemplo 2: Programar una llamada futura

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

Related MCP server: MCP Server

Conexión SSE remota

Para conectarse al servidor MCP de Vapi a través del transporte de eventos enviados por el servidor (SSE):

• Conéctese a https://mcp.vapi.ai/sse desde cualquier cliente MCP usando SSE Transport

• Incluya su clave API de Vapi como un token portador en los encabezados de solicitud

• Ejemplo de encabezado: Authorization: Bearer your_vapi_api_key_here

Esta conexión le permite acceder a la funcionalidad de Vapi de forma remota sin ejecutar un servidor local.

Desarrollo

# Install dependencies
npm install

# Build the server
npm run build

Actualice su claude_desktop_config.json para usar el servidor local.

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

Pruebas

El proyecto tiene dos tipos de pruebas:

Pruebas unitarias

Las pruebas unitarias utilizan simulacros para probar el servidor MCP sin realizar llamadas API reales a Vapi.

# Run unit tests
npm run test:unit

Pruebas de extremo a extremo

Las pruebas E2E ejecutan el servidor MCP completo con llamadas API reales a Vapi.

# Set your Vapi API token
export VAPI_TOKEN=your_token_here

# Run E2E tests
npm run test:e2e

Nota: Las pruebas E2E requieren que se configure un token de API Vapi válido en el entorno.

Ejecutando todas las pruebas

Para ejecutar todas las pruebas a la vez:

npm test

Referencias

• Servidor MCP remoto VAPI

• Herramienta VAPI MCP

• Protocolo de contexto modelo

• Escritorio de Claude

Acciones admitidas

El servidor Vapi MCP proporciona las siguientes herramientas para la integración:

Herramientas del asistente

• list_assistants : enumera todos los asistentes de Vapi

• create_assistant : Crea un nuevo asistente Vapi

• update_assistant : Actualiza un asistente Vapi existente

• get_assistant : Obtiene un asistente Vapi por ID

Herramientas de llamada

• list_calls : enumera todas las llamadas de Vapi

• create_call : Crea una llamada saliente

• get_call : obtiene detalles de una llamada específica

Nota: La acción create_call permite programar llamadas para su ejecución inmediata o para un momento futuro.

Herramientas para números de teléfono

• list_phone_numbers : enumera todos los números de teléfono de Vapi

• get_phone_number : Obtiene detalles de un número de teléfono específico

Herramientas Vapi

• list_tools : enumera todas las herramientas de Vapi

• get_tool : Obtiene detalles de una herramienta específica