Acceder a Datos de Ragic Mediante de MCP

Si no puedes utilizar las siguientes funciones, es posible que esto se deba a tu configuración de acceso a funciones. Ponte en contacto con tu SYSAdmin para comprobar si el permiso "API MCP" está habilitado.

Puedes autorizar a una herramienta de IA de terceros para que lea datos en tu propia cuenta de Ragic usando MCP (Protocolo de Contexto del Modelo). Una vez conectada, puedes pedirle a la IA que busque datos, resuma el contenido, compare registros o responda preguntas sobre tus datos.

Casos de Uso

Una vez conectada, la IA puede ayudarte con lo siguiente. Simplemente pregunte con sus propias palabras, por ejemplo, "Busca 'Contrato Anual'". Consulta Ejemplos de sugerencias para obtener más información.

Función	Descripción
Consultar cuentas de base de datos	Listar las cuentas de base de datos de Ragic a las que puedes acceder
Consultar hojas y campos	Listar las hojas de una cuenta de base de datos, junto con las definiciones de los campos de cada hoja
Búsqueda de texto completo	Busca una palabra clave en toda la cuenta de la base de datos para localizar la hoja y el registro donde se encuentran los datos. Siga las mismas reglas que la búsqueda de texto completo.
Explorar datos de la página de listado	Explora los registros tal como aparecen en la página de listado (solo las columnas de listado), con filtros opcionales por campo, fecha de creación, creador o gestor de registros
Leer registros completos	Lee el contenido completo de los registros, incluidas las subtablas, los comentarios de los registros, los comentarios de los campos y el historial de correo electrónico del registro
Buscar usuarios	Consulta las opciones de usuario disponibles para los filtros "Creador" y "Gestor de registros"
Consultar la documentación para desarrolladores	Lee la documentación para desarrolladores de Ragic (API HTTP y flujo de trabajo JavaScript) para resolver dudas sobre la integración de la API y la creación de scripts de flujo de trabajo

Nota: Actualmente, Ragic MCP solo admite la lectura de datos. La IA puede consultar los datos a los que tienes acceso, pero no puede crearlos, editarlos ni eliminarlos.

Ejemplos de preguntas

Puedes usar Ragic MCP como si hicieras cualquier otra pregunta. Aquí tienes algunos ejemplos comunes:

1. Consulta las cuentas de base de datos disponibles.

• "Enumere las cuentas de base de datos de Ragic a las que puedo acceder."
• "¿Qué cuentas de Ragic puedo consultar?"

2. Ver hojas

• "¿Qué hojas hay en esta cuenta?"
• "¿Qué campos hay en la hoja de Cliente?"

3. Buscar datos

• "Buscar 'contrato anual'."
• "Buscar registros que mencionen 'devolución'."
• "No estoy seguro de en qué hoja de cálculo se encuentra. Buscar cualquier cosa relacionada con la logística de Taipéi."

4. Leer y organizar registros

• "Liste los primeros 20 registros en la hoja de Clientes."
• "Resuma todos los detalles de los pedidos que acaba de encontrar."
• "Compare los tres registros de clientes que encontró."

5. Consultar por persona o fecha

• "Liste los pedidos creados por jane@example.com."
• "Encuentre los clientes gestionados por John Smith."
• "Liste los registros creados en enero de 2026."

Nota: Si solo recuerdas el nombre de alguien y no estás seguro de su correo electrónico, primero puedes pedirle a la IA que encuentre a la persona correspondiente y luego usar ese correo electrónico para continuar la búsqueda.

Ámbito de acceso de MCP

Ragic MCP lee los datos según los derechos de acceso que ya tenga en Ragic:

1. Solo lee y devuelve las cuentas de base de datos, hojas y campos a los que tenga acceso.

2. Si es un usuario externo en una cuenta de base de datos, MCP no leerá ningún dato de ella.

3. Las hojas de configuración internas del sistema de Ragic no son accesibles a través de MCP.

Nota: Siempre que tengas acceso a la hoja o al campo, MCP aún puede leer datos que se hayan ocultado o filtrado, incluidas las hojas ocultas, campos con el atributo oculto, campos y secciones ocultos por formato condicional y datos excluidos por vista fija. Para restringir esto, ajuste el permiso de la API de MCP en configuración de acceso a funciones.

Conectar a Ragic MCP

Antes de empezar

Ragic MCP ofrece dos formas de realizar la conexión: una permite la instalación directa, mientras que la otra requiere que configures tú mismo la URL de conexión. Si necesitas realizar la configuración por tu cuenta, completa primero lo siguiente:

1. Identifica tu cuenta de base de datos: Debes saber a qué cuenta de base de datos de Ragic deseas realizar consultas. Puedes obtener esta información a partir de la URL. Por ejemplo, si la URL de tu página de inicio de Ragic es:

https://www.ragic.com/tunombredecuenta

Luego, "tunombredecuenta" es el nombre de tu cuenta de base de datos. Una vez conectado, simplemente puedes decirle a la IA: "En la cuenta 'tunombredecuenta', ayúdame a encontrar...". Si no estás seguro de cuál es el nombre de tu cuenta de base de datos, puedes pedirle a la IA que "enumere las cuentas de base de datos de Ragic a las que tengo acceso".

2. Obtén la URL de conexión:

Si utilizas un servicio en la nube:

https://www.ragic.com/api/mcp

Si utilizas un plan local (on-premises), consulta con tu administrador para obtener la URL correcta, que suele ser:

https://your-server-address/api/mcp

Connecting in claude.ai

1. Servicio en la nube

Si utilizas el servicio en la nube de Ragic, Ragic MCP ya aparece en el directorio de conectores de Claude, por lo que puedes instalarlo directamente sin necesidad de introducir tú mismo una URL de conexión.

Nota: En un plan Business de claude.ai, un administrador puede añadir el conector directamente, o bien un usuario puede solicitarlo para que un administrador lo apruebe; en cualquier caso, Ragic MCP no se puede instalar hasta que un administrador lo añada o lo apruebe. En un plan Personal, puedes realizar la conexión directamente siguiendo los pasos que se indican a continuación.

Pasos:

1. Ve a la página del conector de Ragic o dirígete a Configuración, entra en la sección Conectores (dentro de Personalizar) y busca Ragic.

2. Haz clic en Conectar con Claude para iniciar la configuración.

3. Sigue las indicaciones para iniciar sesión en Ragic y completar la autorización. La conexión ha quedado establecida.

2. Plan On-premise

Si utilizas un plan On-premise, Ragic no aparecerá en el directorio de conectores. En su lugar, añádelo mediante un conector personalizado.

Nota: En un plan Business de claude.ai, solo un administrador puede añadir un conector y, posteriormente, conceder acceso a usuarios individuales. En un plan Personal, puedes realizar la conexión directamente siguiendo los pasos que se indican a continuación.

Pasos:

1. Abre la página de configuración «Personalizar» en claude.ai.

2. Añada un "conector personalizado" en Conectores.

3. Introduce "Ragic" como nombre.

4. Introduce la URL de conexión proporcionada por tu administrador para tu servidor local (generalmente https://tu-dirección-de-servidor/api/mcp).

5. Selecciona OAuth como método de autenticación o sigue la configuración predeterminada que aparece en pantalla.

6. Guarda los cambios y, a continuación, sigue las instrucciones para iniciar sesión en Ragic y completar la autorización. La conexión quedará establecida.

Conectar a ChatGPT

1. Servicio en la Nube

Si utilizas el servicio en la nube de Ragic, Ragic MCP ya aparece en el directorio de plugins de ChatGPT; por lo tanto, puedes buscarlo e instalarlo directamente sin necesidad de introducir tú mismo una URL de conexión.

Nota: En el plan Business de ChatGPT, un administrador puede añadir el plugin directamente, o bien un usuario puede solicitarlo y esperar a que un administrador lo apruebe; en cualquier caso, Ragic MCP no aparecerá en las búsquedas ni podrá instalarse hasta que un administrador lo añada o lo apruebe. En un plan Personal, puedes realizar la conexión directamente siguiendo los pasos que se indican a continuación.

Pasos:

1. Ve a la página del plugin de Ragic, o haz clic en Plugins en la barra lateral izquierda de ChatGPT y busca «Ragic».

2. Haz clic en el + a la derecha para comenzar a conectar.

3. Sigue las indicaciones para iniciar sesión en Ragic y completar la autorización. La conexión quedará establecida.

4. Selecciona este complemento de Ragic en un chat; a partir de ese momento, podrás pedirle a ChatGPT que lea tus datos de Ragic.

2. Plan On-premise

Si utilizas un plan local (On-premises), emplea el modo desarrollador para añadir el plugin manualmente.

Nota: En el plan Business de ChatGPT, un plugin solo puede ser añadido por un administrador, quien posteriormente otorga acceso a los usuarios individuales. En un plan Personal, puedes realizar la conexión directamente siguiendo los pasos que se indican a continuación.

Pasos:

1. Abre la configuración de ChatGPT.

2. Ve a la configuración de complementos y activa el Modo de desarrollador.

3. Vuelve a la configuración de complementos y haz clic en Explorar complementos, luego haz clic en el ícono +

4. Introduce "Ragic" como nombre.

5. Introduce la URL de conexión local proporcionada por tu administrador (normalmente https://your-server-address/api/mcp).

6. Elige OAuth como método de autenticación.

7. Después de guardar, sigue las instrucciones para iniciar sesión en Ragic y completar la autorización.

8. Selecciona esta aplicación de Ragic en un chat y podrás pedirle a ChatGPT que lea tus datos de Ragic.

Nota: El punto de acceso al modo de desarrollador puede variar según la interfaz de OpenAI. Si no ves la opción para acceder al modo de desarrollador o para añadir un complemento, revisa el plan de tu cuenta y la configuración de tu organización.

Verificación en dos pasos (2FA) durante el inicio de sesión

El inicio de sesión OAuth que se utiliza al conectarse a través de MCP sigue las mismas reglas de verificación en dos pasos que el inicio de sesión en el sitio web de Ragic: si su cuenta tiene habilitada la verificación en dos pasos (código de verificación por correo electrónico o aplicación de autenticación), la página de inicio de sesión muestra una solicitud de código de verificación después de que ingrese su contraseña. Con el método de correo electrónico, el código se envía automáticamente y puede reenviarse.

Después de la verificación, se le redirigirá a la página de consentimiento; una vez que haga clic en Permitir, la herramienta de IA podrá comenzar a leer sus datos.

Nota:

1. Introducir el código incorrecto demasiadas veces bloquea temporalmente la cuenta, al igual que ocurre al iniciar sesión en la página web.

2. Al iniciar sesión con una cuenta de Google, el proceso se completa mediante el sistema de verificación de Google; Ragic no solicita ningún código adicional.

Configuración avanzada: Claude Code / Codex

Si utilizas herramientas de desarrollo como Claude Code o Codex, también puedes conectarte a Ragic MCP. Esta sección está dirigida a usuarios familiarizados con la línea de comandos o los archivos de configuración.

Servicio en la nube

Si utilizas el servicio en la nube, puedes añadir el servidor MCP remoto directamente desde tu terminal.

Claude Code:

claude mcp add --transport http --scope user ragic https://www.ragic.com/api/mcp

Una vez agregado, escribe lo siguiente en la ventana interactiva de Claude Code:

/mcp

Sigue las instrucciones para completar el inicio de sesión y la autorización de Ragic.

Codex: Esto escribirá en tu archivo de usuario ~/.codex/config.toml:

codex mcp add ragic --url https://www.ragic.com/api/mcp

A continuación, siga el flujo de inicio de sesión de Codex para completar la autorización.

Plan local

Si utiliza un plan local sin un certificado de CA de confianza, o si su entorno solo admite conexiones MCP mediante comandos locales, deberá conectarse utilizando mcp-remote en su lugar; además, deberá instalar Node.js, npm y npx previamente.

Si npm o npx no están instalados en tu ordenador, primero descarga e instala la versión LTS desde el sitio web oficial de Node.js; npm se instalará junto con Node.js. Una vez instalado, vuelve a abrir la terminal y ejecuta los siguientes comandos para verificar:

node -v
npm -v
npx -v

Una vez que los tres comandos muestren un número de versión, puede usar la configuración que se describe a continuación. Al ejecutar npx -y mcp-remote, el sistema descargará automáticamente mcp-remote la primera vez; no se requiere ninguna instalación adicional.

Código de Claude: En el archivo .mcp.json de tu proyecto, puedes cambiar a mcp-remote en su lugar:

claude mcp add ragic --scope user -e NODE_TLS_REJECT_UNAUTHORIZED=0 -- npx -y mcp-remote https://localhost/api/mcp --allow-http

Reemplaza https://localhost/api/mcp con tu URL de conexión de Ragic MCP real.

Codex: Puedes cambiar a mcp-remote de esta manera:

codex mcp add ragic --env NODE_TLS_REJECT_UNAUTHORIZED=0 -- npx -y mcp-remote https://localhost/api/mcp --allow-http

Reemplaza https://localhost/api/mcp con tu URL de conexión de Ragic MCP real.

Nota: mcp-remote no tiene función de cierre de sesión. Si necesita cambiar de cuenta o iniciar sesión nuevamente, primero elimine manualmente los datos de autenticación locales y luego reinicia Claude Code o Codex; se le redirigirá al flujo de inicio de sesión de Ragic.

Mac:

rm -rf ~/.mcp-auth

Windows:

1. PowerShell:

Remove-Item "$HOME\.mcp-auth" -Recurse -Force

2. cmd:

rmdir /s /q "%USERPROFILE%\.mcp-auth"

Configuración de Conexión Local

Si tienes un plan on-premise, consulta primero con tu administrador lo siguiente:

• Si Ragic MCP está habilitado. Consulta aquí para obtener instrucciones sobre cómo habilitarlo.
• La URL de conexión correcta.
• Si el servicio de IA que está utilizando puedes acceder a esa URL.
• Si el certificado HTTPS es válido.

Si utilizas una IA basada en web como claude.ai o chatgpt.com, la conexión a tu URL de Ragic MCP se realiza a través del servicio en la nube, no directamente desde tu navegador. Por lo tanto, no necesitas configurar por separado los orígenes de navegador permitidos. El servicio en la nube no requiere configuración adicional; el plan local solo necesita que la URL sea accesible desde servicios externos.

FAQ

1. ¿Cómo inicio sesión la primera vez que me conecto?

La primera vez que te conectes, el servicio de IA te guiará a través del proceso de inicio de sesión de Ragic. Inicia sesión con tu cuenta de Ragic; si tu empresa admite el inicio de sesión con Google, también puedes usarlo. Una vez que hayas iniciado sesión, la IA podrá leer los datos según tus permisos de acceso.

2. ¿Puede la IA modificar mis datos?

No. Actualmente, Ragic MCP solo permite leer datos. La IA puede consultar los datos a los que tienes acceso, pero no puede crear, editar ni eliminar nada. Si en el futuro se incorporan otras funcionalidades, proporcionaremos información detallada sobre la autorización y los límites de uso.

3. ¿Qué ocurre si no encuentro mis datos?

Verifique lo siguiente:

• Si el nombre de la cuenta de la base de datos es correcto.
• Si ya tiene acceso a esa hoja o registro en Ragic.
• Si su palabra clave de búsqueda es demasiado específica.
• Si sus filtros de fecha o persona son demasiado estrictos.

Si no está seguro de en qué hoja se encuentran los datos, intente primero pedirle a la IA que busque por palabra clave.

4. ¿Por qué faltan algunos campos?

MCP lee los datos según tus permisos de acceso en Ragic. Si no tienes acceso a un campo en Ragic, la IA tampoco lo verá.

5. ¿Qué ocurre si una IA web no puede conectarse a mi servidor local?

Contacta con tu administrador para comprobar lo siguiente:

• Si la URL de conexión es correcta.
• Si el servidor local es accesible desde servicios externos.
• Si el certificado HTTPS es válido.