# Para IA

> Cada página de la documentación en Markdown, llms.txt, llms-full.txt, la especificación OpenAPI y un servidor MCP de solo lectura.

Fuente: https://platform.trevol.si/docs/ia

Esta documentación está pensada también para asistentes de IA y agentes de código. Nada de lo que sigue necesita una cuenta ni una llave.

## Cada página en Markdown

- Agrega `.md` a la dirección de cualquier página: `/docs/facturas.md` (el inicio es `/docs.md`). Es la misma página, en Markdown limpio, con sus ejemplos de código.
- En cada página, el botón **«Copiar como Markdown»** copia ese archivo y **«Ver como Markdown»** lo abre.

## `llms.txt` y `llms-full.txt`

- [`/llms.txt`](/llms.txt): el índice, en el formato de [llmstxt.org](https://llmstxt.org), con un enlace al `.md` de cada página.
- [`/llms-full.txt`](/llms-full.txt): toda la documentación junta, en el orden del menú. Para no pasar de tamaño, cada operación lleva solo cURL (con los SDK publicados, también Node y Python); el `.md` de cada página lleva todos los lenguajes disponibles.
- [`/openapi.json`](/openapi.json): la especificación OpenAPI 3.1 completa.

## Servidor MCP de la documentación

`https://platform.trevol.si/mcp` es un servidor [MCP](https://modelcontextprotocol.io) **de solo lectura** (Streamable HTTP, sin estado y sin autenticación) con dos herramientas:

| Herramienta   | Qué hace                                                                                                                      |
| ------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| `buscar_docs` | Busca en la documentación (`consulta`, y `limite` de 1 a 10) y devuelve título, dirección y un fragmento.                     |
| `leer_pagina` | Devuelve el Markdown de una página (`ruta`, como `/docs/facturas` o `facturas`) o solo de una sección (`seccion`, por ancla). |

No lee datos de nadie, no emite documentos y no necesita llaves. Un servidor MCP que emita es otra cosa: necesitaría llaves y queda para después.

### Cómo agregarlo a un cliente

Claude Code:

```bash
claude mcp add --transport http trevol-docs https://platform.trevol.si/mcp
```

Cursor (`.cursor/mcp.json`):

```json
{
	"mcpServers": {
		"trevol-docs": { "url": "https://platform.trevol.si/mcp" }
	}
}
```

VS Code (`.vscode/mcp.json`; usa `servers` y pide el tipo de transporte):

```json
{
	"servers": {
		"trevol-docs": { "type": "http", "url": "https://platform.trevol.si/mcp" }
	}
}
```

Con otro cliente, agrega un servidor MCP remoto de tipo HTTP (Streamable HTTP) con esa dirección y consulta su documentación para el formato exacto del archivo.

Para probarlo a mano:

```bash
curl -s -X POST https://platform.trevol.si/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
```

> **No pegues llaves en una consulta:** `buscar_docs` no guarda ni registra la consulta, pero una llave pegada en un asistente queda en su historial. Nunca escribas una llave `tvl_…` en una conversación con un asistente.