Servidor MCP para agentes de IA

Mockzilla trae un servidor MCP, así que un agente de programación puede levantar mock APIs por ti. Pídele que mockee una spec e instala la CLI, arranca un servidor y te devuelve la URL, sin que salgas del editor.

Corre con npx y necesita Node 18 o más nuevo. No hay nada más que instalar. La mitad local funciona sin ninguna cuenta de Mockzilla.

Agrégalo a tu agente

Claude Code:

claude mcp add -s user mockzilla -- npx -y @mockzilla/mcp@latest

Gemini CLI:

gemini mcp add -s user mockzilla npx -y @mockzilla/mcp@latest

Claude Desktop y Cursor toman un archivo de configuración. El de Claude Desktop es ~/Library/Application Support/Claude/claude_desktop_config.json, el de Cursor es ~/.cursor/mcp.json, y los dos quieren el mismo bloque:

{
  "mcpServers": {
    "mockzilla": {
      "command": "npx",
      "args": ["-y", "@mockzilla/mcp@latest"]
    }
  }
}

Reinicia la app después de editar. Cursor también lo puede hacer en Settings -> MCP Servers -> Add new MCP server.

Deja el @latest en el comando. Sin él, npx reutiliza la primera versión que resolvió alguna vez, y un reinicio nunca toma una más nueva.

Qué puede hacer tu agente sin cuenta

Todo esto corre en tu propia máquina:

• Preparar: check_cli busca la CLI en tu máquina, install_cli la baja al caché propio del puente, y bridge_status informa si se publicó un puente más nuevo.
• Leer specs: info resume una spec o un paquete .mockz con su lista completa de rutas, lint encuentra schemas que ninguna respuesta puede cumplir, y discover_specs recorre una carpeta e informa qué se puede mockear desde ahí.
• Reformar specs: simplify recorta una spec cuando pesa demasiado para mockearla limpiamente, y pack convierte una carpeta de servicios en un archivo .mockz.
• Correr mocks: serve_locally arranca un servidor sobre una o varias specs, y a una sola spec le puede agregar latencia o respuestas de error. stop_locally lo detiene, y call_endpoint dispara una solicitud para que el agente te muestre la respuesta.
• Mockear sin spec: mock_endpoint fija una sola ruta a una respuesta que describas, con list_mock_endpoints y clear_mock_endpoints al lado.
• Leer la documentación: mockzilla_docs_topics, mockzilla_docs_search y mockzilla_docs_read le dan al agente la documentación de este sitio y la del motor. Vienen con el puente, así que leerlas no necesita conexión a internet ni inicio de sesión.

install_cli nunca edita tu PATH. Guarda su propia copia, así que una instalación con brew queda intacta.

Conecta tu cuenta

Una vez que inicias sesión, el agente también llega a tu organización: puede listar lo que tienes desplegado, recorrer el catálogo y desplegar una simulación alojada que sigue respondiendo después de que el agente se detiene.

Pídele a tu agente que inicie sesión en Mockzilla, o pídele algo alojado. Llama a la herramienta login y tu navegador abre el inicio de sesión de Mockzilla.

Inicia sesión, si todavía no lo hiciste.

Elige la organización en la que debe trabajar el agente.

Elige Solo lectura o Lectura y escritura. Con Lectura y escritura el agente puede desplegar. Si eres Viewer, solo puedes elegir Solo lectura.

Haz clic en Permitir.

El inicio de sesión queda en tu máquina y se renueva solo, así que lo haces una sola vez.

Una vez que iniciaste sesión, tu agente puede usar estas herramientas:

• get_context informa con qué organización y qué acceso trabaja el agente.
• list_sims pagina por las simulaciones que puedes ver, con sus URLs y sus estados.
• list_catalog_products recorre el catálogo.
• wait_for_deploy espera a que un despliegue pase a activo y devuelve su URL en marcha.
• deploy_mock_from_catalog, deploy_mock_from_spec y deploy_mock_from_url crean una simulación alojada desde una entrada del catálogo, una spec pegada o la URL de una spec. Solo un inicio de sesión con Lectura y escritura puede usarlas.

Un despliegue hecho por un agente es un despliegue como cualquier otro: cuenta contra tu plan y aparece en la app.

Para cambiar de organización o de acceso, pídele al agente que cierre sesión, lo que llama a logout, y vuelve a iniciar sesión. Cada app que conectaste aparece en Configuración, en la pestaña Apps conectadas, donde también puedes revocarla.

Usar una API key

Una máquina sin navegador, como un runner de CI o un servidor remoto, no puede abrir la página de inicio de sesión. Ahí dale al agente una API key.

Crea la key primero. Abre Configuración, después la pestaña API keys, y haz clic en Crear key. Dale el rol Editor si el agente debe desplegar, o Viewer si solo debe leer. La key se muestra una sola vez.

Después pásala como MOCKZILLA_TOKEN. En Claude Code:

claude mcp add -s user mockzilla -e MOCKZILLA_TOKEN=mz_... -- npx -y @mockzilla/mcp@latest

En un archivo de configuración:

{
  "mcpServers": {
    "mockzilla": {
      "command": "npx",
      "args": ["-y", "@mockzilla/mcp@latest"],
      "env": { "MOCKZILLA_TOKEN": "mz_..." }
    }
  }
}

Con una key puesta, el agente nunca te pide iniciar sesión.

Ajustes

Estas variables de entorno son todas opcionales:

• MOCKZILLA_TOKEN es una API key que el agente usa en lugar de iniciar sesión.
• MOCKZILLA_NO_BROWSER en 1 evita que login abra un navegador. El agente te da el enlace de inicio de sesión.
• MOCKZILLA_BIN_VERSION fija qué versión de la CLI baja install_cli. Por defecto sigue al puente.
• MOCKZILLA_MANAGED_PORT es el puerto preferido para el servidor de mock_endpoint, 2200 por defecto. Si está ocupado, se usa uno libre.

Dónde viven sus archivos

El puente guarda la CLI que instaló y los endpoints que escribió mock_endpoint bajo ~/.cache/mockzilla-mcp/. Borrar esa carpeta lo reinicia por completo, y una instalación de la CLI con brew no se ve afectada.

Para borrar solo los endpoints mockeados, pídele al agente que corra clear_mock_endpoints.

Tu inicio de sesión se guarda en ~/.config/mockzilla-mcp/. Cerrar sesión lo borra.

A dónde ir después

• Referencia de la CLI
• Empezar desde el catálogo
• Despliegue y URLs

El puente es de código abierto: mockzilla/mockzilla-mcp.