Retool MCP

Puedes conectarte al servidor MCP de Retool directamente desde tu entorno de codificación. El MCP de Retool te permite crear apps desde tu entorno de desarrollo elegido, importar apps de React a Retool y gestionar la configuración y los usuarios de tu organización.

[!-secondary] -secondary nota

El servidor MCP proporciona acceso a la funcionalidad de Retool en un entorno externo. Esta funcionalidad es distinta del recurso MCP, que te permite conectar herramientas y servicios de terceros como una integración nativa en apps clásicas, flujos de trabajo y agentes.

Consulta la referencia de herramientas MCP para obtener la lista completa de herramientas.

Características

El servidor MCP proporciona las siguientes características clave:

• La capacidad de gestionar organizaciones y usuarios mediante una lista de herramientas predefinidas.
• Autenticación mediante OAuth 2.0.
• Transporte HTTP transmisible.

Casos de uso

Los siguientes casos de uso son ejemplos de lo que se puede lograr con el servidor MCP:

Para obtener una lista completa de las herramientas disponibles, consulta la referencia de herramientas MCP, o instala el servidor MCP y ejecuta tools/list.

Conectar el servidor MCP

Puedes conectar el servidor MCP de Retool a un cliente compatible con MCP utilizando los siguientes detalles:

• URL: https://<your-retool-instance>/mcp (p. ej., https://example.retool.com/mcp)
• Transporte: HTTP
• Autenticación: OAuth 2.0

Una vez que autentiques tu servidor MCP con OAuth 2.0, es posible que debas reiniciar tu agente de codificación.

Agentes de codificación comunes

Los siguientes ejemplos muestran cómo conectarse al servidor MCP con agentes de codificación comunes.

[!-info] -info Retool Agents

Para configurar el servidor MCP como una herramienta para usar en Retool Agents, completa los siguientes pasos:

1. Navega a la pestaña Recursos en Retool. Haz clic en Crear nuevo > Recurso y selecciona Servidor MCP.
2. Configura el recurso:
3. Título: Retool MCP 2. Descripción: An MCP server for interacting with Retool. 3. URL del servidor: https://example.retool.com/mcp 4. Haz clic en Configurar autenticación automáticamente. 5. Desplázate hacia abajo y haz clic en Conectar con OAuth.
4. Navega a un agente nuevo o existente y agrega una nueva herramienta.
5. Haz clic en Agregar nueva herramienta. 2. Selecciona Conectar al servidor MCP. 3. En el menú desplegable, selecciona el servidor MCP que creaste en el paso anterior. 4. Haz clic en Guardar.
6. Prueba tu agente desde la pestaña Chat.

[!-info] -info Claude

Para configurar el servidor MCP para Claude Code, completa los siguientes pasos:

1. Desde tu terminal, ejecuta el siguiente comando:

claude mcp add --transport http retool https://example.retool.com/mcp

2. Sal de tu sesión de Claude Code e inicia una nueva sesión.
3. Ejecuta /mcp y selecciona el servidor MCP retool, que requiere autenticación. Se abre una ventana del navegador y te pide que selecciones los ámbitos deseados.
4. Autentícate y regresa a Claude Code. El servidor MCP está listo para usar.

[!-info] -info ChatGPT

[!-secondary] -secondary nota

Debes tener el modo Desarrollador habilitado en ChatGPT para poder agregar el servidor MCP de Retool.

Para configurar el servidor MCP para ChatGPT, sigue los siguientes pasos:

1. En ChatGPT, navega a Configuración > Apps.
2. En la sección Configuración avanzada, haz clic en Crear app.
3. Ingresa la siguiente información:
4. Nombre: Retool 2. URL del servidor MCP: https://example.retool.com/mcp 3. Autenticación: OAuth
5. Haz clic en Crear. Se abre una ventana del navegador para el consentimiento de OAuth.
6. Autoriza los ámbitos solicitados y regresa a ChatGPT.

[!-info] -info Codex

Para configurar el servidor MCP mediante la CLI para Codex, completa los siguientes pasos:

1. Desde tu terminal, ejecuta el siguiente comando:

codex mcp add retool --url https://example.retool.com/mcp

2. Se abre una ventana del navegador y te pide que selecciones los ámbitos deseados.
3. Autentícate y regresa a Codex. El MCP está listo para usar.

[!-info] -info Cursor

Para configurar el servidor MCP en Cursor, completa los siguientes pasos:

1. Abre Configuración > MCP (o edita .cursor/mcp.json en la raíz de tu proyecto). Agrega tu servidor MCP de Retool:

{
"mcpServers": {
   "retool": {
      "type": "http",
      "url": "https://example.retool.com/mcp"
   },
   ...otros servidores MCP
}
}

2. Reinicia Cursor. El flujo de OAuth se activa automáticamente cuando se invoca una herramienta por primera vez.

[!-info] -info Kiro

Para configurar el servidor MCP para la CLI de Kiro, completa los siguientes pasos:

1. Desde tu terminal, ejecuta el siguiente comando:

kiro-cli mcp add --name "Retool" --scope global --url "https://example.retool.com/mcp"

2. Sal de tu sesión de la CLI de Kiro e inicia una nueva sesión.
3. Ejecuta /mcp y selecciona el MCP retool, que necesita autenticación. Haz clic en el enlace para redirigir a la autenticación de OAuth.
4. Selecciona los ámbitos deseados y haz clic en Autorizar.
5. Regresa a la CLI de Kiro. El MCP está listo para usar.

Servidor MCP para instancias autoalojadas

El servidor MCP de Retool está disponible para instancias autoalojadas que usen la versión 4.0.0 y posteriores. El servidor MCP tiene los mismos requisitos que la nueva experiencia de creación de apps.

Consulta los tutoriales para configurar la infraestructura autoalojada por primera vez, o las guías de actualización para configurar tu instancia para la versión más reciente.