> ## Documentation Index > Fetch the complete documentation index at: https://docs.roofkit.ai/llms.txt > Use this file to discover all available pages before exploring further. # RoofKit MCP > Conecta Claude, ChatGPT, Codex, Cursor o Claude Code a tu espacio de trabajo de RoofKit con OAuth. Instala, autoriza, genera renders de techos, calcula estimados y revoca el acceso. ## 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. > [!NOTE] > > **Incluido en los planes de pago** > > RoofKit 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. > [!WARNING] > > **Usa tu inicio de sesión de RoofKit** > > No 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](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. > [card] [Abrir MCP Access](https://app.roofkit.ai/settings/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. ```bash Comandos del marketplace en Claude Code theme={null} 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](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](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. ```json Configuración MCP de Cursor theme={null} { "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. ```bash Comandos de la CLI de Codex theme={null} 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. ```bash Comando de Claude Code theme={null} 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](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. | > [!NOTE] > > **Continúa en la aplicación** > > Cuando 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](https://docs.roofkit.ai/es/mcp-server/tools/contacts-and-data-objects.md) 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. > [!NOTE] > > **Subidas privadas** > > Los 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. ```bash Eliminar una conexión directa theme={null} 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](mailto: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](mailto:hello@roofkit.com) para recibir ayuda con RoofKit MCP. La política de privacidad en [https://roofkit.ai/privacy](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 > [card] [Cursor de escritorio](https://cursor.com/docs/mcp) > > Referencia de configuración e instalación del cliente. > [card] [Codex](https://developers.openai.com/codex/mcp) > > Referencia de configuración e instalación del cliente. > [card] [Claude Code](https://code.claude.com/docs/en/mcp) > > Referencia de configuración e instalación del cliente. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.