Servidor MCP
neru-mcp é um Protocolo de Contexto de Modelo (MCP) servidor que permite que seu assistente de IA publique e implante Applications em Code Hub sem sair da interface de bate-papo. Você pode criar produtos no Code Hub, enviar código-fonte, publicar versões e implantar instâncias do VCR em execução, tudo por meio de instruções em linguagem natural.
Conectar-se ao servidor hospedado
neru-mcp Funciona no VCR e está disponível como um ponto de extremidade remoto — não é necessária nenhuma instalação local. Escolha o ponto de extremidade mais próximo da sua região.
| Região | URL do MCP |
|---|---|
| UE Ocidental (Irlanda) | https://vcr-mcp.euw1.runtime.vonage.cloud/mcp |
| Leste dos EUA (Virgínia) | https://vcr-mcp.use1.runtime.vonage.cloud/mcp |
| AP Sudeste (Cingapura) | https://vcr-mcp.apse1.runtime.vonage.cloud/mcp |
| AP Sudeste (Sydney) | https://vcr-mcp.apse2.runtime.vonage.cloud/mcp |
Área de trabalho do Claude
Adicionar a claude_desktop_config.json:
{
"mcpServers": {
"neru-mcp": {
"type": "http",
"url": "https://vcr-mcp.euw1.runtime.vonage.cloud/mcp",
"headers": {
"X-Account-ID": "<your-api-key>",
"X-Account-Secret": "<your-api-secret>",
"X-Region": "euw1"
}
}
}
}
VS Code / GitHub Copilot
Adicionar a .vscode/mcp.json (ou a configuração do MCP do seu ambiente de trabalho):
{
"servers": {
"neru-mcp": {
"type": "http",
"url": "https://vcr-mcp.euw1.runtime.vonage.cloud/mcp",
"headers": {
"X-Account-ID": "<your-api-key>",
"X-Account-Secret": "<your-api-secret>",
"X-Region": "euw1"
}
}
}
}
OpenCode
Adicione à sua configuração do OpenCode:
{
"mcp": {
"neru-mcp": {
"type": "remote",
"url": "https://vcr-mcp.euw1.runtime.vonage.cloud/mcp",
"enabled": true,
"headers": {
"X-Account-ID": "<your-api-key>",
"X-Account-Secret": "<your-api-secret>",
"X-Region": "euw1"
}
}
}
}
Substituir <your-api-key> e <your-api-secret> com o seu Credenciais da API da Vonage). Definir X-Region para a região onde você deseja fazer a implantação.
Credenciais
Todas as ferramentas aceitam credenciais tanto como cabeçalhos HTTP (recomendado) quanto como parâmetros explícitos da ferramenta. Os cabeçalhos têm precedência quando ambos estiverem presentes.
| Cabeçalho | Parâmetro | Descrição |
|---|---|---|
X-Account-ID | account_id | Chave da API da Vonage |
X-Account-Secret | account_secret | Chave secreta da API da Vonage |
X-Region | region | Região-alvo: euw1, use1, apse1, ou apse2 |
Fluxo de trabalho padrão de implantação
Você pode pedir ao seu assistente de IA para executar todo esse fluxo: "Publicar meu aplicativo VCR no Code Hub". O assistente chamará cada ferramenta em ordem, solicitará que você preencha os valores que estiverem faltando e, no final, fornecerá a URL da instância ativa.
Create Code Hub product
|
Create product version
|
Upload source code (POST zip to returned proxy_url)
|
Submit version for review
|
Release version
|
Install as VCR instance
Referência de ferramentas
marketplace_create_product
Criar um novo produto em Code Hub.
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|---|---|---|---|---|
name | sequência de caracteres | Sim | Nome de exibição (máx. 200 caracteres) | |
owner_name | sequência de caracteres | Sim | Organização ou pessoa física responsável | |
product_type | private / public / unlisted | Não | private | Visibilidade |
Devoluções: {"id": "<uuid>", "codehub_url": "https://developer.vonage.com/..."}
marketplace_create_version
Crie uma nova versão de um produto existente no Code Hub. A implantação é ativada automaticamente após a criação.
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|---|---|---|---|---|
product_id | UUID | Sim | Produto principal | |
version | semver (por exemplo, 1.0.0) | Sim | Número da versão | |
base | UUID | Não | Versão atual na qual esta se baseia | |
version_type | private / public / unlisted | Não | private | Visibilidade |
Devoluções: {"id": "<uuid>", "productId": "<uuid>"}
marketplace_upload_source
Retorna uma URL de proxy para o envio do arquivo ZIP com o código-fonte. Envie o arquivo ZIP diretamente por meio de uma solicitação POST para proxy_url — não o codifique em base64. O arquivo zip deve conter vcr.yml na raiz (não dentro de um subdiretório).
| Parâmetro | Tipo | Obrigatório | Padrão |
|---|---|---|---|
product_id | UUID | Sim | |
version_id | UUID | Sim | |
filename | sequência de caracteres | Não | source.zip |
Devoluções: {"proxy_url": "...", "method": "POST", "field_name": "source", "instructions": "..."}
Exemplo de envio:
marketplace_submit_version
Envie uma versão para revisão. Isso é necessário antes que uma versão possa ser publicada publicamente no Code Hub.
| Parâmetro | Tipo | Obrigatório |
|---|---|---|
product_id | UUID | Sim |
version_id | UUID | Sim |
Devoluções: {"message": "Version submitted for review"}
marketplace_release_version
Publique uma versão aprovada no Code Hub. A versão deve ter sido enviada e aprovada previamente.
| Parâmetro | Tipo | Obrigatório |
|---|---|---|
product_id | UUID | Sim |
version_id | UUID | Sim |
Devoluções: {"message": "Version released to the Marketplace"}
marketplace_install_version
Instale uma versão lançada de um produto do Code Hub como uma instância ativa do VCR.
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|---|---|---|---|---|
product_id | UUID | Sim | Produto principal | |
version_id | UUID | Sim | Versão a ser instalada | |
instance_name | sequência de caracteres | Sim | Nome da nova instância | |
product_name | sequência de caracteres | Não | "" | Usado para gerar a URL do Code Hub |
configuration | objeto | Não | {} | Configuração chave/valor para a instância |
secrets | matriz | Não | [] | Referências secretas para a instância |
Devoluções: {"instance_url": "...", "codehub_url": "...", ...}
Ferramentas adicionais
| Ferramenta | Descrição |
|---|---|
marketplace_health | Verifique se a API do Code Hub está acessível |
marketplace_update_product | Definir a versão ativa de um produto do Code Hub |
marketplace_update_version | Ativar ou desativar a implantação de uma versão |
marketplace_upload_icon | Carregue um ícone do produto (PNG ou JPEG) |
marketplace_upload_screenshots | Carregar capturas de tela do produto |
marketplace_download_source | Baixe o arquivo com o código-fonte de uma versão |
marketplace_upgrade_instance | Atualizar uma instância em execução para a versão mais recente |
marketplace_delete_product | Excluir definitivamente um produto e todas as suas versões |
Executar localmente
Se você preferir executar o servidor MCP localmente, em vez de usar os endpoints hospedados:
Defina as seguintes variáveis de ambiente antes de executar:
| Variável | Descrição |
|---|---|
API_ACCOUNT_ID | Chave da API da Vonage |
API_ACCOUNT_SECRET | Chave secreta da API da Vonage |
REGION | Região-alvo (euw1, use1, apse1, apse2) |
MCP_TRANSPORT | Meio de transporte: stdio (padrão), sse, ou streamable-http |