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

# Guía para agentes

> Cuándo usar la documentación, la API, el SDK y los servidores MCP de La Pyme, y cómo elegir la superficie correcta.

Usá esta guía cuando un asistente necesite responder preguntas sobre La Pyme,
construir una integración o trabajar con los datos autorizados de una
organización. Cada superficie tiene un alcance distinto.

## Cuándo usar cada superficie

| Superficie                   | Usala cuando necesitás                                                          | Acceso a datos reales                      |
| ---------------------------- | ------------------------------------------------------------------------------- | ------------------------------------------ |
| Centro de Ayuda              | Explicar cómo una persona configura o usa La Pyme                               | No                                         |
| MCP público de documentación | Buscar y leer guías, referencias de API y documentación del SDK desde un agente | No                                         |
| API REST                     | Construir una integración HTTP con contratos tipados                            | Sí, con autenticación y permisos           |
| SDK de TypeScript            | Integrar la API desde TypeScript sin construir cada solicitud manualmente       | Sí, con autenticación y permisos           |
| MCP autenticado de producto  | Consultar u operar una organización desde un asistente autorizado               | Sí, con autorización de la persona usuaria |

## Documentación pública

Para una pregunta de producto, empezá por el [Centro de Ayuda](/). Para una
integración, empezá por la [introducción a la API](/api-reference/introduccion),
la [autenticación](/api-reference/autenticacion) y el contrato
[OpenAPI](/api-reference/openapi.json).

El [MCP público de documentación](/api-reference/ai-toolkit) sirve para buscar y
leer estas páginas. No tiene acceso a una cuenta, una organización ni datos de
clientes.

## Operaciones sobre una organización

Usá el MCP autenticado de producto en
`https://mcp.lapyme.com.ar/mcp` cuando la persona usuaria autorice al agente a
consultar u operar su organización. No confundas ese servidor con el MCP
público de documentación.

Antes de una escritura:

1. Descubrí las referencias necesarias mediante operaciones de lectura.
2. No inventes IDs de organización, productos, contactos, ubicaciones, cuentas
   contables u otras entidades.
3. Respetá los permisos, la organización autenticada y los requisitos de
   idempotencia publicados.
4. Tratá los errores estructurados de la API como la fuente para corregir la
   solicitud o decidir si un reintento es seguro.

## Ayuda relacionada

* [Toolkit para agentes](/api-reference/ai-toolkit)
* [Cómo conectar asistentes al MCP de La Pyme](/configuracion/integracion-claude-mcp)
* [Errores de la API](/api-reference/errores)
* [Idempotencia](/api-reference/idempotencia)
