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

# Conectar el MCP

> Agrega Pruff como conector en Claude, ChatGPT u otro cliente MCP.

## Antes de empezar

Necesitas tres cosas:

1. **Tu empresa habilitada.** La habilita el equipo de Pruff: solicítala a tu contacto en Pruff. Te entregarán la dirección de tu empresa, con la forma `https://<tu-empresa>.mcp.pruff.com/mcp`.
2. **Tu cuenta de Pruff.** El mismo usuario y contraseña con que entras a `app.pruff.com`.
3. **Un cliente MCP con conectores remotos.** Por ejemplo, Claude o ChatGPT en un plan que permita agregar conectores personalizados.

## Claude

**1. Abre los conectores**

En `claude.ai`, abre **Settings → Connectors**.

![Lista de conectores en la configuración de Claude](https://mintcdn.com/pruff/3JvV2SDPVWCSbE4M/images/mcp/claude-conectores.png?fit=max\&auto=format\&n=3JvV2SDPVWCSbE4M\&q=85\&s=6e656115a55b5e6be750d216a1201cd1)

**2. Agrega un conector personalizado**

Haz clic en **+** y luego en **Add custom connector**.

![Menú para agregar un conector personalizado en Claude](https://mintcdn.com/pruff/3JvV2SDPVWCSbE4M/images/mcp/claude-agregar.png?fit=max\&auto=format\&n=3JvV2SDPVWCSbE4M\&q=85\&s=60d80c5d307452f000076ed573846117)

**3. Completa el formulario**

* **Nombre:** `Pruff`
* **URL:** la dirección de tu empresa, `https://<tu-empresa>.mcp.pruff.com/mcp`

Deja vacíos el Client ID y el Client Secret de OAuth: Claude se registra solo.

![Formulario Add custom connector con el nombre Pruff y la URL del servidor](https://mintcdn.com/pruff/3JvV2SDPVWCSbE4M/images/mcp/claude-formulario.png?fit=max\&auto=format\&n=3JvV2SDPVWCSbE4M\&q=85\&s=830c95b623798404c20b9de098aaa524)

**4. Inicia sesión y autoriza**

Haz clic en **Add** y luego en **Connect**. Se abre el inicio de sesión de Pruff. Ingresa con tu cuenta y, en la pantalla de autorización, revisa los permisos y haz clic en **Autorizar**.

![Pantalla de autorización de Pruff con la lista de permisos de solo lectura y los botones Cancelar y Autorizar](https://mintcdn.com/pruff/3JvV2SDPVWCSbE4M/images/mcp/autorizacion.png?fit=max\&auto=format\&n=3JvV2SDPVWCSbE4M\&q=85\&s=ccb6a3457c3745baa7bbeec9f6416089)

Si ya tenías una sesión abierta en Pruff, no te pide la contraseña, solo la autorización.

**5. Pregunta**

Abre una conversación, activa el conector de Pruff y escribe tu pregunta.

![Conversación en Claude que usa la herramienta Cartera de Pruff](https://mintcdn.com/pruff/3JvV2SDPVWCSbE4M/images/mcp/claude-uso.png?fit=max\&auto=format\&n=3JvV2SDPVWCSbE4M\&q=85\&s=647051ac8fe7957bf07ee8dd801aed4a)

## ChatGPT

> [!WARNING]
>
> ChatGPT pide activar el **modo desarrollador** para agregar un servidor MCP propio. La ubicación de los menús puede cambiar según tu versión de ChatGPT.

**1. Abre las apps**

En `chatgpt.com`, abre **Settings → Apps**.

![Sección Apps en la configuración de ChatGPT](https://mintcdn.com/pruff/3JvV2SDPVWCSbE4M/images/mcp/chatgpt-apps.png?fit=max\&auto=format\&n=3JvV2SDPVWCSbE4M\&q=85\&s=2df8f64b5f677f140616cbd54ac557da)

**2. Activa el modo desarrollador**

Entra a **Advanced settings** y activa **Developer mode**.

![Interruptor Developer mode activado en ChatGPT](https://mintcdn.com/pruff/3JvV2SDPVWCSbE4M/images/mcp/chatgpt-modo-desarrollador.png?fit=max\&auto=format\&n=3JvV2SDPVWCSbE4M\&q=85\&s=da64385f931951adf717ddb4084ee214)

**3. Crea la app**

Vuelve a **Apps** y haz clic en **Create app**.

![Botón Create app en la sección Apps de ChatGPT](https://mintcdn.com/pruff/3JvV2SDPVWCSbE4M/images/mcp/chatgpt-crear-app.png?fit=max\&auto=format\&n=3JvV2SDPVWCSbE4M\&q=85\&s=fe61116ea9a87b558453e169e56a423b)

**4. Completa el formulario**

* **Icon:** opcional. Puedes usar el [ícono de Pruff](https://docs.pruff.com/images/mcp/pruff-icono.png).
* **Name:** `Pruff`
* **Server URL:** la dirección de tu empresa, `https://<tu-empresa>.mcp.pruff.com/mcp`
* **Authentication:** OAuth

Marca la casilla de confirmación y haz clic en **Create**.

![Formulario New App de ChatGPT con la URL del servidor y autenticación OAuth](https://mintcdn.com/pruff/3JvV2SDPVWCSbE4M/images/mcp/chatgpt-formulario.png?fit=max\&auto=format\&n=3JvV2SDPVWCSbE4M\&q=85\&s=56f764ed9f82b9a660e47ad8dd7c3e31)

**5. Inicia sesión y autoriza**

Haz clic en **Sign in with Pruff**. Ingresa con tu cuenta y, en la pantalla de autorización de Pruff, haz clic en **Autorizar**.

![Ventana Add Pruff to ChatGPT con el botón Sign in with Pruff](https://mintcdn.com/pruff/3JvV2SDPVWCSbE4M/images/mcp/chatgpt-iniciar-sesion.png?fit=max\&auto=format\&n=3JvV2SDPVWCSbE4M\&q=85\&s=476ec1e14f2646b7c84cd18cbbe7c4b2)

**6. Pregunta**

Abre un chat, activa el conector de Pruff y escribe tu pregunta.

![Chat de ChatGPT que llama una herramienta de Pruff](https://mintcdn.com/pruff/3JvV2SDPVWCSbE4M/images/mcp/chatgpt-uso.png?fit=max\&auto=format\&n=3JvV2SDPVWCSbE4M\&q=85\&s=dfcbddd7e86aa3a1d9d8a0870fd48121)

## Otros clientes MCP

Cualquier cliente que soporte servidores MCP remotos con OAuth puede conectarse. Estos son los datos técnicos del servidor:

| | |
| - | - |
| Endpoint MCP | `https://<tu-empresa>.mcp.pruff.com/mcp` (Streamable HTTP, sin estado entre requests) |
| Descubrimiento | `/.well-known/oauth-protected-resource/mcp` y `/.well-known/oauth-authorization-server`, en el mismo host |
| Registro del cliente | Dinámico, en `/register` |
| Flujo OAuth | Authorization code con PKCE `S256` |
| Scope | `mcp:read` |
| Token de acceso | JWT `Bearer`, válido por 1 hora |
| Refresh token | Válido por 30 días. Cada uso entrega uno nuevo e invalida el anterior. |

El issuer de OAuth es el host de tu empresa (`https://<tu-empresa>.mcp.pruff.com`), y el token solo es válido en ese host. Si el token falta, venció o es inválido, `/mcp` responde `401` con el header `WWW-Authenticate`, que apunta a la metadata de descubrimiento para que el cliente vuelva a autorizar:

```text theme={null}
WWW-Authenticate: Bearer error="invalid_token", resource_metadata="https://<tu-empresa>.mcp.pruff.com/.well-known/oauth-protected-resource/mcp"
```


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