> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.laposta.org/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.laposta.org/_mcp/server.

# Instalar la skill de Laposta para tu asistente de IA

> Da acceso a tu asistente de IA a toda la API de Laposta con una extensión lista para usar.

Una skill es una carpeta con instrucciones para tu asistente de IA. La skill de Laposta contiene la API completa: todos los endpoints, campos obligatorios, códigos de error y errores frecuentes. Por lo tanto, no tienes que explicar nada antes de hacer una consulta.

La skill es gratis, de código abierto y se encuentra en [github.com/laposta/laposta-skill](https://github.com/laposta/laposta-skill). La referencia de endpoints de la skill se genera a partir de la misma fuente que esta documentación. Si la API cambia, se ejecuta un único script y la skill vuelve a estar actualizada.

## Ejemplos de instrucciones

Puedes hacer todo lo que permite [la API](/api), usando un lenguaje natural. Aquí tienes algunos ejemplos de instrucciones que puedes usar directamente:

* "¿Cuántos suscriptores activos hay en cada una de mis listas?"
* "Añade estas doce direcciones a la lista del boletín, con el nombre en el campo correspondiente."
* "¿Quién se ha dado de baja el mes pasado?"
* "Crea una campaña a partir de este archivo html y envíame un correo de prueba."
* "Compara la tasa de apertura y la tasa de clics de mis últimas cinco campañas."

Si preguntas por un endpoint, la skill busca la respuesta en su propia referencia en lugar de recurrir a su memoria.

## Instalar en Claude Code

El repositorio también funciona como un catálogo de plugins. Ejecuta estas dos líneas:

```text
/plugin marketplace add laposta/laposta-skill
/plugin install laposta@laposta-skill
```

A continuación, elige dónde quieres guardar la skill: para tu usuario, para un proyecto o solo de forma local. Más adelante podrás descargar las actualizaciones con `/plugin marketplace update laposta-skill`.

> **Note**
>
> Si recibes el mensaje de que `/plugin` no está disponible, no se debe a un fallo de la skill. Esos comandos con barra inclinada solo funcionan en Claude Code desde la terminal, no en la aplicación de escritorio ni en el navegador. En esos casos, utiliza estos comandos habituales:
>
> ```bash
> claude plugin marketplace add laposta/laposta-skill
> claude plugin install laposta@laposta-skill
> ```

Si prefieres colocar los archivos por tu cuenta, copia la carpeta `laposta` en tu carpeta personal de skills. Claude Code reconoce la carpeta directamente, sin necesidad de reiniciar el programa.

**`Handmatig installeren`**

```bash title="Handmatig installeren"
git clone https://github.com/laposta/laposta-skill.git
mkdir -p ~/.claude/skills
cp -r laposta-skill/plugins/laposta/skills/laposta ~/.claude/skills/
```

## Instalar en claude.ai

En claude.ai no hay catálogo, pero puedes subir un archivo zip. Asegúrate de que la carpeta `laposta` esté en el nivel superior dentro del archivo zip; de lo contrario, no la reconocerá.

**`Het zipbestand maken`**

```bash title="Het zipbestand maken"
cd laposta-skill/plugins/laposta/skills && zip -r laposta.zip laposta
```

Sube este archivo desde tus ajustes, en la sección «Skills».

> **Warning**
>
> En claude.ai el acceso a la red debe estar activado; de lo contrario, el asistente no podrá conectarse a `api.laposta.nl`. Que puedas activarlo por tu cuenta dependerá de tus propios ajustes y de lo que permita el administrador. A través de la API de Claude la skill sí funciona en sí misma, pero no logra conectarse a `api.laposta.nl` porque ese entorno no tiene conexión a internet.

## Instalar en otros asistentes

La skill utiliza únicamente los campos del estándar Agent Skills. Por lo tanto, la misma carpeta funciona en cualquier programa que siga ese estándar, como Gemini CLI, GitHub Copilot, Codex y Cursor. La ubicación de la carpeta de skills varía según el programa. Puedes consultar este dato en la documentación del propio programa.

## Indicar tu clave API

La skill no te pide tu clave durante la conversación, sino que la lee de la variable de entorno `LAPOSTA_API_KEY`. Configúrala así:

```bash
export LAPOSTA_API_KEY="tu-clave"
```

Puedes leer cómo conseguir una clave en [Crear una clave API](/hoe-kom-ik-aan-een-api-sleutel). Crea una clave específica para esto. En [Conectar un asistente de IA](/laposta-gebruiken-met-ai) se explica por qué es importante hacerlo así.

## Trabajar de forma segura con la skill

Las reglas de seguridad están integradas en la propia skill, por lo que no tienes que preocuparte por ellas.

| Situación                              | Qué ocurre                                                                                  |
| -------------------------------------- | ------------------------------------------------------------------------------------------- |
| Buscar algo                            | Se hace inmediatamente, sin preguntas previas                                               |
| Eliminar, vaciar, programar, enviar    | Primero se te pide confirmación mediante una pregunta que incluye el número de suscriptores |
| Modificar muchos suscriptores a la vez | También se pregunta primero, aunque se trate de una serie de llamadas normales              |
| Enviar una campaña                     | Siempre se envía primero un correo de prueba                                                |
| "Quita a alguien de la lista"          | Pregunta si te refieres a darse de baja o a eliminar, porque no es lo mismo                 |
| Tu clave                               | Nunca se muestra, ni se guarda, ni se incluye en un comando                                 |

## Artículos relacionados

#### [Vincular un asistente de IA a tu cuenta](/laposta-gebruiken-met-ai)

Deja que un asistente de IA trabaje de forma segura en tus listas y campañas a través de la API.

#### [La API de Laposta](/api)

Vincula Laposta a tu propio software: sincronizar suscriptores, enviar campañas y…

#### [Crear una clave API](/hoe-kom-ik-aan-een-api-sleutel)

Puedes crear y gestionar tus claves API en la página Conectar. Atención: una nueva…

#### [Usar etiquetas en suscriptores](/labels)

Asigna tus propias etiquetas a tus suscriptores para filtrar, enviar campañas a una…