> ## 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.

# Toolkit

> Instala el woku AI Toolkit: el plugin que conecta tu agente al servidor MCP de woku y le enseña el método woku, en un solo paso

El **woku AI Toolkit** empaqueta en un plugin instalable todo lo que un agente necesita para trabajar con woku: la conexión al servidor MCP (el catálogo completo de herramientas con el OAuth de woku) y una skill que le enseña el **método woku** para que actúe como consultor de experiencia, no solo como ejecutor de comandos.

Es de código abierto: [github.com/wokuApp/woku-ai-toolkit](https://github.com/wokuApp/woku-ai-toolkit).

## Qué incluye

* La **conexión al servidor MCP** de woku (`https://api.woku.app/mcp`): instalar el toolkit expone el catálogo completo de herramientas con el OAuth de woku. No hay claves de API que copiar.
* La **skill de woku**: prepara al agente con el método (proteger ingresos con la voz del cliente) y le indica llamar `woku_guide` primero.

## Instalar

<Tabs>
  <Tab title="Claude Code">
    Agrega el marketplace de woku e instala el plugin. Esto deja listos el servidor MCP y la skill:

    ```
    /plugin marketplace add wokuApp/woku-ai-toolkit
    /plugin install woku@woku-ai-toolkit
    ```

    Cuando el toolkit sea aceptado en el marketplace oficial, también funcionará `/plugin install woku@claude-plugins-official`.
  </Tab>

  <Tab title="Codex">
    Agrega el servidor MCP de woku a `~/.codex/config.toml` y autentícate:

    ```toml theme={null}
    [mcp_servers.woku]
    url = "https://api.woku.app/mcp"
    ```

    ```
    codex mcp login woku
    ```

    `auth = "oauth"` es el valor por defecto para una `url` simple, así que Codex abre el navegador para completar el OAuth de woku. Puedes verificarlo con `codex mcp list`.
  </Tab>

  <Tab title="OpenCode">
    Agrega el servidor a tu `opencode.json`:

    ```json theme={null}
    {
      "$schema": "https://opencode.ai/config.json",
      "mcp": {
        "woku": {
          "type": "remote",
          "url": "https://api.woku.app/mcp",
          "enabled": true
        }
      }
    }
    ```

    OpenCode maneja el OAuth automáticamente en la primera llamada autenticada. Para iniciar el login a mano, ejecuta `opencode mcp auth woku`.
  </Tab>

  <Tab title="OpenClaw">
    Instala el plugin (esto deja lista la skill de woku):

    ```
    openclaw plugins install git:github.com/wokuApp/woku-ai-toolkit
    ```

    El manifiesto de plugin de OpenClaw declara servidores MCP locales, así que agrega el servidor MCP remoto de woku (`https://api.woku.app/mcp`) desde tu configuración MCP de OpenClaw.
  </Tab>

  <Tab title="claude.ai y ChatGPT">
    Se configuran desde la app, no desde un paquete: agrega un conector personalizado (claude.ai) o un conector en modo desarrollador (ChatGPT) con la URL `https://api.woku.app/mcp`. Revisa [Conectar un cliente](/docs/mcp/connect-a-client) para el detalle.
  </Tab>
</Tabs>

<Note>
  Cada conexión queda ligada a **una sola empresa**, elegida cuando apruebas el acceso. Las herramientas de lectura no piden permisos especiales; las de escritura requieren el scope `mcp:write`, y las destructivas o los envíos requieren una confirmación explícita.
</Note>

Para el método y las dos herramientas meta (`woku_guide` y `design_voc_program`), revisa la [Guía del agente](/docs/mcp/agent-guide). Para conectar el servidor MCP sin el plugin, revisa [Conectar un cliente](/docs/mcp/connect-a-client). Para el catálogo completo, revisa las [herramientas disponibles](/docs/mcp/tools).