Servidor MCP de FluoTest

FluoTest tiene un servidor MCP (Model Context Protocol) remoto, así que asistentes de IA como Claude y ChatGPT pueden gestionar los quizzes de tu cuenta: listarlos, crearlos y editarlos (incluida la puntuación, los resultados y la configuración), publicarlos, leer los resultados y eliminarlos cuando se lo pidas, siempre por nombre, nunca buscando un UUID. Las conexiones se autorizan con OAuth (apruebas el acceso en una pantalla de consentimiento) o con una clave API personal generada en Ajustes.

Última actualización

¿Cómo conecto un asistente de IA a FluoTest?

En ChatGPT, añade el plugin de FluoTest desde el directorio de plugins de ChatGPT e inicia sesión. En Claude, lo más rápido es el directorio de conectores de Claude (claude.ai/directory/fluotest): haz clic en Add e inicia sesión. En cualquier otro cliente MCP, añade https://fluotest.com/api/mcp manualmente como servidor MCP remoto: con OAuth inicias sesión en FluoTest y apruebas el acceso en una pantalla de consentimiento, o generas una clave API en Ajustes → Seguridad → Claves API y la envías como token Bearer.

URL del servidor#

El servidor MCP está en una única URL:

https://fluotest.com/api/mcp

Usa el transporte Streamable HTTP. Todas las solicitudes deben estar autenticadas; las solicitudes sin autenticar reciben una respuesta 401 que indica a los clientes MCP dónde iniciar el flujo OAuth.

Autenticación#

Hay dos formas de autenticarse. Ambas actúan como tu cuenta de usuario: el asistente solo puede ver y crear lo que tú puedes.

  • OAuth 2.1 (recomendado): Compatible con los conectores personalizados de Claude y otros clientes MCP con soporte OAuth. Inicias sesión en FluoTest en el navegador y apruebas el acceso en una pantalla de consentimiento, sin claves que copiar, y mantienes el control de lo que está conectado.
  • Clave API: Para clientes MCP que aceptan cabeceras personalizadas (como Claude Code) o tus propios scripts. Genera una clave en Ajustes → Seguridad → Claves API y envíala como "Authorization: Bearer fluo_…". Trátala como una contraseña.

Referencia completa de la API: claves, cabeceras y ejemplos con curl →

Conectar ChatGPT#

Lo más fácil: el plugin de FluoTest para ChatGPT

FluoTest aparece en el directorio de plugins de ChatGPT. Abre la ficha, añádelo e inicia sesión en FluoTest para aprobar el acceso: FluoTest en el directorio de plugins de ChatGPT

Una vez añadido, ChatGPT usa las mismas herramientas que aparecen en Herramientas disponibles: puede listar, crear, editar y publicar tus quizzes, leer sus resultados y eliminar un quiz cuando se lo pidas. Publicar siempre es un paso aparte, y editar o eliminar un quiz publicado necesita antes tu confirmación. Para otros clientes MCP, sigue los pasos de Claude o de la clave API que aparecen más abajo.

Conectar Claude (OAuth)#

Lo más fácil: el directorio de conectores de Claude

FluoTest aparece en el directorio de conectores de Claude como conector de la comunidad, así que no hay que rellenar ninguna URL ni campo. Abre la ficha y haz clic en Add: claude.ai/directory/fluotest

¿Prefieres añadirlo manualmente o todavía no ves la ficha? En Claude, ve a Settings → Connectors → Add custom connector y rellena:

  1. Nombre: FluoTest
  2. URL del servidor MCP remoto: https://fluotest.com/api/mcp
  3. Haz clic en Add y luego en Connect. Te llevará a fluotest.com para iniciar sesión y aprobar el acceso.

No hay ningún client ID ni secreto que copiar: el conector se registra automáticamente como cliente OAuth público (PKCE, sin secreto) la primera vez que te conectas.

Conectar con una clave API#

Para clientes en los que el flujo OAuth no está disponible:

  1. En FluoTest, abre Ajustes → Seguridad → Claves API.
  2. Escribe un nombre (por ejemplo, "Claude Code") y haz clic en Generar clave.
  3. Copia la clave fluo_… inmediatamente, ya que solo se muestra una vez.
  4. Añádela a tu cliente MCP como cabecera Authorization.

Configuración MCP genérica (para clientes tipo mcp.json):

{
  "mcpServers": {
    "fluotest": {
      "type": "http",
      "url": "https://fluotest.com/api/mcp",
      "headers": {
        "Authorization": "Bearer fluo_YOUR_API_KEY"
      }
    }
  }
}

Claude Code (CLI)

claude mcp add --transport http fluotest https://fluotest.com/api/mcp \
  --header "Authorization: Bearer fluo_YOUR_API_KEY"

Referencia completa de la API: claves, cabeceras y ejemplos con curl →

Herramientas disponibles#

El servidor ofrece once herramientas que cubren todo el ciclo de vida de un quiz, desde crear una evaluación con puntuación hasta leer sus resultados. Todas las herramientas identifican un quiz por título, slug o ID, así que un asistente nunca necesita que pegues un UUID. Los quizzes compartidos contigo en un espacio de trabajo en equipo también funcionan, con los mismos permisos de visualización o edición que tienes en el panel.

Algunos ajustes dependen del plan del propietario del espacio de trabajo, igual que en el panel: el email de recordatorio para quizzes sin terminar (abandoned_email_*, desactivado por defecto) necesita Business, y las vistas previas de enlace personalizadas (og_title, og_description) necesitan Pro. Todo lo demás, incluidas las categorías de puntuación, los resultados, el formulario de contacto y el email de resultados, funciona en todos los planes.

  • list_quizzes: Lista los quizzes que puedes ver: los tuyos y los de los espacios de trabajo en equipo de los que formas parte, con título, ID, slug, estado de borrador o publicado, número de respuestas, fecha de creación, espacio de trabajo y si puedes editarlo. Un asistente la llama primero para encontrar un quiz que mencionas por su nombre.
  • create_quiz: Crea un quiz en borrador con una sola llamada, incluida una evaluación completa con puntuación: secciones, todos los tipos de pregunta con texto de ayuda, categorías de puntuación con sus propios rangos, secciones que puntúan en una categoría o que no puntúan, reglas de visibilidad y de salto, resultados que apuntan a respuestas por su etiqueta, y configuración del quiz como el formulario de contacto antes del resultado, una pantalla de resultado solo con confirmación, el email de resultados, el idioma, los textos y el tema. Devuelve los ID de las nuevas secciones, preguntas y opciones, además de avisos, por ejemplo sobre un rango que nadie puede alcanzar. El quiz sigue sin publicar hasta que lo publiques.
  • get_quiz_questions: Devuelve la estructura completa y la puntuación de un quiz con los mismos nombres de campo que usa create_quiz: secciones, preguntas con texto de ayuda, opciones con sus puntos por categoría, reglas de visibilidad y de salto, categorías de puntuación y rangos, cada resultado con sus reglas y acciones, y los avisos del mapa de puntuación. Los asistentes la usan para revisar su trabajo y obtener los ID para editar.
  • get_quiz_settings: Devuelve toda la configuración de un quiz: enlace público, páginas de bienvenida y de agradecimiento, lo que ven los encuestados después de enviar, el formulario de contacto, el email de resultados y de dónde sale su dirección, las notificaciones al propietario, la programación y otras opciones, el idioma y los textos personalizados, el tema, y las integraciones activadas para el quiz con su disparador, mapeo de campos y última entrega. Las integraciones son de solo lectura y nunca incluyen URLs ni claves.
  • update_quiz: Edita un quiz: cualquier campo que acepte create_quiz, además del slug. Las preguntas se pueden reemplazar o editar directamente con operaciones que añaden, editan, mueven o eliminan preguntas y secciones conservando sus ID, para que las reglas de resultados y las respuestas anteriores sigan vinculadas. Un reemplazo completo que haría perder reglas, texto de ayuda o puntuaciones por categoría pide confirmación primero, y si falla cualquier parte de una edición, el quiz queda como estaba. Editar un quiz publicado necesita confirm_edit_published: true; el primer intento no cambia nada y muestra el número de respuestas y una lista de antes y después de lo que cambiaría.
  • publish_quiz: Publica un quiz en borrador y lo pone en línea en su URL pública, solo cuando se lo pides. Respeta la aprobación de publicación de tu espacio de trabajo y devuelve avisos sobre configuraciones que no funcionarán como se espera, como un email de resultados sin dirección a la que enviarlo.
  • unpublish_quiz: Vuelve a desconectar un quiz publicado. Sus respuestas se conservan y se puede publicar más adelante.
  • import_quiz: Crea un borrador a partir de un documento de quiz de FluoTest: los mismos campos que acepta create_quiz más schema_version 1, con identificadores ref a los que apuntan las reglas de visibilidad, de salto y de resultados. Primero se revisa el documento y no se guarda nada si tiene errores, cada uno indicando la pregunta. Los campos desconocidos se devuelven como avisos, los ajustes exclusivos de Pro que no puedes usar se omiten con un aviso, y todo lo que tenía el quiz de origen que el formato no puede incluir aparece en not_in_file.
  • duplicate_quiz: Copia uno de tus quizzes como un nuevo borrador, con sus preguntas, puntuación, resultados, configuración e integraciones, para que un asistente pueda crear una variante sin tocar el original.
  • get_results: Devuelve el número de respuestas, la puntuación media, mínima y máxima, el recuento por rango, las medias y rangos por categoría de puntuación, el recuento de resultados, y las visitas y la tasa de finalización. Con Pro añade la distribución de respuestas, el NPS, el abandono por pregunta y el tiempo medio. También puede listar las respuestas de la más reciente a la más antigua, filtradas por fecha, puntuación, resultado o contacto, con las puntuaciones, el resultado y las respuestas de cada persona. Los nombres, emails y números de teléfono solo se incluyen cuando pides los datos de contacto.
  • delete_quiz: Elimina definitivamente uno de tus quizzes y sus respuestas. La primera llamada nunca elimina nada: devuelve el título y el número de respuestas para que puedas confirmar, y una segunda llamada con confirm: true lo elimina.

Ejemplo de argumentos de create_quiz: una evaluación con puntuación

{
  "title": "Team health check",
  "score_categories": [
    { "label": "Leadership", "tiers": [{ "label": "Needs work", "min": 0, "max": 49 }, { "label": "Strong", "min": 50, "max": 100 }] },
    { "label": "Culture", "tiers": [{ "label": "Needs work", "min": 0, "max": 49 }, { "label": "Strong", "min": 50, "max": 100 }] }
  ],
  "sections": [
    {
      "title": "About you",
      "scored": false,
      "questions": [
        { "text": "Your name", "type": "name" },
        { "text": "Team size", "type": "multiple_choice", "options": [{ "label": "1-10" }, { "label": "11+" }] }
      ]
    },
    {
      "title": "Leadership",
      "category": "leadership",
      "questions": [
        {
          "text": "Leaders give regular feedback",
          "description": "Think about the last three months.",
          "type": "multiple_choice",
          "options": [
            { "label": "Rarely", "score": 0 },
            { "label": "Sometimes", "score": 1 },
            { "label": "Always", "score": 2 }
          ]
        }
      ]
    },
    {
      "title": "Culture",
      "category": "culture",
      "questions": [{ "text": "People speak up in meetings", "type": "yes_no", "points": 2 }]
    }
  ],
  "contact_gate": { "contact_type": "email", "required": true, "name_required": true, "block_disposable_emails": true },
  "results_display": "confirmation",
  "send_results_email": true,
  "results_email_attach_pdf": true,
  "hidden_fields": ["website"],
  "capture_utm": true
}

Tarjetas en el chat#

En los asistentes compatibles con MCP Apps, como Claude y ChatGPT, list_quizzes, get_results, create_quiz, import_quiz, update_quiz, publish_quiz, unpublish_quiz y duplicate_quiz muestran una tarjeta debajo de la respuesta: tarjetas de quiz con estado, número de respuestas, número de preguntas y botones para abrir el quiz en el editor o su página pública, o una tarjeta de resultados con respuestas, puntuación media, tasa de finalización, niveles de puntuación o resultados finales y las últimas respuestas. Los demás clientes MCP siguen recibiendo los mismos resultados en texto.

Cada una de estas herramientas incluye _meta.ui.resourceUri (y el alias de ChatGPT openai/outputTemplate), que apunta a un recurso ui://fluotest/ servido como text/html;profile=mcp-app. La tarjeta muestra el structuredContent de la herramienta, los mismos datos que el resultado en texto, con tu idioma de FluoTest en el campo locale. Es HTML autónomo que no carga nada de la red, y los datos de contacto de los encuestados solo aparecen cuando los pides (include_contacts).

Tarjetas en el chat

¿Conectaste FluoTest antes de que existieran las tarjetas? Vuelve a conectarlo o actualízalo en los ajustes de conectores o apps de tu asistente para que cargue los nuevos metadatos de las herramientas.

Referencia de endpoints OAuth#

Los clientes MCP los descubren automáticamente a partir de la respuesta 401 del servidor y del documento de descubrimiento; solo los necesitas si un cliente te pide los endpoints explícitamente. Prueba primero la URL de descubrimiento OIDC; resuelve el resto.

EndpointURL
Descubrimiento OIDChttps://abvrtonacdgcxpkkrpie.supabase.co/auth/v1/.well-known/openid-configuration
Autorizaciónhttps://abvrtonacdgcxpkkrpie.supabase.co/auth/v1/oauth/authorize
Tokenhttps://abvrtonacdgcxpkkrpie.supabase.co/auth/v1/oauth/token
JWKShttps://abvrtonacdgcxpkkrpie.supabase.co/auth/v1/.well-known/jwks.json

Preguntas frecuentes#

¿Qué quizzes puede ver un asistente conectado?

Solo los tuyos. Cada llamada a una herramienta se ejecuta como tu cuenta de usuario con las mismas reglas de permisos que la app, así que un asistente no puede leer los quizzes ni los resultados de otros usuarios.

¿Cómo revoco el acceso?

Claves API: revócalas en Ajustes → Seguridad → Claves API y la clave deja de funcionar de inmediato. OAuth: elimina el conector en tu asistente de IA; sus tokens guardados se descartan y no se emiten otros nuevos sin volver a pasar por el consentimiento.

¿Puede publicar quizzes?

Solo cuando se le pide explícitamente. create_quiz siempre crea un borrador sin publicar, y publish_quiz, una herramienta aparte, es el paso deliberado que lo pone en línea. Nada se publica automáticamente.

¿Puede editar o eliminar un quiz que ya está publicado?

Ambas cosas, pero nunca en la primera llamada. El primer intento de update_quiz sobre un quiz publicado se rechaza y te muestra el número de respuestas y una lista de antes y después de lo que cambiaría, sin cambiar nada; solo una segunda llamada con confirm_edit_published: true aplica la edición, y reemplazar preguntas en un quiz publicado también devuelve un aviso de que las respuestas antiguas pueden hacer referencia a preguntas que ya no existen. delete_quiz funciona igual: primero te muestra el título del quiz y el número de respuestas, y solo lo elimina cuando confirmas.

¿El servidor MCP es gratuito?

Sí, está disponible en todos los planes, incluidas las cuentas gratuitas.