# Usar estos docs con asistentes IA

> llms.txt, cada página en Markdown, Ask AI, la spec OpenAPI y el servidor MCP: todo lo que un asistente IA necesita para integrar WhatSetter.

Source: https://docs.whatsetter.com/es/developers/ai-assistants/

Estos docs están escritos para personas y para asistentes IA. Cada página existe en Markdown, todo el sitio cabe en un solo archivo, y un asistente puede actuar sobre tu cuenta a través del servidor MCP.

## Qué exponen estos docs a la IA

| Recurso | Dónde | Para qué sirve |
|---|---|---|
| Índice de todas las páginas | `https://docs.whatsetter.com/llms.txt` | Dar a un asistente el mapa de los docs en una sola petición. |
| Todo en un solo archivo | `https://docs.whatsetter.com/llms-full.txt` | Pegar toda la documentación en un modelo de contexto largo. |
| Cualquier página en Markdown | Añade `.md` a la ruta de la página, o envía `Accept: text/markdown` | Pasar una página sin el ruido del HTML. |
| Spec OpenAPI en bruto | `https://docs.whatsetter.com/openapi.yaml` | Generar un cliente, validar peticiones, dejar que un asistente lea cada esquema. |
| Ask AI | El botón **Ask AI** de la cabecera | Hacer una pregunta en inglés, francés o español. Responde solo a partir de estos docs, con sus fuentes. |
| Acciones de página | **Copy page**, **Open in Claude**, **Open in ChatGPT** en la cabecera de la página | Copiar el Markdown, o abrir la página en tu asistente con un clic. |
| Servidor MCP | `https://mcp.whatsetter.com/mcp` | Dejar que el asistente actúe sobre tu cuenta: leads, campañas, prompts, conocimientos, contactos bloqueados. Mira [Servidor MCP](/es/developers/mcp/). |

Las URL en Markdown siguen la estructura del sitio, en cada idioma:

```
https://docs.whatsetter.com/developers/quickstart.md
https://docs.whatsetter.com/developers/errors.md
https://docs.whatsetter.com/fr/dashboard/leads.md
https://docs.whatsetter.com/es/developers/webhooks.md
```

```bash
curl -H "Accept: text/markdown" https://docs.whatsetter.com/es/developers/authentication/
```

## Dar el contexto correcto a tu asistente

Pon este bloque en el archivo que tu asistente lee al inicio de cada sesión: `CLAUDE.md` para Claude Code, un archivo de reglas para Cursor, `AGENTS.md` para Codex.

```markdown
## WhatSetter API

Before using the WhatSetter API, read https://docs.whatsetter.com/llms.txt
and the guide of the resource you need
(for example https://docs.whatsetter.com/developers/guides/leads.md).

- Base URL: https://app.whatsetter.com/api/v1
- The API key is in the WHATSETTER_API_KEY environment variable.
  Never write it in code, in a config file or in a commit.
- Every error is { "error": { "code", "message" } }.
  The codes are listed at https://docs.whatsetter.com/developers/errors.md
- Always send an Idempotency-Key header on POST /messages.
- Never send a WhatsApp message or add a lead to a campaign without asking me first.
```

El asistente busca entonces la página exacta que necesita en lugar de adivinar los nombres de los campos.

## Pasar una página a un asistente

Tres formas, de la más rápida a la más completa:

1. Haz clic en **Open in Claude** u **Open in ChatGPT** en la cabecera de la página que estás leyendo.
2. Haz clic en **Copy page** y pega el Markdown en el chat.
3. Dale al asistente la URL `.md` de la página, por ejemplo `https://docs.whatsetter.com/developers/webhooks.md`, y deja que la descargue.

Para una pregunta que abarca varias páginas, dale `https://docs.whatsetter.com/llms-full.txt` una sola vez.

## Dejar que Claude Code construya una integración de principio a fin

1. Crea una clave en **Configuración**, luego **API y MCP**, con los scopes que la integración necesita. Expórtala: `export WHATSETTER_API_KEY="ws_live_…"`.
2. Añade el bloque de arriba al `CLAUDE.md` de tu proyecto.
3. Si quieres, conecta el [servidor MCP](/es/developers/mcp/) para que Claude Code compruebe el resultado contra tu espacio real: `claude mcp add --transport http whatsetter https://mcp.whatsetter.com/mcp`.
4. Describe la integración. Por ejemplo: «Sincroniza cada lead calificado por WhatSetter en nuestro CRM HubSpot. Suscríbete al webhook `contact.qualified`, verifica la firma y empareja por `external_reference`.»
5. Pide a Claude Code que pruebe primero con `GET /me`, luego con lecturas, antes de cualquier llamada que envíe un mensaje.

> **La clave se queda en el entorno**
Lee el código generado antes de ejecutarlo: la clave debe venir de `WHATSETTER_API_KEY`, nunca de una cadena en el código. Si una clave acaba alguna vez en un archivo o en un chat, revócala en **Configuración**, luego **API y MCP**, y crea una nueva.

## Relacionado

- [Servidor MCP](/es/developers/mcp/)
- [Inicio rápido](/es/developers/quickstart/)
- [Errores, límites e idempotencia](/es/developers/errors/)
