Minds Team

Configuración del cliente

Configura el servidor Minds MCP con ChatGPT, Claude, Claude Code, Codex, Gemini CLI, Cursor, VS Code, Windsurf, OpenRouter, Open WebUI y autenticación por API key.

Todos los clientes siguientes ven las mismas 31 herramientas anunciadas, según los datos del servidor en vivo. La respuesta tools/list del servidor conectado es la referencia.

Esta guía conecta el servidor Minds MCP para investigación de mercado con los clientes de IA que admiten herramientas remotas. Usa https://getminds.ai/mcp como URL del servidor.

ChatGPT

Usa ChatGPT en la web. La disponibilidad y los permisos dependen de la cuenta y del espacio de trabajo; consulta las instrucciones MCP actuales de OpenAI.

  1. Abre Plugins y elige Add → Create MCP App. Si falta la opción, activa el modo desarrollador o pide al administrador de tu espacio de trabajo que permita apps MCP propias.
  2. Ponle el nombre Minds, introduce https://getminds.ai/mcp en Server URL, elige OAuth en Authentication, confirma el aviso de riesgo y haz clic en Create.
  3. Haz clic en Continue to Minds, inicia sesión en tu cuenta de Minds y elige Allow.
  4. En una conversación nueva, escribe @Minds y pide la lista de tus Audiences. Las Studies más amplias requieren revisión y confirmación explícita antes de ejecutarse.

Si Minds aparece en el directorio de plugins de tu cuenta, también puedes añadirlo desde Plugins e iniciar sesión de la misma forma.

En la app de escritorio de ChatGPT, abre Plugins y elige Add → Add MCP server. Selecciona el tipo Streamable HTTP e introduce la URL https://getminds.ai/mcp, haz clic en Save, luego en Restart, y elige Authenticate para iniciar sesión en Minds.

La guía de configuración de ChatGPT muestra cada pantalla, incluidas las opciones del directorio de plugins y de la app de escritorio.

Los hosts web compatibles muestran resultados en la conversación. En un host móvil, el widget ofrece un enlace para continuar en Minds en lugar de controles interactivos.

Claude (claude.ai y Claude Desktop)

Conector remoto (widgets según el cliente)

Los conectores personalizados funcionan igual en claude.ai y en Claude Desktop, y se sincronizan entre ambos.

  1. Abre Customize → Connectors, haz clic en + y elige Add custom connector
  2. Introduce https://getminds.ai/mcp como URL del servidor MCP remoto y haz clic en Add
  3. Haz clic en Connect, inicia sesión en tu cuenta de Minds y elige Allow
  4. En una conversación, activa Minds desde + → Connectors

En los planes Pro y Enterprise, un propietario añade primero el conector en Organization settings → Connectors; después, cada miembro conecta su propia cuenta de Minds en Customize → Connectors.

Opción B: Local Connector (API key, solo texto)

Añade esto a tu archivo de configuración (~/Library/Application Support/Claude/claude_desktop_config.json en macOS):

{
  "mcpServers": {
    "mindsai": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://getminds.ai/mcp",
        "--header",
        "Authorization: Bearer minds_YOUR_API_KEY"
      ]
    }
  }
}

Reinicia Claude Desktop. Las herramientas funcionan de inmediato, pero los widgets interactivos no están disponibles con local connectors.

Soporte de widgets en Claude

Las herramientas anunciadas devuelven texto estructurado y enlaces clicables para abrir los resultados en la webapp de Minds. El servidor mantiene además otras herramientas canónicas de ciclo de vida invocables para integraciones explícitas; consulta la referencia de herramientas. La presentación de widgets depende del cliente y de su versión, por lo que la integración debe seguir siendo plenamente utilizable solo con resultados estructurados y de texto.

Claude Code (CLI)

claude mcp add --transport http minds https://getminds.ai/mcp

Ejecuta /mcp en Claude Code, selecciona minds y elige Authenticate para iniciar sesión con OAuth. La clave de API es opcional: para usar una, añade --header "Authorization: Bearer minds_YOUR_API_KEY" al comando.

Codex

Con la CLI de Codex:

codex mcp add minds --url https://getminds.ai/mcp
codex mcp login minds

codex mcp login abre la página de inicio de sesión de Minds. Codex se registra con un Client ID Metadata Document, así que no necesitas client ID ni secreto.

En la app de Codex o la extensión para IDE, abre Settings → MCP servers, elige Add server, selecciona Streamable HTTP e introduce https://getminds.ai/mcp. Guarda, reinicia y elige Authenticate.

Para usar una clave de API, define bearer_token_env_var = "MINDS_API_KEY" bajo [mcp_servers.minds] en ~/.codex/config.toml y exporta la clave en esa variable.

Gemini CLI

Añade el servidor a ~/.gemini/settings.json:

{
  "mcpServers": {
    "minds": { "httpUrl": "https://getminds.ai/mcp" }
  }
}

O ejecuta gemini mcp add --transport http minds https://getminds.ai/mcp. Gemini CLI detecta OAuth en el servidor y abre la página de inicio de sesión en el primer uso. También puedes ejecutar /mcp auth minds.

Google Antigravity

Añade el servidor a ~/.gemini/config/mcp_config.json (o a .agents/mcp_config.json en un espacio de trabajo). Antigravity necesita serverUrl; no acepta url ni httpUrl:

{
  "mcpServers": {
    "minds": { "serverUrl": "https://getminds.ai/mcp" }
  }
}

O ejecuta agy mcp add --type http minds https://getminds.ai/mcp. Para iniciar sesión, abre Settings → Customizations, elige Authenticate junto a minds y pega el código que aparece tras iniciar sesión. La instalación del plugin y las claves de API se explican en Minds en Google Antigravity.

Cursor

  1. Añade el servidor a ~/.cursor/mcp.json, o a .cursor/mcp.json en un proyecto:
{
  "mcpServers": {
    "minds": { "url": "https://getminds.ai/mcp" }
  }
}
  1. Autentícate cuando Cursor lo solicite e inicia sesión en Minds.

VS Code (GitHub Copilot)

  1. Ejecuta MCP: Add Server desde la paleta de comandos, elige HTTP e introduce https://getminds.ai/mcp. O añádelo a .vscode/mcp.json:
{
  "servers": {
    "minds": { "type": "http", "url": "https://getminds.ai/mcp" }
  }
}
  1. Inicia el servidor y permite que VS Code inicie sesión en Minds cuando lo solicite. Después, las herramientas de Minds aparecen en Copilot Chat en modo agente.

Windsurf

En el panel de Cascade, abre el menú … y elige Open MCP config file. Añade Minds bajo mcpServers:

{
  "mcpServers": {
    "minds": { "serverUrl": "https://getminds.ai/mcp" }
  }
}

Guarda el archivo e inicia sesión en Minds cuando Windsurf lo solicite. Para usar una clave de API, añade "headers": { "Authorization": "Bearer ${env:MINDS_API_KEY}" } a la entrada.

OpenRouter, Open WebUI y pasarelas compatibles con OpenAI

La autenticación depende del cliente que ejecuta la solicitud MCP y de la credencial que transmite. La clave API del proveedor del modelo no autentica ante Minds.

Transmisión del token OAuth

La API Responses de OpenAI acepta un token OAuth existente en el campo authorization de la herramienta MCP. Tu aplicación gestiona por separado la autorización y la renovación y envía el token en cada solicitud. Consulta la guía de autenticación MCP de OpenAI.

Open WebUI / OpenRouter

Configura una conexión Streamable HTTP a https://getminds.ai/mcp. Si el cliente o modo elegido no puede completar OAuth y transmitir el token, crea una clave Minds en Configuración → Claves API y configura Bearer mediante el almacén seguro del cliente. Prueba con list_audiences. Para OpenRouter y otras pasarelas, verifica su soporte MCP y el formato del descriptor; ser compatible con Chat Completions de OpenAI no garantiza MCP remoto.

Ejemplo de la API Responses de OpenAI

El ejemplo lee una clave API Minds del entorno. Para OAuth, sustituye headers por "authorization": os.environ["MINDS_OAUTH_ACCESS_TOKEN"] después de que tu aplicación obtenga un token Minds válido.

import os
from openai import OpenAI

client = OpenAI()
response = client.responses.create(
    model="gpt-5.2",
    input="List my Audiences",
    tools=[{
        "type": "mcp",
        "server_label": "minds",
        "server_url": "https://getminds.ai/mcp",
        "headers": {"Authorization": f"Bearer {os.environ['MINDS_API_KEY']}"},
        "allowed_tools": ["list_audiences"],
        "require_approval": "never",
    }],
)
print(response.output_text)

Autenticación por API Key

Para acceso programático o clientes que no soportan OAuth:

  1. Ve a Settings → API Keys en Minds
  2. Crea una nueva API key (empieza por minds_)
  3. Pásala como Bearer token: Authorization: Bearer minds_your_key_here

Scopes

Los clientes OAuth solicitan los permisos básicos de OpenID (openid, email, profile) y los scopes de Minds que se indican a continuación. La pantalla de consentimiento de Minds describe cada scope en términos de producto antes de que elijas Allow. Un cliente que no solicita ningún scope los recibe todos.

ScopeAcceso
openidConfirm who you are
emailSee your email address
profileSee your name and profile picture
sparks:readSee your Minds and Audiences
sparks:writeCreate and edit Minds and Audiences
sparks:chatAsk your Minds and Audiences questions
flows:readSee your Studies and their results
flows:writeCreate Studies and run research in them

OAuth Discovery

Para desarrolladores que construyan integraciones MCP, los metadatos OAuth están disponibles en:

EndpointDescripción
/.well-known/oauth-protected-resourceMetadatos del recurso protegido (RFC 9728)
/.well-known/oauth-authorization-serverMetadatos del authorization server (RFC 8414)
/oauth/registerDynamic Client Registration (RFC 7591)

Se requiere OAuth 2.1 con PKCE (S256). Los clientes públicos (token_endpoint_auth_method: "none") están soportados.

Los clientes nativos pueden registrar URIs de redirección loopback (http://127.0.0.1, http://localhost, http://[::1]); el puerto no se compara, así que un cliente puede escuchar en cualquier puerto libre (RFC 8252). Un cliente también puede usar un Client ID Metadata Document: una URL https como client_id que publica sus metadatos (client_id_metadata_document_supported: true). El endpoint de token acepta el client_id en el cuerpo de la solicitud o mediante autenticación HTTP Basic con el secreto vacío.

Resolución de problemas

Error "Authentication required"

Asegúrate de haber completado el flujo de autorización OAuth. Desconecta y vuelve a conectar tu cliente MCP para reautorizar.

Comprueba que el componente que ejecuta MCP transmite una credencial Bearer Minds válida. Reconecta OAuth o renueva el token mediante su cliente propietario; usa una clave API si la integración no transmite tokens OAuth. La clave de un proveedor o iniciar sesión en el host no sustituye una credencial Minds.

«Not authorized» para una Study, Audience o Mind que puedes abrir en Minds

El cliente MCP ha iniciado sesión con una cuenta de Minds distinta de la propietaria del elemento; el error indica la cuenta conectada. Vuelve a conectar el cliente con la cuenta propietaria o comparte el elemento con la cuenta conectada.

OAuth de Claude Desktop no se completa

Si el popup de OAuth se abre pero nunca se completa, prueba el enfoque de API key (Opción B anterior). El OAuth del remote connector de Claude Desktop puede ser intermitente.

Mind not found

Cuando uses mindName, asegúrate de que el nombre coincida estrechamente con tu Mind. El sistema usa fuzzy matching, pero requiere una puntuación de similitud razonable.

El Mind sigue entrenándose

Los Minds nuevos pueden tardar un momento en completar el entrenamiento. Usa get_mind_status para comprobar si el entrenamiento está completo antes de chatear.

Timeout en preguntas de study

Las preguntas de study con muchos audiences pueden tardar más de 2 minutos. Prueba a reducir el número de audiences o a simplificar la pregunta.

La exportación PDF no está lista

Las exportaciones son asíncronas. Consulta get_study_status con la misma studyId y los valores exactos exportKind, exportFormat y exportJobId devueltos por export_study. Comprueba el estado del trabajo y la URL de descarga; la duración varía. Un timeout de consulta no autoriza una exportación duplicada.

Los resultados siguen cargando o parecen incompletos

Los widgets reciben actualizaciones del host y consultan el estado automáticamente durante un periodo limitado cuando el host lo permite. Esto no garantiza streaming continuo de tokens. En otros casos, usa Actualizar si aparece, pide el estado de la Study existente o sigue el enlace Minds devuelto.

Usa get_study_status para una pregunta directa y get_study_run para un plan confirmado. Conserva el mismo studyId; una carga o un timeout no justifica ejecutar de nuevo. Indica las respuestas parciales y la cobertura incompleta. Que las preguntas estén cerradas no demuestra que cada Mind haya respondido.

Flujos de trabajo de n8n

Utilice el nodo de la comunidad Minds para n8n para crear Estudios, previsualizar planes de investigación, recuperar Estudios y resúmenes guardados, o exponer una operación a un Agente de IA. Instale n8n-nodes-minds en n8n autohospedado y conecte una clave API de Minds. El paquete está publicado en npm; la verificación de n8n está bajo revisión, por lo que aún no está disponible en n8n Cloud. Revise e inicie la investigación por separado en Minds.

Minds© 2026 Minds. Tu audiencia objetivo. Impulsada por IA y fundamentada en evidencia transparente. Lista en minutos.
Minds forma parte de
ESOMARGreenBookInsight PlatformsCapterraG2CSSDA Best UX Design AwardCSSDA Best Innovation AwardCSSDA Best UI Design Award