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

# Cómo generar documentos con IA en n8n

> Añade a tu AI Agent un MCP Client Tool contra el MCP de Doconda, o usa un HTTP Request a /v1/documents: el flujo recibe el Word o PDF.

En n8n tienes dos formas: añadir a un nodo **AI Agent** un **MCP Client Tool** apuntando a
`https://api.eu.doconda.com/mcp`, o llamar a `POST /v1/documents` con un nodo **HTTP Request**. En los dos casos
recibes el documento terminado (Word, PowerPoint, Excel o PDF) con sus enlaces de descarga.

## Pasos

### Con un AI Agent (el agente decide el documento)

1. Añade un nodo **AI Agent** y, en su entrada **Tool**, un nodo **MCP Client Tool**.
2. **Endpoint**: `https://api.eu.doconda.com/mcp`.
3. **Server Transport**: `HTTP Streamable`.
4. **Authentication**: `Bearer Auth`, con una credencial nueva en la que pegas tu API key (sin "Bearer").
5. **Tools to Include**: `All`, o solo las que quieras (por ejemplo `create_document`).

Ya puedes pedirle al agente cosas como *"Cuando llegue un pedido, genera su factura en PDF"*.

### Con un HTTP Request (siempre el mismo documento con datos del flujo)

1. Añade un nodo **HTTP Request**: **Method** `POST`, **URL** `https://api.eu.doconda.com/v1/documents`.
2. **Authentication**: `Bearer Auth` con tu API key.
3. **Body** (JSON), con las expresiones de n8n para meter los datos del flujo:

```json theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
{
  "format": "docx",
  "content": { "markdown": "# Hola {{ $json.nombre }}\n\nGracias por tu pedido {{ $json.pedido }}." }
}
```

Con `content.markdown` el texto se usa tal cual y Doconda solo lo maqueta. Si prefieres que lo escriba la IA, cambia
`content` por `"prompt": "…"`. Puedes añadir `"style": "títulos azules"` y cambiar `format` a `pdf`, `pptx` o `xlsx`.

## Qué devuelve

El HTTP Request espera a que el documento esté listo y devuelve:

```json theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
{
  "id": "doc_01JAB3H8K2M7V6X5T1R0NPQ4ZW",
  "object": "document",
  "status": "ready",
  "pages": 1,
  "outputs": [
    { "kind": "docx", "url": "https://…", "expires_at": "…" },
    { "kind": "pdf", "url": "https://…", "expires_at": "…" }
  ]
}
```

* `outputs`: el archivo y su PDF. Los enlaces caducan a los 5 minutos; pide otros con `GET /v1/documents/{id}/outputs`.
  Para adjuntarlo a un correo, descárgalo en el siguiente nodo con otro HTTP Request a esa `url`.
* `status`: `ready`, `ready_with_warnings`, `needs_review` o `failed` (no se cobra).

## Preguntas frecuentes

<AccordionGroup>
  <Accordion title="¿Puedo revisar o editar un archivo que llega al flujo?">
    Sí. Con el agente, usa `review_document` o `edit_document`; por el MCP remoto el fichero se sube por URL o en base64.
    Con la API, `"operation": "edit"` y el `file` subido. Ver [Editar](/guides/edit).
  </Accordion>

  <Accordion title="¿Cuánto cuesta?">
    Pagas por documento entregado; crear con tu propio Markdown cuesta menos que desde una frase. Ver
    [precios](/guides/account#precios).
  </Accordion>

  <Accordion title="¿Dónde se guardan los documentos?">
    En la Unión Europea (Irlanda), y la IA que los procesa también funciona en la UE.
  </Accordion>
</AccordionGroup>

## Sigue leyendo

* [n8n](/agents/n8n): la guía completa.
* [Quickstart](/quickstart).


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