# Documentación para desarrolladores

> Integra Probara con la API REST y MCP.

Automatiza Probara: llama a la API REST pública desde CI y scripts, o conecta un cliente MCP para que un agente de IA opere proyectos, suites, casos, ejecuciones y defectos directamente. Cada operación de escritura de la API está controlada por un permiso de organización — un `viewer` recibe `403 forbidden` en toda escritura, y algunas escrituras (como crear un proyecto) requieren un rol `owner`/`admin`.

## Disponible hoy

- Uso del producto en [Guías](https://docs.probara.net/es/guides/).
- **Prefijo REST:** la app web y las integraciones deben usar **`/api/v1`** (por ejemplo `GET /api/v1/health`). Rutas sin versión (`/api/...`) responden `404 not_found`.
- **[Autenticación API](https://docs.probara.net/es/developers/authentication/)** — tokens API por organización (`Authorization: Bearer`) para scripts, y tokens de aplicación de la organización para enviar resultados desde CI; la web sigue con cookies de sesión. El endpoint MCP además acepta tokens de acceso OAuth 2.1 para clientes interactivos.
- **[Integraciones CI](https://docs.probara.net/es/developers/ci-integrations/)** — envía resultados de pruebas desde cualquier CI con un token de aplicación (planes de pago): elige entre la CLI y los reporters de Playwright, Jest, Cypress, Vitest y Cucumber.
- **[CLI](https://docs.probara.net/es/developers/cli/)** — envía resultados JUnit XML desde cualquier CI con `@probara/cli`.
- **[Reporter de Playwright](https://docs.probara.net/es/developers/ci-integrations/playwright/)** — envía cada intento de Playwright, con sus pasos y adjuntos, con `@probara/playwright-reporter`.
- **[Reporter de Jest](https://docs.probara.net/es/developers/ci-integrations/jest/)** — envía cada intento de Jest, con sus pasos, adjuntos y enlaces, y ejecuta solo las pruebas de una ejecución de Probara, con `@probara/jest-reporter`.
- **[Reporter de Cypress](https://docs.probara.net/es/developers/ci-integrations/cypress/)** — envía cada intento de Cypress, con sus pasos, las capturas de los fallos y sus enlaces, y ejecuta solo las pruebas de una ejecución de Probara, con `@probara/cypress-reporter`.
- **[Reporter de Vitest](https://docs.probara.net/es/developers/ci-integrations/vitest/)** — envía cada intento y cada repetición de Vitest, con sus pasos, adjuntos y enlaces, y ejecuta solo las pruebas de una ejecución de Probara, con `@probara/vitest-reporter`.
- **[Referencia REST](https://docs.probara.net/es/developers/api-reference/)** — resumen (URL base, errores, paginación).
- **[Referencia interactiva (v1)](https://docs.probara.net/es/developers/api-reference/v1/)** — visor OpenAPI 3.1.
- **[Servidor MCP](https://docs.probara.net/es/developers/mcp/)** — conecta cualquier cliente compatible con MCP (Claude.ai, Claude Code, Cursor, ChatGPT) a `https://app.probara.net/mcp` con OAuth 2.1 o un token API.
- **[Referencia de herramientas MCP](https://docs.probara.net/es/developers/mcp-tools/)** — la lista completa y generada de cada herramienta que expone el servidor, regenerada desde el registro del worker para que nunca diverja.
- **[Aprovisionamiento SCIM](https://docs.probara.net/es/developers/scim/)** — el endpoint SCIM 2.0 que un proveedor de identidad llama para aprovisionar personas y grupos, en el plan Enterprise.
- **Markdown para agentes** — cada guía y cada página para desarrolladores también se sirve como Markdown plano: cambia la barra final por `.md` (por ejemplo [`/es/developers/authentication.md`](https://docs.probara.net/es/developers/authentication.md)). [`/llms.txt`](https://docs.probara.net/llms.txt) las lista todas, para que un agente de código lea la documentación sin interpretar HTML.

## Estado por tema

| Tema                                              | Estado                                                           |
| ------------------------------------------------- | ---------------------------------------------------------------- |
| Autenticación API                                 | <span class="dev-status dev-status--available">Disponible</span> |
| Referencia REST (resumen)                         | <span class="dev-status dev-status--available">Disponible</span> |
| Referencia interactiva (v1)                       | <span class="dev-status dev-status--available">Disponible</span> |
| Servidor MCP                                      | <span class="dev-status dev-status--available">Disponible</span> |
| Referencia de herramientas MCP                    | <span class="dev-status dev-status--available">Disponible</span> |
| [Reporters / CI](https://docs.probara.net/es/developers/ci-integrations/) | <span class="dev-status dev-status--available">Disponible</span> |
| CLI Probara                                       | <span class="dev-status dev-status--available">Disponible</span> |
| Aprovisionamiento SCIM (plan Enterprise)          | <span class="dev-status dev-status--available">Disponible</span> |

Cuando se publique una nueva capacidad, esta sección añadirá su autenticación, ejemplos y referencia estable desde los esquemas Zod del monorepo.