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

# Instalar con un comando

> Un comando (o un prompt pegado en la IA) instala la conexión MCP, la Skill y los .md por función en todas las IA de la computadora.

El comando `doglytdc-scripts` hace por sí solo lo que explica la página [Configurar manualmente](https://docs.doglytdc.dev/es/scripts/mcp/connect.md): crea una clave de conexión para cada IA, guarda la configuración de MCP en el lugar correcto e instala la Skill con un archivo `.md` por grupo de herramientas. No tienes que copiar ni pegar claves.

## Por internet: apps de chat (Claude.ai, Claude Desktop, ChatGPT)

> [!WARNING]
>
> El comando **no funciona dentro de Claude.ai ni de ChatGPT**. Esas apps ejecutan comandos en una máquina aislada, sin internet (npm responde `ENOTFOUND` / `getaddrinfo`), y nada instalado allí llega a la app. Usa el conector de abajo.

Las apps de chat se conectan por la dirección del MCP y te piden iniciar sesión en DoglyTdc — sin clave y sin terminal.

1. Copia la dirección del conector en **Conexiones MCP** en el sitio (o usa `https://api.doglytdc.dev/v1/scripts/mcp`).
2. **Claude.ai / Claude Desktop:** Configuración → Conectores → **Añadir conector personalizado** → pega la dirección → **Conectar**.
3. **ChatGPT:** Configuración → Apps y conectores → Avanzado → activa el **Modo desarrollador**; luego **Crear**, pega la dirección y elige OAuth.
4. Inicia sesión en DoglyTdc y haz clic en **Autorizar**. La app aparece en Conexiones MCP, con identidad, reglas de aprobación y **Revocar**.

Los agentes con terminal e internet en tu computadora (Claude Code, Codex, Cursor, Gemini CLI, VS Code, Windsurf) usan el comando de abajo.

## Pega esto en tu agente de IA

```text theme={null}
Instale o DoglyTdc Scripts e conecte a este agente usando `npx -y doglytdc-scripts@latest setup`. Primeiro rode com --dry-run e me mostre o plano de instalação para eu aprovar; depois rode de novo com --yes e confira se funcionou. Importante: só rode isso se você tiver um terminal com internet no MEU computador. Se você for um app de chat (Claude.ai, ChatGPT, Claude Desktop) ou rodar comandos numa máquina isolada sem internet, não rode nada: me explique como adicionar um conector personalizado com o endereço https://api.doglytdc.dev/v1/scripts/mcp (Configurações → Conectores → Adicionar conector personalizado → colar o endereço → Conectar → entrar no DoglyTdc e aprovar).
```

![Captura de pantalla: Aprobar el comando de instalación](https://mintcdn.com/dogly-tdc/qOnot79kPtISSKbW/images/scripts/scripts-cli.png?fit=max\&auto=format\&n=qOnot79kPtISSKbW\&q=85\&s=0d89568bfd1ccf129ac3fb23b20fdbe7)

Aprobar el comando de instalación

## O ejecútalo en la terminal

> [tab] Node (cualquier sistema)
>
> ```bash theme={null}
> npx -y doglytdc-scripts@latest setup
> ```

> [tab] Windows (PowerShell)
>
> ```powershell theme={null}
> irm https://ucsyxzpdbnuyehizezvb.supabase.co/functions/v1/doglytdc-scripts-api/scripts/install.ps1 | iex
> ```

> [tab] macOS / Linux
>
> ```bash theme={null}
> curl -fsSL https://ucsyxzpdbnuyehizezvb.supabase.co/functions/v1/doglytdc-scripts-api/scripts/install.sh | sh
> ```

> [!NOTE]
>
> Requiere Node.js 18 o posterior. ¿No tienes Node.js? Usa [Configurar manualmente](https://docs.doglytdc.dev/es/scripts/mcp/connect.md).

## Qué sucede

**1. Plan**

El comando busca las IA instaladas y muestra exactamente qué archivos va a crear o modificar. Nada cambia antes de tu aprobación.

**2. Aprobación**

En la terminal, responde `s`. Desde la IA: muestra el plan en el chat y, cuando lo apruebes, vuelve a ejecutarlo con `--yes`.

**3. Código en el navegador**

Abre la página **Conectar IA** de DoglyTdc con un código de 8 letras (p. ej.: `BHKT-QXZM`). Verifica que sea el mismo de la terminal, elige qué pueden hacer las IA y pulsa **Aprovar** (Aprobar). El código es válido durante 10 minutos y solo una vez.

**4. Instalación**

Cada IA recibe su propia clave (aparece en **Scripts › Conexões MCP** (Scripts › Conexiones MCP) con el nombre de la IA y de la computadora), la conexión MCP y la Skill.

**5. Verificación**

El comando llama a `whoami` con la clave de cada IA y muestra tu cuenta. Reinicia las IA para cargar MCP.

## Dónde queda cada cosa

| IA | Conexión MCP | Skill y .md por función |
| - | - | - |
| Claude Code | `claude mcp add-json --scope user` (o `~/.claude.json`) | `~/.claude/skills/doglytdc-scripts/` |
| Codex | `~/.codex/config.toml` | `~/.codex/skills/doglytdc-scripts/` + aviso en `~/.codex/AGENTS.md` |
| Cursor | `~/.cursor/mcp.json` | `.cursor/rules/doglytdc-scripts*.mdc` del proyecto |
| Gemini CLI | extensión `~/.gemini/extensions/doglytdc-scripts/` | `GEMINI.md` + `reference/` en la misma extensión |
| VS Code / Copilot | `mcp.json` del usuario | `.github/instructions/doglytdc-scripts.instructions.md` del proyecto |
| Claude Desktop | `claude_desktop_config.json` (puente `mcp-remote`) | `~/.doglytdc/scripts/doglytdc-scripts-skill.zip` para subir en Skills |
| Windsurf | `~/.codeium/windsurf/mcp_config.json` | `~/.doglytdc/scripts/skill/` |

Las reglas de Cursor y VS Code son por proyecto: se crean cuando ejecutas el comando dentro de una carpeta con `.git`, `package.json` o `doglytdc.json`, o con `--project`. Siempre queda una copia de la Skill en `~/.doglytdc/scripts/skill/`.

## Comandos

| Comando | Qué hace |
| - | - |
| `setup` | Plan → aprobación → inicio de sesión → instalación → verificación (predeterminado) |
| `login` / `logout` | Crea / revoca las claves de esta computadora |
| `status` (o `doctor`) | Qué está instalado en cada IA y si se conecta |
| `update` | Descarga la Skill y los .md más recientes |
| `skills [nome]` | Lista la Skill o muestra un archivo (p. ej.: `skills codigo`) |
| `uninstall` | Elimina solo lo que instaló el comando y revoca las claves |

## Opciones

| Opción | Para qué sirve |
| - | - |
| `--agent a,b` | Solo estas IA: `claude-code`, `codex`, `cursor`, `gemini`, `vscode`, `claude-desktop`, `windsurf` |
| `--project` | Skill y reglas en esta carpeta (la conexión MCP sigue en tu usuario) |
| `--yes`, `-y` | Ya aprobado (la IA lo usa después de que apruebas el plan en el chat) |
| `--dry-run` | Solo muestra el plan |
| `--no-browser` | No abre el navegador; el enlace aparece en la terminal |

Ejemplo:

```bash theme={null}
npx -y doglytdc-scripts@latest setup --agent codex,cursor --project --dry-run
```

## Seguridad

* La clave nunca aparece en el chat de la IA ni en la terminal: queda en `~/.doglytdc/scripts/credentials.json`, con permisos solo para tu usuario.
* Codex y Claude Desktop reciben la clave mediante una variable (`DOGLYTDC_AUTH`), no en la línea de comandos.
* Antes de modificar un archivo de configuración, el comando crea una copia `.bak` y solo modifica la entrada `doglytdc-scripts`.
* Nunca apruebes un código que te haya enviado otra persona: quien tenga el código aprobado recibe las claves.
* Revocar una conexión en **Conexões MCP** desconecta esa IA de inmediato.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.