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:

curl -X POST "<proxy_url>" \ -H "X-Account-ID: <key>" \ -H "X-Account-Secret: <secret>" \ -H "X-Region: euw1" \ -F "source=@/path/to/source.zip"

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:

uvx --from git+https://github.com/nexmoinc/neru-mcp.git neru-mcp

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