--- title: "Configuración del cliente" description: "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." canonical_url: "https://getminds.ai/mcp/es/setup" last_updated: "2026-10-01T15:17:15.139Z" --- # Configuración del cliente Todos los clientes siguientes ven las mismas 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](/mcp/overview) 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](https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt). 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](/guide/integration-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 Team 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): ```json { "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](/mcp/tools). 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) ```bash 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: ```bash 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`: ```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`. ## Cursor 1. Añade el servidor a `~/.cursor/mcp.json`, o a `.cursor/mcp.json` en un proyecto: ```json { "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`: ```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`: ```json { "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](https://developers.openai.com/api/docs/guides/tools-connectors-mcp). ### 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](/settings/api-keys) 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. ```python 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](/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. ## OAuth Discovery Para desarrolladores que construyan integraciones MCP, los metadatos OAuth están disponibles en:
Endpoint Descripción
/.well-known/oauth-protected-resource Metadatos del recurso protegido (RFC 9728)
/.well-known/oauth-authorization-server Metadatos del authorization server (RFC 8414)
/oauth/register Dynamic 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](/guide/integration-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.