RoofKit MCP - RoofKit Docs

Antes de conectarte

RoofKit usa el protocolo de contexto de modelos (MCP) para conectar tu cliente de IA a tu espacio de trabajo. Está dirigido a miembros con sesión iniciada. Se siguen aplicando tu rol, el acceso aprobado, el plan y los créditos disponibles.

Incluido en los planes de pagoRoofKit MCP está incluido en los planes Pro, Ultra y Enterprise. Los espacios de trabajo Free no pueden conectarse. Cada tienda revisa las publicaciones a su propio ritmo, así que una tienda puede no mostrar RoofKit todavía. Mientras tanto funcionan el marketplace público y las conexiones directas de abajo.

Usa tu inicio de sesión de RoofKitNo pegues claves rk_live_ de Partner API en un plugin, la configuración del cliente ni el chat del agente. MCP usa OAuth, no claves de Partner API. No se requiere un secreto de cliente.

Revisa MCP Access

Inicia sesión en https://app.roofkit.ai y selecciona el espacio de trabajo que quieres conectar. Abre Configuración y luego MCP Access. Los espacios de trabajo nuevos empiezan con el acceso activado. Un administrador que puede gestionar integraciones puede desactivarlo.

Abrir MCP Access

Revisa el acceso del espacio de trabajo y administra los clientes conectados.

Instala desde tu cliente

Instala el plugin de RoofKit desde el directorio de plugins de tu cliente. El plugin añade la conexión de RoofKit y las instrucciones de trabajo. Tu primera solicitud a RoofKit abre el inicio de sesión.

Claude, Claude Desktop, Cowork y Claude Code: abre el directorio de Claude e instala RoofKit.
ChatGPT y Codex: abre el directorio de plugins e instala RoofKit.
Cursor: abre el Cursor Marketplace e instala RoofKit.

Si tu cliente todavía no muestra RoofKit, añade el marketplace público verveai-hq/roofkit-plugins de GitHub en su gestor de plugins. En Claude Code, ejecuta los comandos de abajo.

Comandos del marketplace en Claude Code

claude plugin marketplace add verveai-hq/roofkit-plugins
claude plugin install roofkit@roofkit

Conéctate sin un plugin

Una conexión directa añade las herramientas de RoofKit sin las instrucciones de trabajo. Usa https://api.roofkit.ai/mcp. Claude, ChatGPT, Codex y Claude Code se identifican con un documento de metadatos de cliente, así que basta con la URL. Cursor y las instrucciones de abajo usan un ID de cliente público fijo. Elige una sola conexión de RoofKit por cliente para evitar herramientas duplicadas. Usa una versión actual del cliente compatible con MCP por HTTP y un ID de cliente OAuth fijo. Si un comando o una opción no está disponible, actualiza primero el cliente. Estas instrucciones no certifican una versión de escritorio específica.

Conectores de Claude y ChatGPT

En Claude o ChatGPT, añade un conector personalizado e ingresa https://api.roofkit.ai/mcp como URL del servidor. Deja vacíos el ID de cliente y el secreto de cliente. Después inicia sesión desde el conector.

Cursor de escritorio

Añade esta entrada a ~/.cursor/mcp.json para uso personal, o a .cursor/mcp.json para este proyecto. Conserva los demás servidores. Abre los ajustes de MCP en Cursor, conecta roofkit y completa la autorización en el navegador. El mismo ID de cliente funciona en Cursor web y en los Cloud Agents.

Configuración MCP de Cursor

{
  "mcpServers": {
    "roofkit": {
      "url": "https://api.roofkit.ai/mcp",
      "auth": {
        "CLIENT_ID": "roofkit-cursor"
      }
    }
  }
}

Codex

Ejecuta estos comandos en la CLI de Codex. Añaden un servidor remoto e inician la autenticación OAuth. Si ya completaste la autenticación al añadir el servidor, omite el comando login. Reinicia la sesión de Codex después de conectarte.

Comandos de la CLI de Codex

codex mcp add roofkit --url https://api.roofkit.ai/mcp --oauth-client-id roofkit-codex
codex mcp login roofkit

Claude Code

Ejecuta el siguiente comando para una conexión personal. Abre Claude Code, ejecuta /mcp, selecciona roofkit y autentícate en el navegador. No añadas —client-secret.

Comando de Claude Code

claude mcp add --transport http --scope user --client-id roofkit-claude roofkit https://api.roofkit.ai/mcp

Qué añade el plugin

El plugin de RoofKit incluye la conexión y las instrucciones de trabajo para configuración, CRM, sitios, reportes, analíticas, automatizaciones y renders de techos con estimados. Un plugin no concede acceso al espacio de trabajo. Cada cliente necesita su propia aprobación OAuth. Si la conexión del plugin no completa OAuth, desactívala y usa una conexión directa. Mantén una sola conexión de RoofKit activa.

Autoriza y verifica tu espacio de trabajo

Inicia la autorización desde el cliente. Se abrirá una página de consentimiento en https://app.roofkit.ai. Inicia sesión con tu propia cuenta de RoofKit. No abras manualmente una URL de consentimiento vacía ni compartas la URL de retorno.
La pantalla de consentimiento muestra el cliente que solicita acceso. Para Claude, ChatGPT y Codex también muestra el dominio web que identifica al cliente. Aprueba solo una conexión que tú iniciaste.
Verifica el espacio de trabajo que aparece en la pantalla de consentimiento y revisa los permisos solicitados. Si es incorrecto, selecciona el espacio de trabajo deseado en la aplicación de RoofKit y reinicia la autorización desde tu cliente. Aprueba el acceso y vuelve al cliente.
Pide: “Muestra el perfil de la empresa de mi espacio de trabajo conectado de RoofKit”. Confirma la empresa antes de solicitar cambios. Esto usa roofkit.workspace.profile.get y no modifica datos.
Cada autorización pertenece a un usuario y un espacio de trabajo. Cambiar de espacio de trabajo en la aplicación no traslada una conexión existente. Para cambiarlo, revoca la autorización anterior y autoriza de nuevo el espacio de trabajo deseado.

Qué puedes pedirle a tu agente

Área	Solicitud de ejemplo	Qué se hace en RoofKit
CRM	Lista mis leads más recientes, pasa un lead a la siguiente etapa con fecha de seguimiento y agrega un registro a un Data Object.	Las herramientas de leads y Data Objects crean, actualizan, vinculan y archivan registros con tu permiso. Los valores de cotización y venta requieren acceso financiero. Cada registro guarda un historial de cambios que puedes revertir.
Sitios	Muestra el texto de mi landing page principal y cambia su título.	Los cambios guardados en un sitio se publican al instante. Eliminar un sitio, conectar un dominio personalizado y cambiar el DNS abren la aplicación.
Reportes	Busca un reporte de medición y resume sus detalles disponibles.	Los agentes pueden exportar un PDF, dar un enlace de descarga de corta duración, importar un archivo de reporte y compartir un enlace con el cliente. La aprobación y la edición de geometría abren el editor de reportes.
Analíticas	Crea un panel de leads nuevos por fuente, comparte su enlace público y define un CPL objetivo para una campaña.	Los cambios en paneles guardan un historial de versiones que puedes restaurar. Los gastos y los objetivos de CPL o CPA requieren acceso financiero. Combinar fuentes de leads mueve los gastos y se puede revertir.
Automatizaciones	Lista las automatizaciones de mi tabla de leads y ayúdame a encontrar una ejecución para reintentar.	Los reintentos abren la interfaz de automatizaciones. Listar no crea ni configura una rutina.
Renders de techos	Envía al propietario un enlace para subir la foto de un techo metálico color carbón y luego muéstrame el render.	El propietario sube la foto en una página privada de RoofKit. Cada render consume créditos del espacio de trabajo.
Estimados	Calcula el precio de reemplazo del techo para 123 Main St, Austin, TX 78701.	El estimado usa los precios de tu espacio de trabajo y consume créditos. No es una cotización final.
Espacio de trabajo y equipo	Actualiza la dirección de la empresa, cambia el color de acento de los correos e invita a un nuevo vendedor.	Una invitación envía un correo al instante. Los cambios de rol, la eliminación de miembros, la facturación y la propiedad abren la aplicación.
Llamadas y conectores	Etiqueta las llamadas perdidas de ayer, define la fuente de un número de seguimiento y revisa por qué dejaron de sincronizarse los gastos de Google Ads.	Los enlaces de grabación duran 15 minutos y cada reproducción queda registrada. Comprar números y conectar cuentas abren la aplicación.

Continúa en la aplicaciónCuando una herramienta devuelve un enlace a la aplicación, ábrelo y termina el paso en RoofKit. Recibir un enlace no significa que la acción esté completa. Los pagos, cambios sensibles de la cuenta y configuración de credenciales requieren la aplicación. Nunca pegues credenciales de proveedores en el chat del agente.

La referencia de herramientas MCP lista cada herramienta con su acceso, tipo y argumentos.

Renders y estimados sin páginas incrustadas

Estas herramientas funcionan en clientes de IA que bloquean páginas incrustadas. El agente crea un enlace privado de subida, tú se lo envías al propietario y el render vuelve como imagen en el chat. Un estimado se ejecuta como trabajo a partir de una dirección de EE. UU.

Render: roofkit.visualizer.upload_link.create, luego roofkit.visualizer.upload_link.get hasta que el render termine, y después roofkit.visualizer.image.get.
Estimado: roofkit.estimates.create y luego roofkit.jobs.get hasta que el trabajo termine con éxito. roofkit.estimates.get vuelve a leer el estimado guardado más tarde.

Subidas privadasLos enlaces de subida usan un token, son de un solo uso y caducan. Las fotos y los renders se quedan en el almacenamiento privado de RoofKit y nunca se convierten en URLs públicas. Una conexión solo lee los enlaces de subida y los estimados que creó. Revocar la autorización cierra sus enlaces de subida abiertos.

¿Vas a crear tu propia aplicación para propietarios? Usa la Partner API con una clave de API del espacio de trabajo. MCP es para miembros del espacio de trabajo.

Trabajos largos y reintentos

Si una herramienta devuelve job_id, conserva ese ID y pide al agente que consulte roofkit.jobs.get hasta que termine o falle. Usa el resultado o enlace al archivo devuelto. Un trabajo en cola no es un resultado completado. Para un reintento que acepte idempotency_key, reutiliza la clave original. No repitas una creación ni una operación que consuma créditos para consultar su estado. Si el resultado no está claro, revisa primero el registro o trabajo existente.

Revoca, actualiza o elimina

En el espacio de trabajo conectado, abre Configuración → MCP Access. Busca el cliente en Autorizaciones y selecciona Revocar. Los miembros pueden revocar sus propias autorizaciones. Los administradores con permiso para gestionar integraciones pueden revocar cualquier autorización del espacio de trabajo. Las llamadas posteriores de esa autorización pierden el acceso. Revocar una autorización no desinstala el plugin. Desinstalar o desactivar un cliente no sustituye la revocación. Revoca primero cuando quieras detener el acceso. Para volver a conectarte, inicia de nuevo la autorización OAuth. Las instalaciones desde una tienda o un marketplace se actualizan con el gestor de plugins de tu cliente. Elimina el plugin con ese mismo gestor. Para una conexión directa, elimina solo la entrada roofkit de Cursor o usa los comandos de abajo.

Eliminar una conexión directa

codex mcp remove roofkit
claude mcp remove --scope user roofkit

Solución de problemas

Acceso no disponible: confirma que el espacio de trabajo tiene un plan Pro, Ultra o Enterprise y que MCP Access está activado. Cambiar un ajuste local del cliente no habilita el acceso al servicio.
Error de OAuth o de registro: actualiza tu cliente e inicia de nuevo la autorización desde el cliente. Para las conexiones directas, revisa el ID de cliente fijo. No uses una clave de API en su lugar.
Herramientas ausentes o no permitidas: confirma el espacio de trabajo, los permisos aprobados, el rol actual y el plan. Consulta el acceso con tu administrador. Un plugin no puede ampliar tus permisos.
Para otros fallos, escribe a hello@roofkit.com con el nombre y la versión del cliente, el código de error y el request_id si aparece. No envíes tokens, claves de API, URLs de retorno ni registros de clientes.

Soporte y privacidad

Escribe a hello@roofkit.com para recibir ayuda con RoofKit MCP. La política de privacidad en https://roofkit.ai/privacy describe cómo RoofKit trata los datos del espacio de trabajo, incluidos los que lee un cliente de IA conectado.

Documentación de los clientes

Cursor de escritorio

Referencia de configuración e instalación del cliente.

Codex

Referencia de configuración e instalación del cliente.

Claude Code

Referencia de configuración e instalación del cliente.

​Antes de conectarte

​Revisa MCP Access

Abrir MCP Access

​Instala desde tu cliente

​Conéctate sin un plugin

​Conectores de Claude y ChatGPT

​Cursor de escritorio

​Codex

​Claude Code

​Qué añade el plugin

​Autoriza y verifica tu espacio de trabajo

​Qué puedes pedirle a tu agente

​Renders y estimados sin páginas incrustadas

​Trabajos largos y reintentos

​Revoca, actualiza o elimina

​Solución de problemas

​Soporte y privacidad

​Documentación de los clientes

Cursor de escritorio

Codex

Claude Code

Antes de conectarte

Revisa MCP Access

Instala desde tu cliente

Conéctate sin un plugin

Conectores de Claude y ChatGPT

Cursor de escritorio

Codex

Claude Code

Qué añade el plugin

Autoriza y verifica tu espacio de trabajo

Qué puedes pedirle a tu agente

Renders y estimados sin páginas incrustadas

Trabajos largos y reintentos

Revoca, actualiza o elimina

Solución de problemas

Soporte y privacidad

Documentación de los clientes