Ir al contenido
Conector MCP

Conecta tu agente de IA a Panelia

Lanza un estudio de mercado sintético desde Claude, Cursor o cualquier cliente compatible con MCP, y obtén resultados calibrados sin salir de tu conversación. Nada que instalar: basta una URL.

Model Context Protocol es el estándar abierto que conecta un asistente de IA con tus herramientas. Panelia se integra con una sola dirección, mediante una autorización que concedes —y retiras— desde tu panel. Incluido en todos los planes, desde el Gratuito.

Conectarse

El conector está alojado por Panelia. No hay paquete que instalar, ni archivo que compilar, ni clave que copiar: tu cliente MCP averigua solo cómo autenticarse.

Dirección del conector
https://www.panelia.io/api/mcp
  1. 01

    Pegar la dirección

    Añade esta URL como servidor MCP remoto en tu cliente.

  2. 02

    Iniciar sesión

    El cliente abre Panelia en tu navegador. Inicias sesión con normalidad, como en la web.

  3. 03

    Autorizar

    Eliges la organización y los permisos concedidos. Puedes quitar alguno antes de confirmar.

  4. 04

    Usarlo

    El agente ya dispone de las herramientas. La autorización sigue siendo revocable en cualquier momento desde esta página.

Lo que sabe hacer el conector

Cada herramienta se ejecuta dentro de Panelia, con tus permisos y tus cuotas: exactamente como si actuaras desde la interfaz.

  • panelia_list_panelsLectura

    Lista los mercados simulables y los arquetipos de audiencia, con el dominio de edad real de cada mercado.

  • panelia_create_studyEscritura

    Crea y lanza un estudio en una sola llamada. Reserva créditos; acepta una clave de idempotencia para que un reintento no relance nada.

  • panelia_list_studiesLectura

    Lista los estudios de la organización, del más reciente al más antiguo, con el estado de su última ejecución.

  • panelia_get_studyLectura

    Estado y avance de un estudio. Los resultados se incluyen en cuanto la ejecución termina.

  • panelia_get_resultsLectura

    Agregados de la última ejecución terminada: distribución Likert, intervalos de confianza, segmentos, motores y frenos, verbatims.

  • panelia_export_resultsLectura

    Exportación JSON íntegra: la definición del estudio y su informe completo, para archivado o análisis posterior.

  • panelia_create_checkout_linkEscritura

    Genera un enlace de pago Stripe para recargar créditos o suscribir un plan. No cobra nada por sí mismo.

Recorrido típico

Un estudio es asíncrono: nada espera el resultado en línea. El agente lanza y después consulta.

  1. panelia_list_panels — elegir un mercado válido
  2. panelia_create_study — respuesta inmediata: identificador, estado QUEUED, créditos reservados
  3. panelia_get_study — repetir hasta el estado COMPLETED
  4. panelia_get_results — leer los agregados y exportar si hace falta
panelia_create_study
{
  "title": "Sérum Vitamine C",
  "type": "PRODUCT",
  "market": {
    "country": "FR",
    "audience": "representative"
  },
  "panelSize": 500,
  "engine": "standard",
  "concepts": [
    {
      "label": "A",
      "title": "Sérum Vit. C 30 ml",
      "description": "Concentré 15 %, flacon verre ambré",
      "price": 24.9,
      "category": "cosmétique"
    }
  ],
  "idempotencyKey": "serum-vitc-2026-08"
}

Declarar el conector

Según el cliente, la dirección se declara en un archivo de configuración o mediante un comando. En ambos casos no contiene ningún secreto.

Claude Desktop y Cursor

Añade el conector a la configuración de tu cliente.

claude_desktop_config.json
{
  "mcpServers": {
    "panelia": {
      "url": "https://www.panelia.io/api/mcp"
    }
  }
}

Claude Code

Basta con un único comando.

shell
claude mcp add --transport http panelia https://www.panelia.io/api/mcp

Cursor: misma estructura JSON, en .cursor/mcp.json en la raíz del proyecto.

Descubrimiento automático

Tu cliente consulta estas direcciones para saber cómo autenticarse. Normalmente nunca tendrás que escribirlas.

https://www.panelia.io/.well-known/oauth-protected-resourcehttps://www.panelia.io/.well-known/oauth-authorization-server

Lo que autorizas

Al conectarte eliges la organización y los permisos concedidos. Cada uno se puede desmarcar.

  • studies:read

    Leer tus estudios, su estado y sus resultados. Concedido por defecto.

  • studies:write

    Crear y lanzar estudios. Consume créditos.

  • billing:manage

    Generar un enlace de pago para recargar créditos o cambiar de plan. No cobra nada por sí mismo.

Tu rol sigue siendo el límite

Una autorización nunca puede conceder más de lo que tu rol ya permite. Un lector que autorice la escritura seguirá sin poder lanzar estudios: se aplica la intersección de ambos, nunca uno u otro.

Multilingüe: dos idiomas que no hay que confundir

Idioma de la interfaz

El de las descripciones de herramientas y los mensajes de error del conector. Sigue el idioma de tu perfil de Panelia: no hay nada que configurar en el cliente.

Idioma del estudio

El de los encuestados sintéticos. Se deriva del mercado simulado, y solo de él: los personas se llaman y responden en el idioma y la cultura de su mercado.

Mercados simulables

FRDEESITGBUSCA_ENCA_FR

Arquetipos de audiencia

representativemenwomenb2b

Seguridad

  • Autorización OAuth 2.1

    El cliente nunca ve tu contraseña. Inicias sesión en Panelia y el token emitido queda ligado a este conector y a ningún otro.

  • Ningún secreto que manejar

    No hay clave que copiar ni archivo que proteger. Nada sensible queda en un archivo de configuración.

  • Revocación inmediata

    Retirar una autorización corta el acceso al instante, sin esperar a que caduque ningún token.

  • Una organización a la vez

    Un token vale para la organización que elegiste al consentir. No abre ninguna otra, aunque pertenezcas a ella.

  • Operaciones facturadas

    Lanzar un estudio consume créditos. Las herramientas implicadas están anotadas para que tu cliente pida confirmación.

  • Cuotas del plan

    El conector aplica exactamente los mismos límites que la interfaz: créditos, conceptos comparados, estudios en cartera. No abre ningún atajo.

Un estudio de mercado, desde tu agente de IA

Describe un concepto: el agente lanza el panel y vuelve con una distribución calibrada de intención de compra.