# Agente de inteligencia API y documentación de MCP

**Maetra** es un avión de control de tiempo de ejecución para los agentes de IA. Utilice el servidor REST API o MCP para mantener el trabajo alineado con la tarea del usuario, pausar acciones sensibles para la aprobación de políticas o humanos, escanear contenido arriesgado, y preservar evidencia de lo que sucedió después de la aprobación.

¿Nuevo para Maetra? Comience con el [Quickstart](https://maetra.io/es/docs/getting-started/quickstart). ¿Conectar a un agente o asistente? Usar el [Guía del servidor de MCP](https://maetra.io/es/docs/mcp-server/overview-and-connection). ¿Necesitas un punto final? Saltar a la [Referencia de API](https://maetra.io/es/docs/reference/api-reference).

### Los tres controles de tiempo de ejecución

#### Task Guard

**Alineación de tareas del agente de inteligencia artificial.** Convierta los criterios objetivos, limitaciones, alcance y éxito del usuario en un contrato de tareas activo. Antes de una acción material, Task Guard comprueba si el trabajo está alineado, soportando, necesita una explicación, requiere confirmación del usuario, o debe ser reorientado. Después, puede comparar los efectos esperados e informados.

#### Govern

**Aprobaciones humanas en el bucle y recibos de ejecución.** Antes de que un agente mueva dinero, borra datos o envía correos electrónicos a un cliente, llama a Maetra. Las políticas exactas o la inteligencia de la decisión pueden aprobar, bloquear o enrutar la acción a un humano. Una decisión firmada está vinculada a la carga útil de acción exacta, y los recibos de ejecución pueden vincular esa aprobación a los intentos y el resultado observado.

#### Secure

**Escaneo de contenido de tiempo de ejecución.** Inyección rápida, exfiltración de datos, herramientas no autorizadas y salidas modelo contra sus reglas del espacio de trabajo (inyección rápida, exfiltración de datos, herramientas no autorizadas) y recuperar un veredicto (en inglés)`safe`, `flagged`, `blocked`) y una acción recomendada. Cualquier cosa insignia o bloqueada se convierte en un incidente.


### Dos formas de integrar

<table data-view="cards"><thead><tr><th>Interfaz</th><th>Mejor para</th><th></th></tr></thead><tbody><tr><td><strong>REST API</strong></td><td>Backends and services calling <code>/v1</code> sobre HTTPS.</td><td><a href="https://maetra.io/es/docs/getting-started/quickstart">Quickstart →</a></td></tr><tr><td><strong>MCP server</strong></td><td>Agentes y asistentes de AI que hablan el Protocolo Modelo de Contexto.</td><td><a href="https://maetra.io/es/docs/mcp-server/overview-and-connection">MCP Overview →</a></td></tr></tbody></table>

Ambos están respaldados por el mismo motor de evaluación y autenticados con la misma clave API del espacio de trabajo.

### Lo que puedes construir

* **Agentes de pago y finanzas** que no puede cambiar la cuenta, la cantidad o la moneda aprobada después del examen.
* **Agentes de operaciones de clientes** que pausa antes de reembolsos, cambios de cuenta o mensajes externos.
* **Asistentes de larga duración** que vuelva a revisar su contrato de tareas antes de las acciones materiales e informe de los efectos reales después.
* **Agentes conectados con MCP** que descubren sólo las herramientas de Task Guard, Govern y Secure habilitadas para su espacio de trabajo y API clave.

La aprobación y ejecución son hechos separados. Un token de decisión demuestra lo que Maetra autorizó; un [recepción de la ejecución](https://maetra.io/es/docs/govern-api/execution-receipts) registra cómo se intentó esa acción exacta y qué efecto se observó la evidencia.

> **Good to know**
> **No necesitas registrar a tus agentes primero.** Cada punto final acepta un texto libre `agent_name`, para que pueda integrarse en minutos y registrar agentes más tarde para informar más rico. Govern todavía evalúa a los agentes de API y MCP contra las políticas de toda la organización; cuando `agent_name` o `agent_id` coincide con un agente registrado, se pueden aplicar políticas de agente-scopio. Véase [Agentes](https://maetra.io/es/docs/agents).


### Base URL

```
https://api.maetra.io
```

All REST endpoints are versioned under `/v1`. El servidor MCP tiene su propia URL base — ver [MCP vista general](https://maetra.io/es/docs/mcp-server/overview-and-connection).

### Siguientes pasos

1. [Crear una clave de API](https://maetra.io/es/docs/getting-started/authentication) en el tablero.
2. [Ejecute su primer punto de control y escaneo](https://maetra.io/es/docs/getting-started/quickstart), [conectar un cliente de MCP](https://maetra.io/es/docs/mcp-server/overview-and-connection), [iniciar una tarea de Task Guard](https://maetra.io/es/docs/task-guard-api/tasks-and-context).
3. Examine el [referencia completa de API](https://maetra.io/es/docs/reference/api-reference).