Construye con VULK desde Claude y otros clientes MCP: el conector, herramienta por herramienta

Verificado el 10 de octubre de 2026, contra el servidor en vivo y el código que hay detrás.

VULK tiene un servidor MCP remoto. Añade una dirección a Claude, a Claude Code o a otro asistente que admita servidores MCP remotos, inicia sesión en VULK una vez, y el asistente podrá listar tus proyectos, leer sus archivos, consultar tus créditos y empezar o continuar un build por ti. No instalas nada ni pegas ninguna clave de API.

La dirección es:

https://app.vulk.dev/mcp

Este artículo enumera cada herramienta que expone el servidor y muestra las respuestas en vivo que prueban que está funcionando.

Prueba de que está en vivo

Cualquiera puede comprobar el servidor sin cuenta. Pídele sus metadatos de inicio de sesión:

curl https://app.vulk.dev/.well-known/oauth-protected-resource

El 10 de octubre de 2026 respondió:

{
  "resource": "https://app.vulk.dev/mcp",
  "authorization_servers": ["https://app.vulk.dev"],
  "scopes_supported": ["projects.read", "usage.read", "projects.write"],
  "bearer_methods_supported": ["header"],
  "resource_name": "VULK"
}

Si llamas al servidor sin token, lo rechaza con un 401 y una cabecera WWW-Authenticate que dirige al cliente a esos metadatos. Esa cabecera es la forma en que un cliente MCP descubre que tiene que hacer que la persona inicie sesión. El mismo servidor responde también en https://mcp.vulk.dev/mcp.

Cómo funciona el inicio de sesión

La conexión usa OAuth estándar, con los pasos de descubrimiento y registro que define la especificación MCP:

• El cliente se registra solo a través de un endpoint de registro, así que nunca copias un client ID.
• El flujo de código de autorización exige PKCE con S256, y los clientes se autentican sin secreto, que es el modelo correcto para apps que corren en tu máquina.
• El acceso se renueva con refresh tokens, pero una conexión dura 90 días como máximo, por mucho que se renueve. Después vuelves a aprobarla.
• El servidor habla las versiones 2025-06-18, 2025-03-26 y 2024-11-05 del protocolo MCP.

Cuando te conectas, VULK muestra una pantalla de consentimiento que enumera exactamente lo que podrá hacer el asistente. Un asistente que solo pide leer recibe solo los permisos de lectura, y la pantalla te dice que la conexión no puede crear, cambiar, publicar ni borrar nada. Hay una advertencia que también imprimimos en esa pantalla: el nombre que aparece es el que la app se dio a sí misma, y VULK no puede verificarlo, así que aprueba solo una conexión que acabas de iniciar tú.

Puedes ver todas las apps conectadas en Settings › Integrations › Connected apps y quitar cualquiera en cualquier momento. Pierde el acceso al instante. Puedes tener hasta 50 apps conectadas y 20 pantallas de aprobación pendientes a la vez.

Las nueve herramientas

Seis herramientas solo leen. Tres pueden empezar, continuar o detener trabajo.

Cada herramienta declara el permiso que necesita, y el servidor rechaza una llamada hecha sin él. A una conexión de solo lectura ni siquiera se le muestran las herramientas de build.

Cómo corre un build desde un asistente

Construir lleva minutos, no milisegundos, así que se divide en dos:

1. El asistente llama a create_project con tu brief, de hasta 8.000 caracteres, y un request_id, un UUID nuevo para esta acción concreta.
2. VULK comprueba tu plan y tus créditos y responde con un recibo: el id de la petición, el id del proyecto y un enlace al editor. Un recibo significa que el build ha empezado, no que haya terminado.
3. El asistente llama a get_operation con el mismo request_id hasta que el trabajo está hecho, y te traslada cualquier pregunta que VULK te haga.

Si se pierde una respuesta, el asistente reintenta con el mismo request_id y los mismos argumentos, y VULK lo trata como la misma petición en lugar de empezar y cobrar una segunda. Si VULK no ha confirmado una petición en unos 20 segundos, la respuesta dice unconfirmed y el asistente la vuelve a leer con get_operation en lugar de adivinar.

El proyecto que sale es un proyecto de VULK normal. Aparece en tu cuenta, y puedes abrirlo en el editor cuando quieras.

Salvaguardas integradas

Algunas líneas están trazadas a propósito, en el código y no solo en la documentación:

• Ninguna herramienta publica un sitio. Publicar se queda en el editor, donde puedes ver lo que sale en vivo.
• Ninguna herramienta compra créditos ni cambia tu plan. create_project y continue_project gastan créditos que tu plan ya incluye, exactamente igual que la misma petición escrita en el editor. Si el saldo no alcanza, VULK lo rechaza y dice por qué.
• Ninguna herramienta borra un proyecto. Una instrucción enviada con continue_project puede cambiar o eliminar archivos dentro de un proyecto, igual que la misma petición escrita en el editor, pero ninguna herramienta elimina el proyecto en sí.

Respuestas pensadas para modelos

Un asistente paga por cada byte que devuelve una herramienta, así que las respuestas tienen límites y dicen cuándo se cortan: una lista de proyectos se detiene en 50, una lista de archivos en 500 entradas y un solo archivo en 200.000 caracteres, con un indicador truncated cuando ocurre. Cada resultado llega dos veces, como texto para cualquier cliente y como datos estructurados para los clientes del protocolo 2025-06-18, y cada herramienta publica la forma exacta de esos datos como un esquema de salida, al que un test la obliga a ceñirse. Cada herramienta lleva además un título legible por personas y las indicaciones de solo lectura, destructiva e idempotente.

Los fallos vuelven como resultados de herramienta que el modelo puede leer, como "no existe ese archivo, lista primero los archivos", en lugar de errores de protocolo que terminan la conversación.

Cómo configurarlo

Claude (web y escritorio): abre Customize, luego Connectors, añade un conector personalizado con la dirección de arriba, elige Connect y aprueba en la ventana de VULK que se abre.

Claude Code:

claude mcp add --transport http vulk https://app.vulk.dev/mcp

Después ejecuta /mcp, elige vulk e inicia sesión cuando se abra el navegador.

Otros asistentes: añade la misma dirección como servidor MCP HTTP remoto en cualquier cliente que admita servidores remotos con inicio de sesión. El cliente abre VULK en tu navegador para que lo apruebes. La guía paso a paso está en la documentación de MCP.