> For the complete documentation index, see [llms.txt](https://docs.lid.pro/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.lid.pro/es/agents/connect.md).

# Conecta un agente

Conecta un agente de IA a Lid sobre MCP: crea una clave en Ajustes, apunta el agente a mcp.lid.pro/mcp, haz las primeras llamadas, publica un producto.

En palabras simples: esta página lleva a un agente de IA de cero a su primera llamada en Lid. Si vendes o compartes en Lid desde la app, nunca la necesitas.

## ¿Cómo se conecta un agente de IA a Lid?

Sobre MCP (Model Context Protocol), con una clave de API y una dirección. Lid corre un servidor MCP en `https://mcp.lid.pro/mcp` (Streamable HTTP); el agente envía su clave como bearer token y recibe las mismas herramientas que tiene una persona en el panel.

{% stepper %}
{% step %}

### Crea una clave

En la app: **Ajustes → Desarrollador → Crear clave**. Una clave por agente, con etiqueta. La clave se muestra una sola vez y empieza con `lpmcp_`. Trata las claves como dinero: una por agente, revoca la que no reconozcas.
{% endstep %}

{% step %}

### Apunta el agente a Lid

{% tabs %}
{% tab title="Claude Code" %}

```bash
claude mcp add --transport http lid https://mcp.lid.pro/mcp \
  --header "Authorization: Bearer lpmcp_TU_CLAVE"
```

{% endtab %}

{% tab title="Cursor" %}
En `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "lid": {
      "url": "https://mcp.lid.pro/mcp",
      "headers": { "Authorization": "Bearer lpmcp_TU_CLAVE" }
    }
  }
}
```

{% endtab %}

{% tab title="Claude Desktop" %}
En `claude_desktop_config.json`, a través del puente `mcp-remote`:

```json
{
  "mcpServers": {
    "lid": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://mcp.lid.pro/mcp",
        "--header", "Authorization: Bearer lpmcp_TU_CLAVE"
      ]
    }
  }
}
```

{% endtab %}

{% tab title="Cualquier cliente MCP" %}

```json
{
  "mcpServers": {
    "lid": {
      "url": "https://mcp.lid.pro/mcp",
      "headers": { "Authorization": "Bearer lpmcp_TU_CLAVE" }
    }
  }
}
```

{% endtab %}

{% tab title="REST" %}
Las mismas herramientas responden por REST en `https://api.lid.pro/api/v1/agent/*`, una ruta por herramienta, con la misma clave bearer:

```bash
curl -H "Authorization: Bearer lpmcp_TU_CLAVE" \
     -H "User-Agent: mi-agente/1.0" \
     https://api.lid.pro/api/v1/agent/<herramienta>
```

La lista de rutas está en la página de Desarrollador de tu panel.
{% endtab %}
{% endtabs %}

Hay un archivo de descubrimiento en `https://lid.pro/.well-known/mcp.json`.

{% hint style="info" %}
Envía un encabezado User-Agent que nombre a tu agente. Los user agents por defecto de los scripts pueden ser rechazados en el borde.
{% endhint %}
{% endstep %}

{% step %}

### Haz las primeras tres llamadas

1. `api_health`: confirma que la API responde. Devuelve `{ "status": "ok" }`.
2. `my_agent_wallet`: en nombre de quién actúa esta clave. El id de usuario, la billetera real a donde va el ingreso, y la billetera del agente desde la que actúa.
3. `get_my_usage`: límites de creación, lo que queda hoy, y los saldos de la billetera del agente. Gratis.
   {% endstep %}

{% step %}

### Publica un primer producto

1. `upload_file` con `gated: true` para el contenido por el que pagan los compradores. Devuelve una `key`.
2. `create_product` con `name`, `priceUsdc` (unidades humanas, `"5"` son cinco dólares), `maxSupply`, y la comisión que ofreces a los sharers (`affiliateCommissionBps`, `1000` es 10%).
3. `update_product` con `extraFiles: [{ key, title }]`. Un producto de pago sin archivo se queda en borrador; adjuntar el archivo lo publica.
4. `my_products` para leerlo de vuelta: dirección del producto, precio, unidades, estado.
   {% endstep %}
   {% endstepper %}

## ¿Qué puede hacer un agente una vez conectado?

Todo lo que hace una persona desde el panel salvo gastar dinero de producción: crear y publicar productos, compartir productos de otros, correr retos y campañas, revisar resultados, leer ventas y analítica, y recibir webhooks firmados. Las compras desde el saldo propio del agente están en vista previa. Cada venta se liquida como una venta humana: una sola transacción, 3% fijo, ingreso en la billetera real del dueño de la clave.

## Qué leer después

* [Referencia de herramientas](/es/agents/tools.md): cada herramienta, agrupada por tarea.
* [Webhooks y eventos](/es/agents/webhooks.md): recibe un aviso cuando pasa una venta, un premio o una conversión.
* [Uso y límites](/es/agents/limits.md): límites y cuotas.

¿Estás construyendo algo con esto? Escribe a <alberto@lid.pro> con lo que estás haciendo. Quienes construyen primero definen lo que viene.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.lid.pro/es/agents/connect.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.