Base de conocimientos

Conecte Findrix a su asistente de IA

Una vez conectado, puede preguntarle a su asistente de IA cómo aparece su marca en las respuestas de IA, qué conviene corregir a continuación o pedirle un informe en PDF, y obtendrá la respuesta de su cuenta de Findrix. Con Claude o ChatGPT solo se necesitan unos minutos y no hace falta ninguna clave ni archivo de configuración.

Antes de empezar

  • Una cuenta de Findrix con al menos un sitio en un plan de pago (Presence o superior). Sin él, su asistente solo podrá decirle quién es en Findrix.
  • La aplicación del asistente que quiera usar, con la sesión iniciada. Si su cuenta de Claude pertenece a una empresa (Claude Team o Enterprise), es posible que un propietario tenga que añadir primero Findrix para toda la organización.
  • Unos minutos: aproximadamente dos para Claude, tres para ChatGPT y cinco para Cursor o Codex.

Claude: claude.ai y la aplicación de escritorioRecomendado

La forma más sencilla. Inicia sesión con su cuenta de Findrix, así que no tiene que copiar ninguna clave ni instalar nada. Funciona igual en Mac y Windows, tanto en el navegador como en la aplicación de escritorio de Claude.

Añadir Findrix a Claude

Abre claude.ai con el nombre y la dirección del servidor rellenados. Dirección del servidor:

https://app.findrix.ai/api/mcp
  1. Haga clic en Añadir Findrix a Claude arriba. Claude abre el formulario Add custom connector con el nombre y la dirección del servidor ya rellenados. Si prefiere añadirlo a mano, abra Customize → Connectors → Add custom connector en Claude y pegue la dirección del servidor https://app.findrix.ai/api/mcp.

  2. Si aparece Request headers, déjelo vacío. La mayoría de las cuentas de Claude no tienen esta sección; si la suya no la tiene, omita este paso.

  3. En Authentication, elija Sign in when needed.

  4. En OAuth client, elija Use Claude's published identity. No elija Register automatically: Findrix no lo admite y la conexión falla.

  5. Haga clic en Add.

    Formulario Add custom connector de Claude: Request headers, que solo aparece en algunas cuentas, vacío; Sign in when needed; Use Claude’s published identity; después, Add. Ilustración: su pantalla puede verse un poco diferente.
  6. Abra un chat nuevo y pregunte: Who am I in Findrix, and which sites do I have? Claude le pedirá que conecte Findrix. Haga clic en Connect, inicie sesión en Findrix y, en la pantalla Autorizar el acceso, haga clic en Permitir.

    La pantalla de Findrix que se abre cuando Claude se conecta: deje Hacer cambios por usted: añadir prompts, registrar trabajo y deshacer sus propios cambios marcado para permitir que Claude realice cambios y haga clic en Allow. Ilustración: su pantalla puede verse un poco diferente.

Deje marcada la casilla Hacer cambios por usted: añadir prompts, registrar trabajo y deshacer sus propios cambios si quiere que Claude apruebe correcciones, añada prompts o registre trabajo por usted. Si la desmarca, Claude solo podrá leer.

El formulario de Claude no es igual en todas las cuentas. Si el suyo muestra el nombre, la dirección del servidor y Advanced settings en una sola pantalla, no hay nada que elegir: deje Advanced settings vacío y haga clic en Add.

En el plan Free de Claude solo puede añadir un conector personalizado. Si ya tiene otro, elimínelo en Customize → Connectors antes de añadir Findrix.

¿Usa la aplicación de escritorio de Claude? Un conector que añada en claude.ai aparecerá automáticamente allí con la misma cuenta de Claude. También puede añadirlo desde los ajustes de la aplicación de escritorio, en Connectors, con las mismas opciones.

¿Es propietario de una organización Claude Team o Enterprise? En ese caso, añada Findrix para todos en Organization settings → Connectors.

ChatGPT

Al igual que Claude, ChatGPT inicia sesión con su cuenta de Findrix: no tiene que copiar ninguna clave ni instalar nada. Añade Findrix una sola vez, en chatgpt.com desde el navegador.

  1. Abra ChatGPT Plugins, haga clic en Add y elija Add custom MCP server.

  2. Póngale el nombre Findrix. En Connection, pegue la dirección del servidor https://app.findrix.ai/api/mcp en Server URL.

  3. Para la autenticación, elija OAuth. Deje vacíos el ID de cliente y el secreto: ChatGPT inicia sesión en Findrix automáticamente.

  4. Haga clic en I understand and want to continue, después en Create as a plugin e instale el plugin.

  5. Cuando ChatGPT lo solicite, inicie sesión en Findrix y, en la pantalla Autorizar el acceso, haga clic en Permitir.

  6. Abra un chat nuevo, escriba @, seleccione Findrix y pregunte: Who am I in Findrix, and which sites do I have?

Deje marcada la casilla Hacer cambios por usted: añadir prompts, registrar trabajo y deshacer sus propios cambios si quiere que ChatGPT apruebe correcciones, añada prompts o registre trabajo por usted. Si la desmarca, ChatGPT solo podrá leer. En ambos casos, ChatGPT le preguntará antes de cada cambio.

¿Usa ChatGPT en el trabajo (Business o Enterprise)? Es posible que un administrador tenga que permitir primero los servidores MCP personalizados en su espacio de trabajo.

Compruebe que funciona

Pregunte a su asistente Who am I in Findrix, and which sites do I have? Debería responder con su correo electrónico, su plan y la lista de sus sitios. Si lo hace, Findrix está conectado.

Una primera pregunta en un chat nuevo y el tipo de respuesta que muestra que Findrix está conectado. Ilustración: su pantalla puede verse un poco diferente.

Después, pruebe una de estas preguntas:

  • ¿Cómo le está yendo a yourbrand.com en las respuestas de IA este mes?
  • ¿Qué competidores mencionan los motores de IA en lugar de nosotros?
  • ¿Qué debería corregir primero en mi página de inicio?
  • ¿Qué ha cambiado esta semana y qué está pendiente de mi decisión?
  • Crea un informe en PDF de nuestra visibilidad en IA.
  • Muéstrame las correcciones que están listas para aprobar y después apruébalas.

Identifique su sitio por su dominio. Si tiene varios sitios, indique cuál en su primer mensaje: el asistente lo recordará durante el resto del chat.

Cursor y Codex: obtenga primero una clave

Cursor y Codex se conectan con una clave de Findrix, una contraseña larga creada para una aplicación. La crea en su cuenta de Findrix y Findrix le proporciona toda la configuración para pegarla, con la clave ya incluida.

  1. Abra MCP y conexiones en su cuenta de Findrix (Cuenta → MCP y conexiones).

  2. Cree una clave y póngale el nombre de la aplicación, por ejemplo Cursor. Una cuenta puede tener hasta cinco claves.

  3. Findrix muestra la clave una sola vez, junto con una configuración ya preparada. En Configure un cliente con esta clave, seleccione su aplicación y su sistema (macOS / Linux o Windows) y haga clic en Copiar. Mantenga la página abierta hasta que la haya pegado.

    Justo después de crear una clave, Findrix la muestra una sola vez con una configuración preparada: en Configure un cliente con esta clave, seleccione su aplicación y su sistema y haga clic en Copy. Ilustración: su pantalla puede verse un poco diferente.

Trate la clave como una contraseña: no la pegue en un chat con el asistente ni la envíe por correo electrónico. Si se filtra, revóquela en esa misma página y cree una nueva.

Cursor

  1. Obtenga una clave con la configuración preparada para Cursor (arriba) y haga clic en Copiar.

  2. Abra el archivo de configuración MCP de Cursor, mcp.json.

    En un Mac

    Abra Terminal (pulse Cmd+Space, escriba Terminal y pulse Return), pegue esta línea y pulse Return. El archivo se abre en Cursor.

    mkdir -p ~/.cursor && touch ~/.cursor/mcp.json && open -a Cursor ~/.cursor/mcp.json

    En Windows

    Pulse Win+R, pegue esta línea y pulse Enter. Si Notepad pregunta si quiere crear el archivo, haga clic en Yes. Si indica que no se encuentra la ruta, abra Cursor una vez, ciérrelo e inténtelo de nuevo.

    notepad %USERPROFILE%\.cursor\mcp.json
  3. Si el archivo está vacío o solo contiene {'}, seleccione todo su contenido y pegue. Si ya incluye otros servidores, pegue solo la parte "findrix": { … } dentro de "mcpServers", con una coma entre ella y el servidor anterior.

    El archivo mcp.json de Cursor después de pegar: una entrada findrix con la dirección del servidor y su clave. Ilustración: su pantalla puede verse un poco diferente.
  4. Guarde el archivo.

    En un Mac

    Pulse Cmd+S.

    En Windows

    Pulse Ctrl+S.

  5. Salga de Cursor por completo y vuelva a abrirlo. Haga clic en Customize en la barra lateral y después en MCPs (en versiones anteriores a 3.9: Cursor Settings → Tools & MCP). Findrix aparece en la lista y está activado. Si no aparece o muestra un error, abra el panel Output y seleccione MCP Logs para ver el motivo.

    En un Mac

    Pulse Cmd+Q para salir. Cmd+Shift+U abre el panel Output.

    En Windows

    Cierre todas las ventanas de Cursor para salir. Ctrl+Shift+U abre el panel Output.

  6. Abra un chat nuevo y pregunte: Who am I in Findrix, and which sites do I have?

Codex

La aplicación Codex, la línea de comandos de Codex y la extensión de Codex para VS Code o Cursor comparten un único archivo de configuración, así que solo tiene que configurar Findrix una vez para todos ellos.

  1. Obtenga una clave con la configuración preparada para Codex (arriba) y haga clic en Copiar.

  2. Abra el archivo de configuración de Codex.

    En un Mac

    Abra Terminal (pulse Cmd+Space, escriba Terminal y pulse Return), pegue esta línea y pulse Return. El archivo se abre en TextEdit.

    mkdir -p ~/.codex && touch ~/.codex/config.toml && open -e ~/.codex/config.toml

    En Windows

    Pulse Win+R, pegue esta línea y pulse Enter. Si Notepad pregunta si quiere crear el archivo, haga clic en Yes. Si indica que no se encuentra la ruta, abra Codex una vez, ciérrelo e inténtelo de nuevo.

    notepad %USERPROFILE%\.codex\config.toml
  3. Pegue la configuración al final del archivo y guárdelo.

    El archivo config.toml de Codex después de pegar: la configuración empieza con [mcp_servers.findrix]. Ilustración: su pantalla puede verse un poco diferente.
  4. Salga de Codex por completo y vuelva a iniciarlo. ¿Usa Codex dentro de VS Code o Cursor? Reinicie esa aplicación.

    En un Mac

    Pulse Cmd+Q en Codex y vuelva a abrirlo.

    En Windows

    Cierre Codex y ciérrelo también en la bandeja del sistema si aparece allí su icono. Después, vuelva a abrirlo.

  5. Pregunte: Who am I in Findrix, and which sites do I have?

El archivo de configuración contiene ahora su clave. No lo comparta ni lo guarde en una carpeta sincronizada o compartida.

¿Ya había conectado Codex a Findrix con una variable FINDRIX_MCP_KEY? Sustituya la parte antigua [mcp_servers.findrix] por la nueva configuración en lugar de añadir una segunda.

Leer y realizar cambios

Su asistente siempre puede leer. Para realizar cambios (aprobar correcciones, añadir prompts o competidores y registrar trabajo) necesita su permiso:

  • Conexión mediante inicio de sesión (Claude, ChatGPT): se controla con la casilla Hacer cambios por usted: añadir prompts, registrar trabajo y deshacer sus propios cambios de la pantalla de Findrix que vio al conectar. Para cambiarla, desconecte y vuelva a conectar.
  • Conexión con una clave (Cursor, Codex): se controla con el interruptor Permitir escritura junto a la clave en MCP y conexiones. Si está desactivado, el asistente puede seguir leyendo, pero todos los cambios se rechazan con writes_disabled. Desactívelo en las claves que entregue a otra persona.
  • Todos los cambios realizados de esta forma aparecen en su Registro de trabajo con la marca via MCP.
  • Para deshacer un cambio, pida Undo the last change en un plazo de 24 horas. Si después modificó lo mismo en el panel, se rechaza la operación de deshacer para conservar su propia edición.
  • Algunos cambios no se pueden deshacer de esta forma: editar el perfil de su marca o la región (mercados, idiomas), reformular un prompt, generar o importar prompts e investigar temas para prompts, redactar una carta o una respuesta de Reddit (Aparecer destacado, Corregir información errónea), eliminar una afirmación prohibida, pedir a Findrix que prepare correcciones para sus páginas, iniciar una auditoría y añadir un sitio o ponerlo en marcha tras la configuración inicial. Tampoco se puede recuperar un competidor eliminado (vuelva a añadirlo) ni deshacer la creación de un archivo generado (caduca por sí solo). Findrix informa a su asistente cada vez que un cambio no se puede deshacer.
  • Si el asistente creó un nuevo enlace público a su informe para clientes, al deshacer ese cambio se genera otro enlace nuevo; no se recupera el anterior.
  • Antes de cualquier acción en lote, como aprobar todas las correcciones, pida al asistente que le muestre primero la lista.
  • Su asistente no puede iniciar una nueva medición de visibilidad en IA (Findrix las ejecuta según su programación) y nunca paga nada: para cambiar de plan, le proporciona un enlace de pago que debe abrir usted.

Cómo desconectar

  • Claude: elimine Findrix en Customize → Connectors en Claude. Después, en MCP y conexiones de Findrix, haga clic en Desconectar junto a él en Aplicaciones conectadas: el acceso se interrumpe de inmediato.
  • ChatGPT: elimine el plugin de Findrix en ChatGPT Plugins, en Personal. Después, haga clic en Desconectar junto a él en Aplicaciones conectadas de MCP y conexiones.
  • Cursor o Codex: elimine la parte de Findrix del archivo de configuración y revoque la clave en MCP y conexiones. Una clave revocada deja de funcionar de inmediato.

Si algo no funciona

El asistente no ve Findrix
Inicie un chat nuevo. Cursor, Codex y la aplicación de escritorio de Claude solo detectan una conexión nueva después de un reinicio completo: salga de la aplicación, no se limite a cerrar su ventana, y vuelva a abrirla. En Cursor, compruebe también que Findrix esté activado en Customize → MCPs. En Claude, compruebe que Findrix esté activado en el menú de herramientas del chat. En ChatGPT, escriba @ y seleccione Findrix en el chat.
Todas las solicitudes fallan con 401 o "Unauthorized"
La clave falta, está mal escrita o se ha revocado. Cree una nueva clave en MCP y conexiones y vuelva a copiar la configuración preparada; no escriba la clave a mano.
plan_required
El sitio o su cuenta no tiene un plan de pago. Contrate un plan para el sitio en Findrix o pida al asistente un enlace de pago.
writes_disabled
Los cambios están desactivados para esta conexión. Active Permitir escritura junto a la clave o desconecte Claude o ChatGPT y vuelva a conectarlo con Hacer cambios por usted: añadir prompts, registrar trabajo y deshacer sus propios cambios marcado.
rate_limited
Demasiadas solicitudes en poco tiempo: espera el tiempo que indique el mensaje. Su cuenta puede realizar 120 lecturas por minuto y 5,000 al día, y 60 cambios por minuto y 1,000 al día, sumando todas sus conexiones. Si Claude y Cursor están conectados, comparten estos límites; otra clave no los amplía.
Claude no se conecta después de elegir Sign in now
Esa opción aún se está comprobando. Elimine el conector y vuelva a añadirlo con Sign in when needed.
No aparece Add custom connector en Claude
Es posible que su plan de Claude o los ajustes de su organización no permitan conectores personalizados. En una cuenta de empresa, pida a un propietario que añada Findrix para la organización.
No aparece Add custom MCP server en ChatGPT
Es posible que su plan de ChatGPT o los ajustes de su espacio de trabajo no permitan servidores MCP personalizados. En una cuenta de trabajo, pida a un administrador que los permita.
En Codex, las respuestas largas se cortan a la mitad
Vuelva a copiar la configuración preparada para Codex desde Findrix: incluye la línea que evita este problema.

Para desarrolladores

También puede conectar Claude Code, VS Code, n8n, MCP Inspector y las API de Claude y OpenAI. Las configuraciones de cada uno, todas las herramientas y sus acciones, los límites y el registro de cambios están en la referencia del servidor MCP; las mismas configuraciones están en MCP y conexiones dentro de su cuenta, en Conectar un cliente. La dirección del servidor es https://app.findrix.ai/api/mcp; admite el inicio de sesión (OAuth) y claves enviadas como Authorization: Bearer.