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

# Configuración para desarrolladores

Saga está disponible como servidor [MCP](https://modelcontextprotocol.io), para que los agentes y asistentes de IA — Claude, ChatGPT, Cursor y agentes personalizados — puedan usar su espacio de trabajo de Saga como una herramienta. El agente puede hacer preguntas a Saga, buscar y leer documentos de proyectos, y ejecutar sus flujos de trabajo, todo utilizando su propio acceso.

Esto es lo contrario de conectar servidores MCP externos a Saga. Aquí, su espacio de trabajo de Saga *es* el servidor al que se conectan otras herramientas.

## Antes de empezar

Necesita:

* Su **URL de la plataforma** y una **clave API**. Ambas provienen de **Configuración > Gestión de claves API** dentro de Saga. Abra la página, cree una clave si no tiene una y copie ambos valores.
* Un cliente MCP que admita el transporte HTTP por streaming (Claude Desktop, Claude Code, Cursor o cualquier agente personalizado creado sobre el SDK de MCP).

<Note>
  Cada cliente tiene su propio dominio de Saga, por lo que su punto de conexión MCP es su propia URL de la plataforma con `/api/mcp` añadido. Use la URL de la plataforma que se muestra en **Configuración > Gestión de claves API** — no adivine el dominio.
</Note>

## Conectar un cliente

La mayoría de los clientes solo necesitan la URL del punto de conexión y un encabezado `Authorization`.

* **Punto de conexión:** `https://<your-domain>.sagalegal.io/api/mcp`
* **Encabezado:** `Authorization: Api-Key <your-api-key>`

Para un cliente que lee un archivo `.mcp.json` (por ejemplo, Claude Code), añada:

```json theme={null}
{
  "mcpServers": {
    "saga": {
      "type": "http",
      "url": "https://<your-domain>.sagalegal.io/api/mcp",
      "headers": { "Authorization": "Api-Key <your-api-key>" }
    }
  }
}
```

Reemplace `<your-domain>` con su URL de la plataforma y `<your-api-key>` con la clave de **Configuración > Gestión de claves API**.

<Note>
  Algunos clientes solo le permiten pegar un token bearer. En ese caso, use `Authorization: Bearer <your-api-key>` en su lugar — Saga acepta su clave API en cualquiera de los dos formatos.
</Note>

## Qué puede hacer el agente

Una vez conectado, el agente dispone de estas herramientas:

| Herramienta                | Qué hace                                                                                 |
| -------------------------- | ---------------------------------------------------------------------------------------- |
| `ask_saga`                 | Hace una pregunta a Saga y devuelve la respuesta, igual que al chatear en la aplicación. |
| `list_projects`            | Lista sus proyectos, incluidos los compartidos con usted.                                |
| `list_project_documents`   | Lista los documentos de un proyecto.                                                     |
| `search_project_documents` | Busca en la base de conocimiento de un proyecto y devuelve las secciones más relevantes. |
| `fetch_project_document`   | Devuelve el texto completo de un documento.                                              |
| `list_workflows`           | Lista sus flujos de trabajo y las entradas que espera cada uno.                          |
| `execute_workflow`         | Ejecuta un flujo de trabajo con entradas de texto y devuelve el resultado.               |

Cada herramienta se ejecuta en su nombre. El agente solo ve los proyectos, documentos y flujos de trabajo a los que su cuenta ya puede acceder — los mismos permisos que tiene en la aplicación web.

## Seguridad

* Trate su clave API como una contraseña. Cualquier persona con la clave y su URL de la plataforma puede actuar en su nombre a través de Saga.
* Renueve o revoque la clave en cualquier momento desde **Configuración > Gestión de claves API**. Revocarla detiene inmediatamente cualquier agente conectado.
* Si una clave pudo haberse filtrado, revóquela y cree una nueva, luego actualice la configuración de su cliente.

## Solución de problemas

* **El cliente no puede conectarse o devuelve 401 Unauthorized** — compruebe que el punto de conexión termina en `/api/mcp`, que el encabezado es `Authorization: Api-Key <your-api-key>` y que la clave no ha expirado ni ha sido revocada. Cree una clave nueva en **Configuración > Gestión de claves API** si es necesario.
* **Un flujo de trabajo aparece como pausado** — los flujos de trabajo que esperan una entrada a mitad de proceso no pueden reanudarse a través de MCP, y las entradas de archivos no son compatibles. Ejecútelos desde la aplicación de Saga en su lugar.