Vocenya Docs

Servidor MCP público y de solo lectura para la documentación de la API de Vocenya: busca guías, lee páginas y obtén cada endpoint REST con ejemplos en cURL, Node, PHP y Python.

GitHubPrueba este MCPPatrocinado

Servidor MCP alojado

npx add-mcp 'https://vocenya.com/mcp/site'

Se instala en Claude Code, Codex, Cursor y más

Documentación

Servidores MCP de Vocenya

Conecta Claude, ChatGPT, Cursor, VS Code y otros asistentes de IA a Vocenya, la recepcionista de IA para pequeñas empresas creada por GH Business Solutions, y a su documentación para desarrolladores.

Vocenya responde llamadas telefónicas y chats de sitios web las 24 horas, los 7 días de la semana, reserva citas, captura clientes potenciales, transfiere llamadas a personas capacitadas y realiza llamadas de IA salientes con verificaciones de No Llamar, consentimiento y horarios de llamada. Ejecuta tres servidores remotos de Model Context Protocol a través de Streamable HTTP. No hay nada que instalar: apunta tu cliente a una URL.

Guía completa: https://vocenya.com/docs/mcp

Servidor	URL	Autenticación	Qué hace
Vocenya Docs	`https://vocenya.com/mcp/docs`	Ninguna	Busca en la documentación para desarrolladores de Vocenya y obtén cada endpoint REST con ejemplos de código. Solo lectura.
Vocenya (plataforma)	`https://vocenya.com/mcp/platform`	OAuth o clave API	Llamadas, clientes potenciales, reservas y chats de una cuenta empresarial; añade clientes potenciales, pon en cola llamadas de IA salientes, actualiza la lista de No Llamar.
Vocenya Site	`https://vocenya.com/mcp/site`	Ninguna	Respuestas sobre la propia Vocenya desde vocenya.com: planes y precios, productos, industrias, ubicaciones, guías. Solo lectura.

Los servidores públicos permiten 60 solicitudes por minuto por dirección IP. El servidor de plataforma comparte el límite REST de la clave API (120 solicitudes por minuto por clave de forma predeterminada).

Este repositorio contiene las entradas oficiales del Registro MCP, un plugin de Claude Code y estas instrucciones. Los servidores están alojados por Vocenya; su código no está aquí.

Herramientas

Vocenya Docs (sin clave, solo lectura)

Herramienta	Qué hace
`search_docs`	Busca guías (autenticación, webhooks, paginación, reglas de llamadas salientes, chat en vivo, MCP) y cada endpoint de API.
`get_doc_page`	Una página de documentación como Markdown, por ejemplo `quickstart`, `webhooks` o `reference/leads`.
`list_endpoints`	Endpoints REST con método, ruta, resumen y alcance requerido, agrupados por recurso.
`get_endpoint`	Un endpoint completo: alcance, parámetros, cuerpo de solicitud, respuestas y ejemplos de código en cURL, Node, PHP y Python.

Plataforma Vocenya (OAuth o clave API)

Herramienta	Alcance	Qué hace
`list_calls`	`calls:read`	Llamadas gestionadas por la IA, agentes de GH Live o el equipo, de más reciente a más antigua.
`get_call`	`calls:read`	Una llamada con sus clientes potenciales; resumen de IA y transcripción a menos que la cuenta esté en modo HIPAA.
`list_leads`	`leads:read`	Clientes potenciales de llamadas, chats y formularios.
`get_lead`	`leads:read`	Un cliente potencial con datos de contacto, motivo, urgencia y fuente.
`create_lead`	`leads:write` (+ `outbound:write` para una devolución de llamada de IA)	Añade un cliente potencial desde otro sistema; opcionalmente pide a la IA que devuelva la llamada.
`list_bookings`	`bookings:read`	Citas que la IA reservó en el calendario de la empresa.
`list_chats`	`chats:read`	Conversaciones de chat en vivo del sitio web.
`queue_outbound_call`	`outbound:write`	Pide a la IA que llame a alguien que haya dado su consentimiento. Primero se verifica el cumplimiento; los rechazos devuelven el motivo.
`add_do_not_call`	`dnc:write`	Añade un número a la lista de No Llamar de la empresa.

Cada herramienta verifica su propio alcance (el de la clave API, o los alcances que un propietario aprobó al conectarse con OAuth), por lo que una clave con solo leads:read puede leer clientes potenciales pero no poner llamadas en cola. Las claves de prueba (vk_test_...) funcionan con datos de muestra separados y nunca llaman a nadie. Las cuentas en modo HIPAA nunca devuelven transcripciones, resúmenes de IA o mensajes de chat a través de MCP.

Vocenya Site (sin clave, solo lectura)

get_pricing, get_service, search_industries, get_industry, list_locations, search_articles, get_article y el recurso vocenya://llms.txt.

Autenticación

Docs y Site: ninguna.
Plataforma, OAuth (sin clave): los clientes que inician sesión con OAuth (Claude Code, conectores de Claude, modo desarrollador de ChatGPT y otros) solo necesitan la URL. El cliente se registra solo, luego un propietario de cuenta inicia sesión en Vocenya y elige la cuenta, los datos en vivo o de prueba, y los permisos (los mismos alcances que las claves API). Los propietarios ven y desconectan aplicaciones conectadas en la página de Desarrolladores: https://vocenya.com/app/developers. El servidor admite código de autorización OAuth 2.1 con PKCE (S256) y registro dinámico de clientes.
Plataforma, clave API: Authorization: Bearer vk_live_... (o vk_test_... para datos de prueba). El propietario de la cuenta crea claves, cada una con sus propios alcances, en la misma página de Desarrolladores. Mantén las claves en variables de entorno; nunca las pegues en un chat ni las confirmes en un repositorio.

Conexión

Claude Code

# Docs (no key)
claude mcp add --transport http vocenya-docs https://vocenya.com/mcp/docs

# Platform with OAuth (Claude Code opens the Vocenya sign-in)
claude mcp add --transport http vocenya https://vocenya.com/mcp/platform

# Or platform with an API key in an environment variable
claude mcp add --transport http vocenya https://vocenya.com/mcp/platform \
  --header "Authorization: Bearer $VOCENYA_API_KEY"

O instala el plugin desde este repositorio, que añade el servidor de documentación y dos habilidades (API REST y webhooks, instalación de chat en vivo del sitio web):

claude plugin marketplace add gadyamedia/vocenya-mcp
claude plugin install vocenya@vocenya

Claude Desktop y claude.ai

Servidor de Docs: Configuración > Conectores > Añadir conector personalizado, URL https://vocenya.com/mcp/docs, sin autenticación.

Servidor de plataforma: añade un conector personalizado con la URL https://vocenya.com/mcp/platform e inicia sesión con tu cuenta de propietario de Vocenya (OAuth).

O, con una clave API, a través del puente mcp-remote en claude_desktop_config.json:

{
    "mcpServers": {
        "vocenya": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-remote",
                "https://vocenya.com/mcp/platform",
                "--header",
                "Authorization:${VOCENYA_AUTH}"
            ],
            "env": {
                "VOCENYA_AUTH": "Bearer paste-your-key-here"
            }
        }
    }
}

Cursor

~/.cursor/mcp.json:

{
    "mcpServers": {
        "vocenya-docs": { "url": "https://vocenya.com/mcp/docs" },
        "vocenya": {
            "url": "https://vocenya.com/mcp/platform",
            "headers": { "Authorization": "Bearer ${env:VOCENYA_API_KEY}" }
        }
    }
}

VS Code

.vscode/mcp.json (VS Code pide la clave una vez y la almacena de forma segura):

{
    "inputs": [
        {
            "type": "promptString",
            "id": "vocenya-key",
            "description": "Vocenya API key (vk_live_... or vk_test_...)",
            "password": true
        }
    ],
    "servers": {
        "vocenya-docs": {
            "type": "http",
            "url": "https://vocenya.com/mcp/docs"
        },
        "vocenya": {
            "type": "http",
            "url": "https://vocenya.com/mcp/platform",
            "headers": { "Authorization": "Bearer ${input:vocenya-key}" }
        }
    }
}

ChatGPT

Activa el modo desarrollador y luego añade un conector personalizado con la URL https://vocenya.com/mcp/docs y sin autenticación. Para los datos de tu cuenta, añade https://vocenya.com/mcp/platform con OAuth e inicia sesión con tu cuenta de propietario de Vocenya.

Grok y Grok Bot

En Grok Business y Enterprise, añade https://vocenya.com/mcp/platform como conector MCP personalizado ("Bring your own MCP") e inicia sesión con OAuth, o usa una clave API con solo alcances de lectura. La carpeta plugins/vocenya-grok empaqueta ambos servidores con una habilidad de revisión diaria de recepción para un Grok Bot: resume llamadas, chats y clientes potenciales, redacta seguimientos y nunca contacta a un cliente sin aprobación.

Cualquier otro cliente

Cualquier cliente que admita Streamable HTTP funciona. Para el servidor de plataforma, inicia sesión con OAuth o envía Authorization: Bearer <your key>.

Ejemplos de indicaciones

"Usando la documentación de Vocenya, ¿cómo verifico la firma de un webhook? Muestra código en Node."
"¿Qué alcance necesito para crear un cliente potencial y cómo se ve el cuerpo de la solicitud?"
"Muestra los clientes potenciales que mi recepcionista de IA capturó esta semana." (plataforma)
"¿Qué citas reservó la IA para el próximo lunes?" (plataforma)
"¿Cuánto cuesta Vocenya y cuántos minutos de IA incluye cada plan?" (sitio)

Registro MCP oficial

Los archivos en registry/ son las entradas publicadas en el Registro MCP oficial bajo el espacio de nombres com.vocenya (com.vocenya/docs, com.vocenya/platform, com.vocenya/site).

Enlaces

Guía de MCP: https://vocenya.com/docs/mcp
Documentación para desarrolladores: https://vocenya.com/docs
Referencia de API: https://vocenya.com/docs/reference (OpenAPI: https://vocenya.com/docs/api.json)
Modo de prueba: https://vocenya.com/docs/test-mode
Documentación para LLMs: https://vocenya.com/docs/llms.txt y https://vocenya.com/docs/llms-full.txt
Precios: https://vocenya.com/pricing
Privacidad: https://vocenya.com/privacy · Términos: https://vocenya.com/terms

Privacidad

Los servidores de docs y sitio son de solo lectura y no pueden ver ninguna cuenta de cliente. El servidor de plataforma solo ve la cuenta empresarial que posee la clave API (o la que un propietario eligió al conectarse con OAuth), y solo lo que permiten los alcances aprobados. El modo HIPAA es un complemento de pago con un BAA firmado; conectar un cliente de IA no hace que ese cliente esté cubierto por el BAA, por lo que solo envía datos de pacientes a herramientas de IA con las que tengas tus propios acuerdos. Política completa: https://vocenya.com/privacy

Soporte, seguridad y licencia

Preguntas y correcciones: abre un issue o envía un correo a info@gh-businesssolutions.com
Informes de seguridad: consulta SECURITY.md
Licencia: MIT para el contenido de este repositorio. El servicio de Vocenya en sí es un producto comercial alojado bajo los términos de Vocenya.