Conecta tus herramientas a Nupav

Todas las conexiones acceden solo en modo lectura y aplican los mismos permisos que tienes en cloud.nupav.com: si no ves un proyecto en la plataforma, tampoco lo verá tu asistente.

Sección 1

Antes de empezar: tu User Key

Cualquier conexión requiere dos cosas:

1. Una cuenta Nupav activa (la misma con la que entras a cloud.nupav.com).
2. Una User Key: tu clave personal de acceso a la API.

Cómo crear tu User Key

1. Inicia sesión en cloud.nupav.com.
2. Abre tu Perfil y ve a la sección API Keys.
3. En Mis User Keys, haz clic en Crear nueva User Key y ponle un nombre que identifique dónde la usarás (ej: Claude, Power BI).
4. Guarda la clave generada (formato nupav_sk_...) en un lugar seguro.

Para los asistentes (Claude, ChatGPT, Gemini) basta con que la key exista y esté activa: el login es con tu usuario y contraseña de siempre. Para las conexiones programáticas (Power BI, Azystia) además usarás la key directamente.

Sección 2

Asistentes de IA

Tu asistente se conecta al servidor MCP de Nupav (https://mcp.nupav.com/mcp) mediante OAuth: inicias sesión una vez con tu cuenta de Nupav y el asistente queda autorizado para consultar tus datos en cada conversación.

2.1 Claude plan gratuito incluido

Claude soporta conectores personalizados en todos los planes, incluido el gratuito (con límite de 1 conector; los planes de pago permiten varios).

claude.ai (web y escritorio):

1. Ve a Ajustes → Conectores → Agregar conector personalizado.
2. Pega la URL: https://mcp.nupav.com/mcp (deja vacíos el Client ID y el secreto).
3. Haz clic en Conectar: se abrirá el login de cloud.nupav.com. Inicia sesión y autoriza.
4. En cualquier chat, activa el conector Nupav y pregunta por tus proyectos.

El conector configurado en claude.ai se sincroniza automáticamente con Claude Desktop y Claude Code.

Claude Code (terminal):

claude mcp add --transport http nupav https://mcp.nupav.com/mcp

1. Ejecuta el comando anterior una sola vez.
2. Dentro de una sesión, escribe /mcp, selecciona nupav y elige Authenticate.
3. Completa el login en el navegador y vuelve a la terminal.

2.2 ChatGPT

Opción A — GPT de Nupav cuenta gratuita basta

La vía más simple. Solo necesitas una cuenta de ChatGPT (gratuita o de pago) con sesión iniciada.

1. Solicita el enlace del GPT de Nupav a soporte@nupav.com (los GPTs por enlace no aparecen en el buscador de ChatGPT).
2. Abre el enlace con tu sesión de ChatGPT iniciada.
3. Pide algo de tus datos (ej: "muéstrame mi perfil de Nupav") y haz clic en el botón Sign in cuando aparezca.
4. Inicia sesión con tu cuenta de Nupav y vuelve al chat.

Opción B — Conector MCP requiere plan de pago

Para cuentas Plus, Pro o Business con modo desarrollador activado. Sin expiración horaria (usa refresh tokens).

1. Activa el Modo desarrollador: Configuración → Seguridad e inicio de sesión → Modo de desarrollador.
2. Crea el conector (en chatgpt.com/plugins o desde la sección de apps/conectores): nombre Nupav, endpoint MCP https://mcp.nupav.com/mcp, autenticación OAuth, sin Client ID ni secreto.
3. Completa el login de cloud.nupav.com y autoriza.
4. En workspaces Business: el administrador puede publicar el conector al espacio de trabajo para que todos los miembros lo usen sin configurarlo.

próximamente Nupav estará disponible como app en el directorio oficial de ChatGPT, accesible también para cuentas gratuitas sin configuración manual.

2.3 Gemini

La app de Gemini (gemini.google.com) aún no soporta conectores MCP personalizados. Las vías disponibles hoy:

Gemini CLI gratuito — agrega el servidor en la configuración (~/.gemini/settings.json):

{
  "mcpServers": {
    "nupav": {
      "httpUrl": "https://mcp.nupav.com/mcp"
    }
  }
}

Al iniciar Gemini CLI, ejecuta /mcp auth nupav para completar el login OAuth con tu cuenta de Nupav.

Gemini Enterprise plan empresa — el administrador puede registrar https://mcp.nupav.com/mcp como Custom MCP Server (data store) en la consola de Google Cloud, quedando disponible para los agentes del workspace.

Sección 3

Herramientas de datos

Las herramientas de BI y análisis se conectan directo a la API REST de Nupav usando tus claves — sin OAuth, ideal para reportes y refrescos programados.

3.1 Power BI

Power BI se conecta con tus dos claves (x-api-key y x-user-key, ambas visibles en tu Perfil → API Keys). Hay dos formas; recomendamos la Opción B porque soporta refresco programado en Power BI Service sin gateway local.

Opción A — "Obtener datos → Web" (modo gráfico)

Útil para pruebas rápidas en Power BI Desktop. No funciona bien para refresco programado en Power BI Service porque los headers del modo gráfico no se conservan al publicar.

1. Inicio → Obtener datos → Web, pestaña Avanzadas.
2. Completa los campos:

3. Aceptar.
4. Importante: en el diálogo del tipo de autenticación, elige "Anónimo". No elijas "API web" ni "Básica" — esas opciones sobrescriben los headers y la API responde "Acceso al recurso prohibido".
5. Power BI parsea el JSON automáticamente.

Opción B — Editor Avanzado con código M (recomendada)

Más robusta. Funciona igual en Desktop y en Power BI Service. Soporta refresco programado en la nube sin gateway local.

1. Inicio → Obtener datos → Consulta en blanco.
2. Inicio → Editor avanzado y pega:

let
    BaseUrl = "https://api.nupav.com",
    ApiKey  = "TU_API_KEY",
    UserKey = "TU_USER_KEY",
    Source = Json.Document(
        Web.Contents(
            BaseUrl,
            [
                RelativePath = "v1/projects/TU_PROJECT_ID/permits",
                Headers = [
                    #"x-api-key"  = ApiKey,
                    #"x-user-key" = UserKey
                ]
            ]
        )
    )
in
    Source

3. Cuando pida credenciales para https://api.nupav.com, elige "Anónimo".
4. Para que el refresco programado funcione en Power BI Service, el nivel de privacidad del origen tiene que ser Organización o Público (no Privado).

Power BI Service (Cloud) — refresco programado

Con la Opción B puedes publicar el reporte directamente a Power BI Service y programar el refresco sin gateway local. Solo asegúrate de elegir credencial Anónima para https://api.nupav.com en el dataset y setear el nivel de privacidad como Organización o Público. Con la Opción A, los headers no viajan al publicar y necesitas un Gateway de datos local.

Solución de problemas

Sección 4

Azystia

Azystia es un sistema operativo agéntico para tu empresa: un lugar donde todos tus datos se almacenan, se respaldan y se revisan continuamente mediante agentes de IA. Si un dato llega mal o aparece un error, eres el primero en enterarte.

Con Azystia tus datos pasan a ser realmente tuyos: infraestructura dedicada y separada físicamente de otras apps, datos revisados, ordenados y listos para ser consultados con la última tecnología de IA. Y tus asistentes — Claude, ChatGPT o Gemini — dejan de ver fragmentos: operan bajo el contexto de la información de toda tu empresa.

Los agentes de Azystia se conectan a Nupav mediante el mismo servidor MCP, usando tu User Key directamente (conexión servidor-a-servidor, sin login por navegador):

URL:    https://mcp.nupav.com/mcp
Header: Authorization: Bearer nupav_sk_...

Cualquier agente o aplicación compatible con MCP puede conectarse con este mismo esquema. Para incorporar Azystia en tu empresa, te invitamos a conectar con nuestro partner en azystia.com.

Sección 5

Tabla resumen de condiciones

En todos los casos se suma el requisito común: cuenta Nupav + User Key activa.

Sección 6

Preguntas frecuentes

¿Qué puede ver mi asistente?

Exactamente lo que tú puedes ver en cloud.nupav.com, ni más ni menos. La API aplica tus permisos en cada consulta. Todo el acceso es de solo lectura: ningún asistente puede crear, modificar ni borrar datos.

¿Cómo revoco el acceso?

Revoca la User Key en tu Perfil → API Keys. Todas las conexiones que dependían de ella (incluidas las sesiones OAuth de los asistentes) dejan de funcionar de inmediato. También puedes eliminar el conector desde el propio asistente.

¿Es seguro?

El login siempre ocurre en cloud.nupav.com — ninguna herramienta ve tu contraseña. Tu User Key es personal: no la compartas ni la publiques. Si crees que se filtró, revócala y crea una nueva.

¿Necesito ayuda?

Escríbenos a soporte@nupav.com.