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

# Configura MCP

> Conecta Glasser a tu herramienta de IA e inicia sesión con tu cuenta.

MCP permite que tu herramienta de IA use Glasser directamente. Conecta tu cuenta para buscar datos, consultar precios y recuperar resultados en tus conversaciones. No necesitas instalar Glasser CLI.

## Elige tu herramienta de IA

> [card] [Claude Code](https://glasser.ai/docs/es/mcp-server/claude-code.md)
>
> Añade Glasser desde tu terminal e inicia sesión desde Claude Code.

> [card] [Codex](https://glasser.ai/docs/es/mcp-server/codex.md)
>
> Conecta clientes Codex locales con una configuración MCP compartida.

> [card] [Claude.ai](https://glasser.ai/docs/es/mcp-server/claude.md)
>
> Conecta Claude en la web o en la aplicación de escritorio, incluido Cowork.

> [card] [ChatGPT](https://glasser.ai/docs/es/mcp-server/chatgpt.md)
>
> Conecta Glasser como plugin y usa datos de pago en ChatGPT.

> [card] [Manus](https://glasser.ai/docs/es/mcp-server/manus.md)
>
> Conecta Glasser y usa datos de pago en tus investigaciones e informes.

> [card] [Cursor](https://glasser.ai/docs/es/mcp-server/cursor.md)
>
> Añade Glasser a Cursor y habilítalo para tu agente.

> [card] [OpenCode](https://glasser.ai/docs/es/mcp-server/opencode.md)
>
> Añade Glasser a tu configuración de OpenCode e inicia sesión desde la terminal.

> [card] [VS Code](https://glasser.ai/docs/es/mcp-server/vscode.md)
>
> Añade Glasser a GitHub Copilot Chat en VS Code.

> [card] [Otros clientes](https://glasser.ai/docs/es/mcp-server/other.md)
>
> Conéctate mediante la URL del servidor o usa una Key de Glasser existente.

## ¿Ya conoces la configuración de tu cliente?

Usa esta URL del servidor y elige el inicio de sesión con OAuth:

```text theme={null}
https://api.glasser.ai/mcp
```

Inicia sesión en Glasser, elige el Workspace cuyo saldo puede usar el cliente y selecciona **Allow**. Puedes crear una cuenta y un Workspace durante el inicio de sesión. Si tu cliente no puede usar OAuth, sigue la guía de [Otros clientes](https://glasser.ai/docs/es/mcp-server/other.md) para conectarte con una Key.

## Comprueba la conexión

Pregunta a tu herramienta de IA:

```text wrap theme={null}
Suggest one small task I can try with Glasser. Check my available balance and mention any first-run reward returned. Explain what the task will do, then wait for me to choose it before a paid Run.
```

Una respuesta con el saldo confirma que la conexión funciona, aunque el saldo disponible sea cero. La comprobación es gratuita. Si tu saldo disponible no cubre la tarea, añade fondos en la [consola de Glasser](https://app.glasser.ai).

## Primera tarea y recompensas

Después de la configuración, tu agente recomienda una tarea pequeña y espera a que la elijas. Luego sigue las reglas de precios y aprobación de la herramienta antes de ejecutar un Run de pago. Si ya solicitaste una tarea, continúa con ella.

Una respuesta con el saldo puede incluir `first_run_reward` con `amount_usd`, `expires_at` y un `description` generado por el servidor para indicar el estado actual de tu recompensa. El agente transmite este mensaje en tu idioma junto con su sugerencia de tarea. Si el campo no está presente, no menciona las recompensas. Usa la respuesta del saldo obtenida durante la configuración, en lugar de realizar llamadas adicionales solo para consultar las recompensas.

## Gestiona el acceso

El inicio de sesión en el navegador crea una Key llamada `MCP · <client>` en tu Workspace. Para retirar el acceso del cliente, revoca esa Key en la [página de Keys](https://app.glasser.ai/keys).
Desconectar o eliminar Glasser únicamente desde el cliente no revoca la Key.

## Endpoint

```
POST https://api.glasser.ai/mcp
```

Usa **Streamable HTTP**. Autentícate mediante el inicio de sesión en el navegador o envía una Key de Glasser en el encabezado `Authorization: Bearer`.

> [accordion] Detalles del transporte y la autenticación
>
> El servidor no mantiene estado y devuelve respuestas JSON. Cada solicitud incluye una Key o un token de acceso OAuth que resuelve a una Key de Workspace.
>
> Los clientes OAuth descubren el servidor de autorización desde `resource_metadata` en el encabezado `WWW-Authenticate` de una respuesta `401`. Solo necesitan la URL del servidor para iniciar este flujo.

## Herramientas

Glasser expone siete herramientas. El Agent usa `search` para descubrir Endpoints y, después, `inspect` y `run` para recuperar datos. Cada Endpoint no requiere una herramienta MCP independiente.

| Tool | Purpose |
| - | - |
| `search` | Busca los Endpoints que tu Key puede ejecutar. |
| `inspect` | Obtiene el esquema de entrada, el Price actual, la versión y el modo de ejecución de un Endpoint. |
| `run` | Ejecuta un Endpoint. Requiere un `idempotency_key`. |
| `runs_get` | Consulta el estado, la Provider response y el cargo de un Run. |
| `runs_list` | Revisa los Runs, empezando por los más recientes, con paginación. |
| `runs_stop` | Solicita una detención. Comprueba el estado devuelto para saber si se detuvo. |
| `balance` | Consulta los fondos disponibles y confirma la conexión. |

## Reglas para mantener el gasto bajo control

El servidor proporciona estas instrucciones al Agent, igual que la [Skill](https://glasser.ai/docs/es/setup-skill.md) para los agentes de CLI:

* **Usa primero las conexiones existentes.** Usa Glasser cuando tus propias Keys e integraciones no cubran la solicitud.
* **Comprueba antes de gastar.** Consulta el Price, empieza con solicitudes pequeñas y obtén aprobación antes de realizar Runs especulativos, repetidos o masivos.
* **Reintenta con la misma Key.** Conserva el `idempotency_key` y los parámetros de ejecución para recuperar el Run original sin un segundo cargo.
* **Lee el estado y el cargo por separado.** Comprueba `provider_response` y `charge_usd`, incluso en un Run `COMPLETED`.

> [accordion] Reintentos y respuestas de error
>
> Un Run de MCP repetido incluye `replayed: true`. Los importes de `charge_usd` son cadenas decimales exactas en USD. Un 404 del proveedor puede corresponder a un Run `COMPLETED` cuyo cargo se aplica según la regla `NO_RESULT` del Endpoint.
>
> Los errores del proveedor permanecen en `provider_response.http_status` y `provider_response.error` del Run. Comprueba estos campos incluso cuando el resultado de la herramienta no tenga el indicador `isError`. Usa `runs_get` para obtener el cuerpo completo del error; `runs_list` devuelve resúmenes.
>
> Las denegaciones procesables, como `insufficient_balance`, `rate_limited` y las restricciones de Policy, devuelven resultados de la herramienta con `isError`. No son errores de protocolo. Para los límites de frecuencia, lee `retry_after_ms` antes de reintentar.

## Cuándo elegir CLI

Para agentes locales como Claude Code, Codex y Cursor, se recomienda usar la [Skill](https://glasser.ai/docs/es/setup-skill.md) junto con [CLI](https://glasser.ai/docs/es/cli.md). La Skill guía la configuración y aplica las reglas operativas.
Para Claude Chat y Cowork, sigue la [guía del conector](https://glasser.ai/docs/es/mcp-server/claude.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.