Servidor MCP
neru-mcp es un Protocolo de Contexto Modelo (MCP) que permite a su asistente de IA publicar e implantar aplicaciones en Código Hub sin salir de su interfaz de chat. Puede crear productos Code Hub, cargar código fuente, publicar versiones y desplegar instancias VCR en ejecución totalmente a través de instrucciones en lenguaje natural.
Conectarse al servidor alojado
neru-mcp se ejecuta en VCR y está disponible como punto final remoto: no requiere instalación local. Elija el punto final más cercano a su región.
| Región | URL MCP |
|---|---|
| UE Oeste (Irlanda) | https://vcr-mcp.euw1.runtime.vonage.cloud/mcp |
| Este de EE.UU. (Virginia) | https://vcr-mcp.use1.runtime.vonage.cloud/mcp |
| AP Sudeste (Singapur) | https://vcr-mcp.apse1.runtime.vonage.cloud/mcp |
| AP Sureste (Sydney) | https://vcr-mcp.apse2.runtime.vonage.cloud/mcp |
Claude Escritorio
Añadir 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
Añadir a .vscode/mcp.json (o la configuración MCP de su espacio de trabajo):
{
"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
Añádelo a tu configuración 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"
}
}
}
}
Sustituir <your-api-key> y <your-api-secret> con su Credenciales de API de Vonage). Configure X-Region a la región en la que desea desplegar.
Credenciales
Todas las herramientas aceptan credenciales como cabeceras HTTP (recomendado) o como parámetros explícitos de la herramienta. Las cabeceras tienen preferencia cuando ambas están presentes.
| Cabecera | Parámetro | Descripción |
|---|---|---|
X-Account-ID | account_id | Clave API de Vonage |
X-Account-Secret | account_secret | Secreto de API de Vonage |
X-Region | region | Región objetivo: euw1, use1, apse1o apse2 |
Flujo de trabajo de implantación estándar
Puedes pedirle a tu asistente de IA que ejecute todo este flujo: "Publicar mi aplicación VCR en Code Hub". El asistente llamará a cada herramienta en orden, le pedirá los valores que falten y le devolverá la URL de la instancia activa al final.
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
Herramientas Referencia
marketplace_create_product
Crear un nuevo producto en Código Hub.
| Parámetro | Tipo | Requerido | Por defecto | Descripción |
|---|---|---|---|---|
name | cadena | Sí | Nombre para mostrar (máx. 200 caracteres) | |
owner_name | cadena | Sí | Organización o individuo propietario | |
product_type | private / public / unlisted | No | private | Visibilidad |
Devoluciones: {"id": "<uuid>", "codehub_url": "https://developer.vonage.com/..."}
marketplace_create_version
Cree una nueva versión para un producto Code Hub existente. El despliegue se activa automáticamente tras la creación.
| Parámetro | Tipo | Requerido | Por defecto | Descripción |
|---|---|---|---|---|
product_id | UUID | Sí | Producto principal | |
version | semver (por ejemplo 1.0.0) | Sí | Número de versión | |
base | UUID | No | Versión existente en la que basarse | |
version_type | private / public / unlisted | No | private | Visibilidad |
Devoluciones: {"id": "<uuid>", "productId": "<uuid>"}
marketplace_upload_source
Devuelve una URL proxy para subir el archivo zip del código fuente. Envíe el zip directamente a proxy_url - no lo codifiques en base64. El zip debe contener vcr.yml en su raíz (no dentro de un subdirectorio).
| Parámetro | Tipo | Requerido | Por defecto |
|---|---|---|---|
product_id | UUID | Sí | |
version_id | UUID | Sí | |
filename | cadena | No | source.zip |
Devoluciones: {"proxy_url": "...", "method": "POST", "field_name": "source", "instructions": "..."}
Ejemplo de carga:
marketplace_submit_version
Enviar una versión para su revisión. Es necesario para publicar una versión en Code Hub.
| Parámetro | Tipo | Requerido |
|---|---|---|
product_id | UUID | Sí |
version_id | UUID | Sí |
Devoluciones: {"message": "Version submitted for review"}
marketplace_release_version
Publique una versión aprobada en Code Hub. La versión debe haber sido enviada y aprobada primero.
| Parámetro | Tipo | Requerido |
|---|---|---|
product_id | UUID | Sí |
version_id | UUID | Sí |
Devoluciones: {"message": "Version released to the Marketplace"}
marketplace_install_version
Instale una versión liberada del producto Code Hub como una instancia VCR activa.
| Parámetro | Tipo | Requerido | Por defecto | Descripción |
|---|---|---|---|---|
product_id | UUID | Sí | Producto principal | |
version_id | UUID | Sí | Versión a instalar | |
instance_name | cadena | Sí | Nombre de la nueva instancia | |
product_name | cadena | No | "" | Se utiliza para construir la URL de Code Hub |
configuration | objeto | No | {} | Configuración clave/valor para la instancia |
secrets | matriz | No | [] | Referencias secretas de la instancia |
Devoluciones: {"instance_url": "...", "codehub_url": "...", ...}
Herramientas adicionales
| Herramienta | Descripción |
|---|---|
marketplace_health | Compruebe que se puede acceder a la API de Code Hub |
marketplace_update_product | Establecer la versión activa de un producto Code Hub |
marketplace_update_version | Activar o desactivar el despliegue de una versión |
marketplace_upload_icon | Cargar un icono de producto (PNG o JPEG) |
marketplace_upload_screenshots | Subir capturas de pantalla de productos |
marketplace_download_source | Descargar el archivo fuente de una versión |
marketplace_upgrade_instance | Actualizar una instancia en ejecución a la última versión |
marketplace_delete_product | Eliminar permanentemente un producto y todas sus versiones |
Ejecutar localmente
Si prefiere ejecutar el servidor MCP localmente en lugar de utilizar los puntos finales alojados:
Establezca las siguientes variables de entorno antes de ejecutar:
| Variable | Descripción |
|---|---|
API_ACCOUNT_ID | Clave API de Vonage |
API_ACCOUNT_SECRET | Secreto de API de Vonage |
REGION | Región objetivo (euw1, use1, apse1, apse2) |
MCP_TRANSPORT | Modo de transporte: stdio (por defecto), sseo streamable-http |