> ## Documentation Index
> Fetch the complete documentation index at: https://woku.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Conectar un cliente

> Agrega el servidor MCP de woku a claude.ai, Claude Code o ChatGPT y aprueba el acceso desde tu cuenta

Conectar un cliente MCP a woku toma menos de un minuto. No hay claves de API que copiar: pegas una URL, apruebas el acceso desde tu cuenta y el agente queda listo para consultar los datos de tu empresa.

La única URL que necesitas es:

```
https://api.woku.app/mcp
```

## Requisitos

* Una cuenta de woku con acceso a la empresa que quieres conectar.
* Un cliente compatible con MCP sobre HTTP, como claude.ai, Claude Code, ChatGPT u otro agente que soporte el protocolo.

## Paso a paso

El flujo es el mismo en todos los clientes:

<Steps>
  <Step title="Agrega el servidor en tu cliente">
    Pega la URL `https://api.woku.app/mcp` donde tu cliente pida el servidor o conector MCP.
  </Step>

  <Step title="Aprueba el acceso">
    El navegador abre la pantalla de consentimiento del panel administrativo de woku. Inicia sesión si aún no lo has hecho, elige la empresa que quieres conectar y aprueba.
  </Step>

  <Step title="Empieza a preguntar">
    La conexión queda ligada a la empresa que elegiste y el agente ya puede usar las herramientas de woku.
  </Step>
</Steps>

## Por cliente

<Tabs>
  <Tab title="claude.ai">
    En claude.ai abre la configuración, entra a la sección de **conectores** y agrega un **conector personalizado** con la URL `https://api.woku.app/mcp`. Al guardarlo, el navegador abre la pantalla de consentimiento de woku.
  </Tab>

  <Tab title="Claude Code">
    Agrega el servidor desde la terminal:

    ```bash theme={null}
    claude mcp add --transport http woku https://api.woku.app/mcp
    ```

    Luego, dentro de Claude Code, ejecuta `/mcp`, selecciona **woku** y completa la autenticación en el navegador.
  </Tab>

  <Tab title="ChatGPT">
    Activa el **modo desarrollador** en la configuración de conectores de ChatGPT y agrega el servidor con la URL `https://api.woku.app/mcp`.

    Sin el modo desarrollador, ChatGPT solo puede usar las herramientas `search` y `fetch` en investigaciones profundas (deep research). Con el modo desarrollador activo tiene acceso a todas las herramientas.
  </Tab>
</Tabs>

<Note>
  Cada conexión queda asociada a **una sola empresa**. Si perteneces a varias empresas y quieres consultarlas todas, crea una conexión por empresa.
</Note>

Para entender qué puede hacer el agente una vez conectado, revisa las [herramientas disponibles](/docs/mcp/herramientas). Para el detalle de autenticación y seguridad, revisa el [servidor MCP](/docs/mcp/servidor).