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

# Conectar un cliente

> Conecta un cliente MCP compatible con OAuth mediante el inicio de sesión y la autorización en Console.

Usa `https://api.muveya.com/mcp` como URL del servidor Streamable HTTP en un cliente MCP que admita autorización OAuth. No necesitas una API key para MCP. Las API keys siguen autenticando la API separada `/v1`.

## Conectar

1. Agrega la URL del servidor a tu cliente MCP y elige su opción de inicio de sesión con OAuth.
2. El cliente descubre el servidor de autorización de Muveya y abre el navegador. Si no has iniciado sesión, Muveya Console te pide que ingreses primero.
3. Elige la clínica dental cuyos datos quieres compartir. Revisa el nombre de la aplicación y los permisos solicitados en **Autorizar una conexión MCP**.
4. Selecciona **Autorizar** para conceder el acceso mostrado o **Rechazar** para cancelar. El navegador vuelve al cliente MCP. Luego, el cliente envía su token de acceso automáticamente.

La conexión solo puede usar los permisos concedidos a la aplicación y que también conserva tu membresía actual en la clínica dental. Si se elimina tu membresía o se revoca el acceso de la aplicación, las llamadas siguientes dejan de funcionar. Cada conexión corresponde a una sola clínica dental.

## Permisos disponibles

| Scope OAuth | Permite |
| - | - |
| `inventory:read` | Listar sedes y consultar existencias. |
| `catalog:read` | Buscar en el catálogo. |
| `catalog.cost:read` | Incluir costos del catálogo y de líneas de pedidos, si tu membresía también lo permite. |
| `orders:read` | Leer pedidos por ID. |
| `analytics:read` | Leer consumo y cifras gerenciales. |

También se admiten `clinics:read` y `fulfillment:read`, aunque ninguna herramienta MCP actual los requiere. Las tres herramientas personales que requieren `approvals.decide` o `fulfillment.pick` todavía no están disponibles en esta conexión OAuth de solo lectura. Consulta las [herramientas MCP](/docs/es/mcp/tools).

## Si falla la conexión

| Lo que ves | Qué hacer |
| - | - |
| Pantalla de ingreso | Inicia sesión y luego elige una clínica dental para continuar. |
| Solicitud de autorización no válida | Inicia la conexión de nuevo desde el cliente MCP. |
| Permiso no disponible | Pide a la administración de tu clínica que revise tu membresía. La autorización no puede conceder un permiso que no tienes. |
| `401` de `/mcp` | Vuelve a conectar mediante OAuth. Una API key o un token de otro servidor no funciona. |
| La herramienta devuelve `common.forbidden` | Revisa el permiso que pide esa herramienta y vuelve a conectar con un scope permitido. |

Para un cliente propio, sigue el flujo OAuth 2.1 de código de autorización con PKCE y los metadatos del recurso protegido de Muveya. El cliente obtiene y guarda el token de acceso. No pegues el token en un chat ni en una configuración compartida.


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