> For the complete documentation index, see [llms.txt](https://docs.incogniton.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.incogniton.com/documentation/spanish/api-de-automatizacion-y-sdks/connect-ai-clients-mcp.md).

# Conectar clientes de IA con MCP

Genera un token MCP en Configuración → Automatización y conecta Claude Desktop, Claude Code, Cursor, Windsurf, VS Code o Codex CLI a tu cuenta de Incogniton.

Abre **Configuración** en el menú lateral izquierdo, haz clic en la pestaña **Automatización** y haz clic en **Generar Token MCP**. Luego elige tu cliente de IA en **Instalar en tu cliente de IA** y haz clic en **Copiar configuración**.

MCP (Protocolo de Contexto de Modelo) permite que un cliente de IA como Claude, Cursor o VS Code trabaje con tu cuenta de Incogniton. Puedes pedirle que busque, cree o edite perfiles, gestione proxies, grupos y etiquetas, y lance o detenga perfiles.

La conexión se ejecuta a través del paquete npm `@incogniton/mcp`. Tu cliente de IA lo inicia con `npx`, por lo que necesitas [Node.js](https://nodejs.org/) 18 o más reciente en la computadora donde se ejecuta el cliente de IA.

### Genera tu token MCP

{% stepper %}
{% step %}

#### Abre la pestaña Automatización

Haz clic en **Configuración** en el menú lateral izquierdo, luego haz clic en la pestaña **Automatización**. Desplázate a la sección **Token MCP**.
{% endstep %}

{% step %}

#### Genera el token

Haz clic en **Generar Token MCP**. El nuevo token aparece en un campo debajo del botón.
{% endstep %}

{% step %}

#### Cópialo y guárdalo

Haz clic en **Copiar** junto al token y guárdalo en un lugar seguro, por ejemplo, en un gestor de contraseñas. Incogniton muestra el token solo una vez: **Advertencia: No puedes recuperar este token más tarde — cópialo y guárdalo ahora.**
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Trata el token MCP como una contraseña. Cualquiera que lo tenga puede gestionar los perfiles de tu cuenta. Nunca lo compartas ni lo pegues en un archivo público.
{% endhint %}

### Reemplazar o revocar tu token

Tienes un token MCP activo a la vez. Hacer clic en **Generar Token MCP** nuevamente crea un nuevo token y hace que el anterior deje de funcionar. Actualiza el token en cada cliente de IA que conectaste.

Para detener todo acceso, haz clic en **Revocar** bajo **Tokens activos**. Cuando no hay tokens activos, la sección muestra **No hay tokens activos**.

### Agregar Incogniton a tu cliente de IA

En **Instalar en tu cliente de IA**, abre el menú desplegable **Cliente de IA** y elige tu cliente: Claude Desktop, Claude Code, Cursor, Windsurf, VS Code o Codex CLI. Incogniton muestra una configuración lista para pegar con tu nuevo token ya completado, y te dice dónde pegarlo. Haz clic en **Copiar configuración**, pégalo donde la aplicación te indique y reinicia el cliente de IA.

Genera el token primero. Si abres esta lista más tarde, la configuración contiene `YOUR_MCP_TOKEN` en lugar de un token: reemplázalo con el token que guardaste.

Para la configuración manual en otros clientes MCP, consulta la [documentación del servidor MCP](https://api-docs.incogniton.com/mcp).

### Lo que el cliente de IA puede hacer a través de MCP

Después de conectar, tu cliente de IA puede:

* **Perfiles:** buscar, crear, editar y clonar perfiles, y consultar los grupos, etiquetas, proxies e idiomas de navegador que puedes usar para un nuevo perfil.
* **Grupos y etiquetas:** buscar y crear grupos de perfiles y etiquetas.
* **Proxies:** buscar y agregar proxies, y buscar y crear grupos de proxies.
* **Equipo:** consultar miembros del equipo.
* **Lanzar y detener:** ver qué computadoras pueden lanzar un perfil, lanzar un perfil, verificar si un lanzamiento o detención funcionó, y detener un perfil.
* **Teléfonos en la nube:** listar tus teléfonos en la nube, crear un teléfono en la nube con un proxy de tu Biblioteca de Proxies, y iniciar o detener teléfonos en la nube. Los teléfonos iniciados a través de MCP comienzan sin pantalla.

La lista completa de herramientas está en la [documentación del servidor MCP](https://api-docs.incogniton.com/mcp).

### Cómo funciona el lanzamiento a través de MCP

Un perfil siempre se abre en la aplicación Incogniton en una de tus computadoras. Esa computadora debe tener la aplicación abierta e iniciada sesión en tu cuenta.

* Si una computadora está disponible, el perfil se lanza allí. Si hay varias, el cliente de IA obtiene la lista de computadoras y tú eliges una.
* Una solicitud de lanzamiento que ninguna computadora recoge dentro de 5 minutos expira.
* MCP solo puede detener perfiles que fueron lanzados a través de MCP. Cierra un perfil que abriste tú mismo desde la aplicación Incogniton.

### Controlar el navegador después de un lanzamiento MCP

MCP en sí solo abre y cierra perfiles. No puede hacer clic, escribir o leer páginas dentro del navegador.

Después de un lanzamiento, el cliente de IA puede obtener una dirección local de DevTools (`cdp_url`) del navegador en ejecución. Un cliente de IA que puede ejecutar código puede conectar Puppeteer, Playwright o un navegador MCP a esa dirección.

{% hint style="info" %}
El `cdp_url` solo funciona cuando el cliente de IA se ejecuta en la **misma computadora** que la aplicación Incogniton que lanzó el perfil. No funciona desde otra computadora, o desde un cliente que no puede ejecutar código, como Claude Desktop. También necesita que **Permitir control remoto del navegador** esté activado en la pestaña Automatización. Consulta [Control remoto del navegador](https://docs.incogniton.com/documentation/spanish/api-de-automatizacion-y-sdks/browser-remote-control.md).
{% endhint %}

### Lo que MCP no puede hacer

Estas acciones no están disponibles a través de MCP:

* Abrir una URL, gestionar pestañas o leer páginas en un perfil en ejecución.
* Comprobar si un proxy funciona.
* Eliminar perfiles.
* Restaurar un perfil desde una copia de seguridad.

Cas, el asistente de IA dentro de la aplicación Incogniton, puede hacer esto. Abre Cas en la aplicación para usarlos.

### Solución de problemas

* **El cliente no muestra herramientas de Incogniton:** reinicia el cliente de IA después de pegar la configuración y verifica que Node.js 18 o más reciente esté instalado.
* **El registro MCP del cliente muestra "falta el token de portador":** el token falta en la configuración. Pega tu token en lugar de `YOUR_MCP_TOKEN`.
* **Errores de autenticación:** el token fue reemplazado o revocado. Genera uno nuevo y actualiza la configuración.

Para scripts que se ejecutan en tu propia computadora, también puedes usar la [API REST local](https://docs.incogniton.com/documentation/spanish/api-de-automatizacion-y-sdks/local-rest-api.md) o el [SDK de JavaScript y Python](https://docs.incogniton.com/documentation/spanish/api-de-automatizacion-y-sdks/javascript-and-python-sdk.md).
