Vocenya Docs

Servidor MCP público, somente leitura, para a documentação da API do Vocenya: pesquise guias, leia páginas e obtenha todos os endpoints REST com exemplos em cURL, Node, PHP e Python.

GitHubExperimente este MCPPatrocinado

Servidor MCP hospedado

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

Instala no Claude Code, Codex, Cursor e outros

Documentação

Servidores MCP da Vocenya

Conecte Claude, ChatGPT, Cursor, VS Code e outros assistentes de IA ao Vocenya, a recepcionista de IA para pequenas empresas criada pela GH Business Solutions, e à sua documentação para desenvolvedores.

O Vocenya atende chamadas telefônicas e chats de sites 24 horas por dia, 7 dias por semana, agenda compromissos, captura leads, transfere chamadas para pessoas treinadas e realiza chamadas de IA de saída com verificações de Não Perturbe, consentimento e horários de chamada. Ele executa três servidores remotos de Model Context Protocol via Streamable HTTP. Nada para instalar: aponte seu cliente para uma URL.

Guia completo: https://vocenya.com/docs/mcp

Servidor	URL	Autenticação	O que faz
Vocenya Docs	`https://vocenya.com/mcp/docs`	Nenhuma	Pesquise a documentação para desenvolvedores do Vocenya e obtenha todos os endpoints REST com exemplos de código. Somente leitura.
Vocenya (plataforma)	`https://vocenya.com/mcp/platform`	OAuth ou chave de API	Chamadas, leads, reservas e chats de uma conta empresarial; adicione leads, coloque chamadas de IA de saída na fila, atualize a lista de Não Perturbe.
Vocenya Site	`https://vocenya.com/mcp/site`	Nenhuma	Respostas sobre o próprio Vocenya a partir de vocenya.com: planos e preços, produtos, setores, locais, guias. Somente leitura.

Os servidores públicos permitem 60 solicitações por minuto por endereço IP. O servidor da plataforma compartilha o limite REST da chave de API (120 solicitações por minuto por chave por padrão).

Este repositório contém as entradas oficiais do MCP Registry, um plugin para Claude Code e estas instruções. Os servidores são hospedados pela Vocenya; o código deles não está aqui.

Ferramentas

Vocenya Docs (sem chave, somente leitura)

Ferramenta	O que faz
`search_docs`	Pesquise guias (autenticação, webhooks, paginação, regras de chamadas de saída, chat ao vivo, MCP) e todos os endpoints da API.
`get_doc_page`	Uma página da documentação como Markdown, por exemplo `quickstart`, `webhooks` ou `reference/leads`.
`list_endpoints`	Endpoints REST com método, caminho, resumo e escopo necessário, agrupados por recurso.
`get_endpoint`	Um endpoint completo: escopo, parâmetros, corpo da solicitação, respostas e exemplos de código em cURL, Node, PHP e Python.

Plataforma Vocenya (OAuth ou chave de API)

Ferramenta	Escopo	O que faz
`list_calls`	`calls:read`	Chamadas atendidas pela IA, agentes GH Live ou pela equipe, das mais recentes para as mais antigas.
`get_call`	`calls:read`	Uma chamada com seus leads; resumo da IA e transcrição, a menos que a conta esteja no modo HIPAA.
`list_leads`	`leads:read`	Leads de chamadas, chats e formulários.
`get_lead`	`leads:read`	Um lead com dados de contato, motivo, urgência e origem.
`create_lead`	`leads:write` (+ `outbound:write` para retorno de chamada da IA)	Adicione um lead de outro sistema; opcionalmente, peça para a IA retornar a chamada.
`list_bookings`	`bookings:read`	Compromissos que a IA agendou no calendário da empresa.
`list_chats`	`chats:read`	Conversas de chat ao vivo do site.
`queue_outbound_call`	`outbound:write`	Peça para a IA ligar para alguém que consentiu. A conformidade é verificada primeiro; recusas retornam o motivo.
`add_do_not_call`	`dnc:write`	Adicione um número à lista de Não Perturbe da empresa.

Cada ferramenta verifica seu próprio escopo (o da chave de API, ou os escopos que um proprietário aprovou ao conectar via OAuth), então uma chave com apenas leads:read pode ler leads, mas não pode colocar chamadas na fila. Chaves de teste (vk_test_...) funcionam em dados de exemplo separados e nunca ligam para ninguém. Contas no modo HIPAA nunca retornam transcrições, resumos de IA ou mensagens de chat pelo MCP.

Vocenya Site (sem chave, somente leitura)

get_pricing, get_service, search_industries, get_industry, list_locations, search_articles, get_article, e o recurso vocenya://llms.txt.

Autenticação

Docs e Site: nenhuma.
Plataforma, OAuth (sem chave): clientes que entram com OAuth (Claude Code, conectores Claude, modo de desenvolvedor do ChatGPT e outros) só precisam da URL. O cliente se registra sozinho, então um proprietário da conta entra no Vocenya e escolhe a conta, dados ao vivo ou de teste, e as permissões (os mesmos escopos das chaves de API). Os proprietários veem e desconectam aplicativos conectados na página Desenvolvedores: https://vocenya.com/app/developers. O servidor suporta código de autorização OAuth 2.1 com PKCE (S256) e registro dinâmico de clientes.
Plataforma, chave de API: Authorization: Bearer vk_live_... (ou vk_test_... para dados de teste). O proprietário da conta cria chaves, cada uma com seus próprios escopos, na mesma página Desenvolvedores. Mantenha as chaves em variáveis de ambiente; nunca as cole em um chat ou as envie para um repositório.

Conectar

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"

Ou instale o plugin deste repositório, que adiciona o servidor de documentação e duas habilidades (API REST e webhooks, instalação de chat ao vivo do site):

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

Claude Desktop e claude.ai

Servidor de Docs: Configurações > Conectores > Adicionar conector personalizado, URL https://vocenya.com/mcp/docs, sem autenticação.

Servidor da plataforma: adicione um conector personalizado com a URL https://vocenya.com/mcp/platform e entre com sua conta de proprietário do Vocenya (OAuth).

Ou, com uma chave de API, através da ponte mcp-remote em 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 (o VS Code pede a chave uma vez e a armazena com segurança):

{
    "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

Ative o modo de desenvolvedor e adicione um conector personalizado com a URL https://vocenya.com/mcp/docs e sem autenticação. Para os dados da sua conta, adicione https://vocenya.com/mcp/platform com OAuth e entre com sua conta de proprietário do Vocenya.

Grok e Grok Bot

No Grok Business e Enterprise, adicione https://vocenya.com/mcp/platform como um conector MCP personalizado ("Bring your own MCP") e entre com OAuth, ou use uma chave de API com escopos somente leitura. A pasta plugins/vocenya-grok empacota ambos os servidores com uma habilidade de revisão diária de recepção para um Grok Bot: ela resume chamadas, chats e leads e rascunha acompanhamentos, e nunca contata um cliente sem aprovação.

Qualquer outro cliente

Qualquer cliente que suporte Streamable HTTP funciona. Para o servidor da plataforma, entre com OAuth ou envie Authorization: Bearer <your key>.

Exemplos de prompts

"Usando a documentação do Vocenya, como verifico a assinatura de um webhook? Mostre código em Node."
"Qual escopo preciso para criar um lead e como é o corpo da solicitação?"
"Mostre os leads que minha recepcionista de IA capturou esta semana." (plataforma)
"Quais compromissos a IA agendou para a próxima segunda-feira?" (plataforma)
"Quanto custa o Vocenya e quantos minutos de IA cada plano inclui?" (site)

MCP Registry oficial

Os arquivos em registry/ são as entradas publicadas no MCP Registry oficial sob o namespace com.vocenya (com.vocenya/docs, com.vocenya/platform, com.vocenya/site).

Privacidade

Os servidores de docs e site são somente leitura e não podem ver nenhuma conta de cliente. O servidor da plataforma vê apenas a conta empresarial que possui a chave de API (ou que um proprietário escolheu ao conectar via OAuth), e somente o que os escopos aprovados permitem. O modo HIPAA é um complemento pago com um BAA assinado; conectar um cliente de IA não faz esse cliente ser coberto pelo BAA, então envie dados de pacientes apenas para ferramentas de IA com as quais você tenha seus próprios acordos. Política completa: https://vocenya.com/privacy

Suporte, segurança e licença

Perguntas e correções: abra uma issue ou envie um e-mail para info@gh-businesssolutions.com
Relatórios de segurança: veja SECURITY.md
Licença: MIT para o conteúdo deste repositório. O serviço Vocenya em si é um produto comercial hospedado sob os termos do Vocenya.