Servidor MCP
neru-mcp es un Protocolo de Contexto Modelo (MCP) que permite a su asistente de IA publicar e implantar aplicaciones en Code 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 |
|---|---|
| Europa Occidental (Irlanda) | https://vcr-mcp.euw1.runtime.vonage.cloud/mcp |
| Este de EE. UU. (Virginia) | https://vcr-mcp.use1.runtime.vonage.cloud/mcp |
| AP Southeast (Singapur) | https://vcr-mcp.apse1.runtime.vonage.cloud/mcp |
| AP Sudeste (Sídney) | https://vcr-mcp.apse2.runtime.vonage.cloud/mcp |
Claude Desktop
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, ya sea como encabezados HTTP (recomendado) o como parámetros explícitos de la herramienta. Si ambos están presentes, los encabezados tienen prioridad.
| Encabezado | Parámetro | Descripción |
|---|---|---|
X-Account-ID |
account_id |
Clave API de Vonage |
X-Account-Secret |
account_secret |
Clave secreta de la API de Vonage |
X-Region |
region |
Región objetivo: euw1, use1, apse1, o 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 Code 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 con el código fuente. Envía el archivo ZIP directamente mediante un método POST a proxy_url — No lo codifiques en base64. El archivo 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 |
Descarga 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 |
Clave secreta de la API de Vonage |
REGION |
Región objetivo (euw1, use1, apse1, apse2) |
MCP_TRANSPORT |
Medio de transporte: stdio (por defecto), sse, o streamable-http |