> For the complete documentation index, see [llms.txt](https://docs.dapta.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dapta.ai/dapta-docs-es/dforms/developers/mcp-connector.md). # Conecta tu agente de IA (MCP) Conecta Claude, ChatGPT, Claude Code, Codex, Cursor, OpenClaw o Hermes con dForms usando el conector MCP. Inicias sesión con tu cuenta, sin llave de API. Qué puede hacer el agente, qué acciones te pid El conector MCP de dForms le permite a tu asistente de IA crear, editar y publicar formularios, leer respuestas y revisar analíticas directamente desde un chat. Lo conectas una vez con tu cuenta de dForms y puede trabajar en todos los workspaces que puedes abrir. El conector es el servidor MCP de dForms en: ``` https://mcp.dforms.ai/mcp ``` * **Sin llave de API.** Tu app de IA te pide iniciar sesión con tu cuenta (OAuth) la primera vez que llama a dForms. No hay nada que crear, copiar ni guardar. * **Un conector, todos tus workspaces.** Funciona en cualquier workspace que puedas abrir en dForms. * **Cualquier miembro puede conectarse.** Owners, admins y members por igual, sin pedírselo al owner del workspace. En dForms, **Conecta tu agente** en el menú de la izquierda muestra los mismos pasos de esta página, con la URL y cada comando listos para copiar. *** ## Antes de conectar * **Abre dForms en la web una vez** con la cuenta que vas a conectar, en [app.dforms.ai](https://app.dforms.ai). Ese inicio de sesión es el que vincula tus workspaces con el conector. Un workspace que no has abierto en la web en los últimos 30 días no está disponible hasta que vuelvas a abrir dForms. * **¿Iniciaste sesión antes del 23 de octubre de 2026?** Sal de dForms (**Cerrar sesión** en el menú de tu perfil), vuelve a iniciar sesión una vez y luego conecta. Las sesiones anteriores no traen lo que el conector necesita para vincular tu cuenta. * **Tu rol aplica.** Cada herramienta actúa como tú, con tu rol en ese workspace (owner, admin o member). Lo que no puedes hacer en el panel, el agente tampoco lo puede hacer. * **¿Tienes varios workspaces?** Tu app de IA te pregunta cuál usar. Para cambiar, solo di "cambia a ". Cada respuesta dice en qué workspace trabajó. *** ## Conecta tu app {% tabs %} {% tab title="Claude" %} Para claude.ai, Claude Desktop y Cowork. **Paso 1:** En Claude, haz clic en **+** en la caja del chat y luego en **Connectors → Add connector → Add custom connector**. **Paso 2:** Usa `dForms` como nombre y pega esta URL. Deja vacía la configuración avanzada y haz clic en **Add**. ``` https://mcp.dforms.ai/mcp ``` **Paso 3:** Tu navegador abre la página de inicio de sesión. Escribe tu correo y el código de 6 dígitos que te enviamos. De vuelta en Claude, dForms aparece como **Connected**. **Paso 4:** Abre un chat nuevo y pregunta, por ejemplo: *Lista mis formularios en dForms*. {% endtab %} {% tab title="ChatGPT" %} **Paso 1:** En la app de escritorio de ChatGPT, cambia a modo **Work**. Abre **Plugins**, haz clic en **Add** y elige **Create MCP App**. **Paso 2:** Llena el formulario. Name: `dForms`. Server URL: pega la dirección de abajo. Deja Authentication en **OAuth**. Marca **I understand and want to continue** y créala. ``` https://mcp.dforms.ai/mcp ``` **Paso 3:** Haz clic en **Continue**. Se abre tu navegador: inicia sesión si te lo pide y luego haz clic en **Open ChatGPT** para volver. **Paso 4:** En **Plugins**, abre la pestaña **Personal**, elige **dForms** y haz clic en **Install plugin**. El navegador se abre una vez más para vincular tu cuenta: haz clic otra vez en **Open ChatGPT**. Ese segundo inicio de sesión es normal. **Paso 5:** Haz clic en **Try now**, escribe `@dForms` y pregunta, por ejemplo: *Lista mis formularios en dForms*. {% endtab %} {% tab title="Claude Code" %} **Paso 1:** En una terminal, ejecuta: ```bash claude mcp add --transport http --scope user dforms https://mcp.dforms.ai/mcp ``` **Paso 2:** Abre Claude Code, ejecuta `/mcp`, elige **dforms** y luego **Authenticate**. Inicia sesión en el navegador y vuelve a la terminal. **Paso 3:** Pregunta, por ejemplo: *Lista mis formularios en dForms*. > **💡 Tip:** ¿Ya conectaste dForms en Claude? Claude Code con la misma cuenta de Claude también usa ese conector: ejecuta `/mcp` para revisarlo. > {% endtab %} {% tab title="Codex" %} **Paso 1:** En una terminal, ejecuta: ```bash codex mcp add dforms --url https://mcp.dforms.ai/mcp ``` **Paso 2:** Ejecuta este comando. Se abre tu navegador: inicia sesión y vuelve a la terminal. ```bash codex mcp login dforms ``` **Paso 3:** Abre Codex y pregunta, por ejemplo: *Lista mis formularios en dForms*. > **💡 Tip:** ¿Usas la app de escritorio de Codex o ChatGPT? Sigue la pestaña **ChatGPT**. > {% endtab %} {% tab title="Cursor" %} **Paso 1:** Si tienes Cursor instalado, haz clic en **Add to Cursor** en la página **Conecta tu agente** de dForms. O abre **Customize → MCPs → New MCP Server**, elige **User** y pega esto en `mcp.json`: ```json { "mcpServers": { "dforms": { "url": "https://mcp.dforms.ai/mcp" } } } ``` **Paso 2:** **dforms** aparece con **Needs authentication**. Haz clic en **Authenticate**, inicia sesión en el navegador, haz clic en **Allow access** y luego en **Open Cursor**. **Paso 3:** Abre un **New Chat** y pregunta, por ejemplo: *Lista mis formularios en dForms*. Cursor te pregunta antes de usar una herramienta: haz clic en **Run**. {% endtab %} {% tab title="OpenClaw" %} **Paso 1:** En una terminal, guarda dForms como servidor MCP remoto que inicia sesión con tu cuenta: ```bash openclaw mcp set dforms '{"url":"https://mcp.dforms.ai/mcp","transport":"streamable-http","auth":"oauth"}' ``` **Paso 2:** Ejecuta este comando. Se abre tu navegador: inicia sesión y vuelve a la terminal. Después, `openclaw mcp status --verbose` muestra dforms como autorizado. ```bash openclaw mcp login dforms ``` **Paso 3:** Pregúntale a tu agente de OpenClaw, por ejemplo: *Lista mis formularios en dForms*. {% endtab %} {% tab title="Hermes" %} **Paso 1:** Abre `~/.hermes/config.yaml` (o ejecuta `hermes config edit`) y agrega dForms dentro de `mcp_servers`: ```yaml mcp_servers: dforms: url: "https://mcp.dforms.ai/mcp" auth: oauth ``` **Paso 2:** Ejecuta este comando. Se abre tu navegador: inicia sesión y vuelve a la terminal. Después abre una sesión nueva, o ejecuta `/reload-mcp` en la que tengas abierta. ```bash hermes mcp login dforms ``` **Paso 3:** Pregúntale a tu agente de Hermes, por ejemplo: *Lista mis formularios en dForms*. {% endtab %} {% endtabs %} *** ## Qué puedes hacer Nunca llamas una herramienta tú mismo. Pide con tus palabras y tu agente elige la correcta. El conector tiene 53 herramientas, en estos grupos: | Grupo | Qué puede hacer tu agente | | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Formularios** | Listar tus formularios, abrir uno con todas sus preguntas, lógica y diseño, crear un formulario a partir de una descripción, editarlo como borrador, publicarlo, volver a la versión que estaba publicada antes, descartar los cambios sin publicar, duplicar, borrar y cambiar el final de su enlace. | | **Respuestas y CSV** | Listar las respuestas de un formulario con filtros por fecha, estado o puntaje, leer una completa, abrir un archivo que alguien subió, ver cómo suman las respuestas de cada pregunta, buscar respuestas que mencionen algo, exportar a CSV y borrar una o varias respuestas. | | **Analíticas** | Visitas, inicios, completados y abandono por paso, y un resumen corto de cómo va un formulario. | | **Carpetas** | Listar, crear, renombrar y borrar carpetas (sus formularios se quedan), y mover un formulario a una carpeta. | | **Kit de marca** | Leer y editar el logo, los colores y las fuentes del workspace, aplicar el kit de marca a un formulario y devolver un formulario al diseño que tenía antes. | | **Correos** | Leer y editar los correos de notificación del workspace y de cada formulario, y devolverlos a su valor por defecto. | | **Páginas del workspace** | Listar las páginas públicas del workspace, hasta 20, y leerlas, agregarlas, editarlas, renombrarlas, publicarlas, duplicarlas o borrarlas, o volver una la página principal. | | **Integraciones** | Ver qué apps están conectadas (HubSpot, Calendly), los webhooks de un formulario, los campos de HubSpot que una pregunta puede llenar y los eventos de Calendly que un formulario puede agendar, ver qué respuestas se entregaron y cuáles fallaron, elegir a dónde van las respuestas de un formulario (webhooks o HubSpot) y enviar una prueba a un webhook. Conectar o desconectar HubSpot y Calendly se queda en el panel. | | **Cuenta y workspaces** | Ver quién está conectado y en qué workspace, listar los workspaces en los que puedes trabajar, y leer tu página pública y el código de enlace del workspace. | El conector no administra llaves de API, miembros, workspaces, tu perfil, el idioma ni el código de enlace del workspace, y no conecta ni desconecta integraciones. Eso se queda en el panel. ### Acciones que cambian o borran datos Las herramientas de lectura no cambian nada. Las que crean o editan (un formulario nuevo, un cambio en el borrador, una carpeta, un cambio al kit de marca, un correo) cambian datos en tu workspace. Estas herramientas están marcadas como destructivas. Antes de usar una, el agente te dice exactamente qué va a cambiar o a borrarse y espera tu sí: * **Borrar:** `delete_form`, `delete_folder`, `delete_response`, `delete_responses`, `delete_link_page` * **Reemplazar lo publicado o guardado:** `publish_form`, `revert_form`, `discard_draft`, `apply_brand_kit`, `revert_brand_kit`, `reset_notification`, `reset_form_notification`, `update_link_page`, `set_destinations` Borrar no se puede deshacer, igual que en el panel. Mira en [Seguridad y privacidad](/dapta-docs-es/dforms/security-and-privacy.md#borrar-datos) qué se elimina al borrar. > **⚠️ Nota:** Los cambios al kit de marca, los correos de notificación y la prueba de webhook son solo para owners y admins, como en el panel. Un member que los pida recibe un rechazo que lo explica. *** ## Solución de problemas **Inicié sesión pero me rechaza.** La conexión inicia sesión y luego dForms responde que no puede actuar por esa cuenta. Eso significa que dForms todavía no vinculó ese inicio de sesión con un workspace: nunca abriste dForms en la web con esa cuenta, no lo has abierto en los últimos 30 días o no tienes un workspace activo. Abre [app.dforms.ai](https://app.dforms.ai) con esa misma cuenta y vuelve a conectar. Si iniciaste sesión antes del 23 de octubre de 2026, primero cierra sesión y vuelve a entrar. **El agente no ve un workspace.** Abre ese workspace una vez en dForms en la web y vuelve a preguntar. Un workspace del que te quitaron, o donde desactivaron tu miembro, desaparece en la siguiente llamada. **El agente pregunta qué workspace usar.** Es lo esperado cuando tienes varios. Responde con el nombre del workspace. **"Too many writes".** Las escrituras tienen un límite por persona y por workspace. Espera un momento y vuelve a pedirlo. *** ## Privacidad y soporte * [Privacidad del conector MCP](/dapta-docs-es/dforms/developers/mcp-privacy.md): qué puede leer y cambiar el conector, qué registra dForms en cada llamada y cómo desconectarlo. * Soporte, privacidad y reportes de seguridad: . *** ## Qué sigue * [Privacidad del conector MCP](/dapta-docs-es/dforms/developers/mcp-privacy.md) * [Seguridad y privacidad](/dapta-docs-es/dforms/security-and-privacy.md) * [Miembros y roles](/dapta-docs-es/dforms/account/members-and-roles.md) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.dapta.ai/dapta-docs-es/dforms/developers/mcp-connector.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.