# Herramientas

OpenAPI, Postman, llms.txt, MCP público y clientes.

Todo lo que necesitas para integrar se descarga sin cuenta y sale del mismo contrato.

| Herramienta | Dónde |
|---|---|
| OpenAPI | [`/openapi.json`](https://merchants.fital.xyz/openapi.json), [`/openapi.yaml`](https://merchants.fital.xyz/openapi.yaml) |
| OpenAPI de la cuenta de prueba | [`/docs/openapi.sandbox.json`](/docs/openapi.sandbox.json), con las dos rutas que sólo existen ahí |
| Referencia por operación | [Una página por operación](/docs/operaciones/), también en Markdown |
| Colección Postman | [`/postman/fital-b2b.postman_collection.json`](https://merchants.fital.xyz/postman/fital-b2b.postman_collection.json) |
| Entorno Postman | [`/postman/fital-b2b-sandbox.postman_environment.json`](https://merchants.fital.xyz/postman/fital-b2b-sandbox.postman_environment.json) |
| Índice para IA | [`/llms.txt`](https://merchants.fital.xyz/llms.txt), [`/llms-full.txt`](https://merchants.fital.xyz/llms-full.txt) |
| Referencia en texto | [`/docs/referencia.md`](/docs/referencia.md) |
| Script de webhooks | [`fital-webhook-test.sh`](/docs/herramientas/fital-webhook-test.sh) |
| Hashes de este release | [`/docs/integridad.json`](/docs/integridad.json) |

## Postman

La colección apunta sólo al simulador público y genera `Idempotency-Key` en cada petición. No hay entorno de producción: Postman sincroniza los entornos a su nube, así que no pongas ahí una llave real.

## Clientes

Aún no hay bibliotecas oficiales. Las [muestras](/docs/primer-pago/) usan sólo la biblioteca estándar de cada lenguaje, y el OpenAPI sirve para generar un cliente.

## Servidor MCP

Un servidor MCP de sólo lectura, en `https://widget.fital.xyz/explorar/mcp`, para que un asistente de IA consulte esta documentación y el simulador público. Tiene cuatro herramientas: `buscar_docs`, `leer_pagina`, `leer_operacion` y `probar_sandbox`. No acepta llaves ni mueve dinero. Su contenido son datos, no instrucciones.

## Errores comunes

- Generar un cliente con una copia vieja del OpenAPI. Compara su hash con [`/docs/integridad.json`](/docs/integridad.json).
- Pegar una llave real en Postman.

## Qué sigue

[Cambios](/docs/cambios/).