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

> ## Agent Instructions
> DarkFunnels is a WhatsApp AI sales-agent platform used mainly in Peru and Latin America. The product interface and most of this documentation are in Spanish; the /en tree is the English mirror.
> A business connects the WhatsApp number it already uses by scanning a QR code from the dashboard, the same linked-device mechanism as WhatsApp Web. It does not go through the Meta Cloud API (WhatsApp Business Platform), so there is no application to get approved and no message templates to submit. DarkFunnels is not a Meta product and is not affiliated with Meta.
> DarkFunnels also publishes a remote MCP server at https://mcp.darkfunnels.ai/mcp so an assistant such as Claude, ChatGPT or Codex can operate the workspace on the owner's behalf. The tool reference is at /referencia/tools and the connection parameters at /referencia/url-de-conexion.
> The dashboard is https://optimind.darkfunnels.ai, the marketing site is https://darkfunnels.ai and the page written for AI agents is https://darkfunnels.ai/agents.

# Cursor, VS Code y otros

> El conector en cualquier cliente MCP: una URL y un fichero de configuración.

DarkFunnels habla MCP estándar, así que funciona en cualquier cliente que lo
soporte. Siempre es la misma URL:

```
https://mcp.darkfunnels.ai/mcp?features=all
```

No hay que registrar nada ni pedir acceso: al conectar, el cliente descubre solo
cómo autorizarte y te abre el navegador. Entra con **la misma cuenta con la que
entras al panel**.

## Cursor

Edita `~/.cursor/mcp.json` (global) o `.cursor/mcp.json` (solo ese proyecto):

```json theme={null}
{
  "mcpServers": {
    "DarkFunnels": {
      "url": "https://mcp.darkfunnels.ai/mcp?features=all"
    }
  }
}
```

Cursor abre el navegador solo la primera vez y guarda la sesión.

## VS Code

Edita `.vscode/mcp.json` en tu proyecto (o el del perfil de usuario):

```json theme={null}
{
  "servers": {
    "DarkFunnels": {
      "type": "http",
      "url": "https://mcp.darkfunnels.ai/mcp?features=all"
    }
  }
}
```

<Warning>
  VS Code es el que más se equivoca la gente, por dos detalles:

  * La clave de arriba es **`servers`**, no `mcpServers` como en Cursor. Con la
    clave equivocada VS Code **ignora el fichero entero y no dice nada**.
  * Hace falta **`"type": "http"`**. Sin él no levanta la conexión remota.
</Warning>

## Gemini CLI

Edita `~/.gemini/settings.json` (o `.gemini/settings.json` del proyecto). Ojo
con el nombre del campo: aquí la URL va en **`httpUrl`**, no en `url`:

```json theme={null}
{
  "mcpServers": {
    "DarkFunnels": {
      "httpUrl": "https://mcp.darkfunnels.ai/mcp?features=all"
    }
  }
}
```

Gemini CLI descubre la autorización solo y guarda el token en
`~/.gemini/mcp-oauth-tokens.json`, renovándolo cuando caduca.

## Cualquier otro cliente

Windsurf, Zed, Claude Desktop y el resto siguen el mismo patrón; lo único que
cambia entre unos y otros son tres detalles, y merece la pena mirarlos en la doc
del cliente antes de pelearse con el fichero:

1. **Cómo se llama la clave raíz** — `mcpServers` en casi todos, `servers` en
   VS Code.
2. **Cómo se llama el campo de la URL** — `url` en casi todos, `httpUrl` en
   Gemini CLI.
3. **Si hace falta declarar el tipo** — `"type": "http"` en VS Code.

## Si tu cliente se queda sin sitio para las herramientas

Algunos clientes limitan cuántas herramientas puede tener el modelo a la vez
(Windsurf ronda las 100, VS Code las 128) contando **todos** tus servidores
juntos. DarkFunnels trae 45 con `?features=all`, así que si ya tienes varios
conectores puedes quedarte corto.

La solución es pedir solo lo que vayas a usar. La lista **sustituye** al set
base, no lo amplía:

```
https://mcp.darkfunnels.ai/mcp?features=conversations,orders
```

Los grupos están en la [referencia de herramientas](/referencia/tools). Y si
quieres mirar sin poder tocar nada:

```
https://mcp.darkfunnels.ai/mcp?read_only=true
```

## Sin humano delante (headless)

Hoy **no**. La conexión exige que una persona autorice en el navegador con su
cuenta, así que un agente que corra solo —un cron, un worker, el Agents SDK de
OpenAI o el Agent SDK de Claude— no puede conectarse por su cuenta.

Estamos trabajando en claves de agente para eso. Mientras tanto, si necesitas
automatizar algo sin humano delante, escríbenos y lo vemos caso por caso.

<Note>
  Si tu cliente no ve tu negocio, o lo ve vacío, casi siempre es lo mismo:
  autorizaste con **otra cuenta** y estás conectado a un workspace distinto.
  Pregúntale a tu asistente «¿a qué cuenta estás conectado?» y, si no es la
  correcta, borra el conector y vuelve a conectarlo.
</Note>