noxxa / Documentación

Conector MCP

Pregúntale a tu wiki desde Claude, ChatGPT o Claude Code.

El conector MCP deja que cada miembro le pregunte a la wiki de su espacio desde su propio asistente — Claude, ChatGPT o Claude Code — sin entrar a noxxa. El asistente trae una herramienta nueva, ask_wiki, que por dentro es el mismo agente de noxxa: responde con citas a las páginas que respaldan la respuesta.

Es de solo lectura y hereda tus permisos: ves exactamente lo mismo que verías en el chat de noxxa, ni más ni menos. Cada persona se conecta con su propia cuenta.

¿Quién activa qué? El admin del espacio enciende el conector una vez (Admin → Conector MCP). Después, cada miembro lo agrega a su propio Claude o ChatGPT con su cuenta. Mientras el admin no lo active, nadie puede conectarse.

Cómo funciona

Tu asistente (Claude / ChatGPT)  ──►  ask_wiki  ──►  agente de noxxa  ──►  tu wiki
        ▲                                                                      │
        └──────────────── respuesta con citas ◄───────────────────────────────┘
  1. El admin activa el conector en Admin → Conector MCP.
  2. Copias la URL del servidor MCP de ese mismo panel.
  3. La pegas en tu asistente como "conector remoto" / "custom connector".
  4. La primera vez, tu asistente te manda a iniciar sesión en noxxa (OAuth). Apruebas una vez.
  5. Listo: le preguntas en lenguaje natural y el asistente usa ask_wiki cuando necesita algo de la wiki.

La URL de tu espacio

Cada espacio tiene su propia URL, con esta forma:

https://app.noxxa.cl/api/mcp/tu-espacio/mcp

Donde tu-espacio es el identificador de tu workspace (el mismo que aparece en la dirección cuando usas noxxa: app.noxxa.cl/tu-espacio/...). No necesitas armarla a mano: el panel Admin → Conector MCP muestra la URL exacta de tu espacio con un botón Copiar.

La URL no es secreta — no da acceso por sí sola. El control está en el inicio de sesión: quien la pegue tiene que entrar con su cuenta de noxxa y ser miembro del espacio. Sin sesión válida, el servidor responde "no autorizado".

Agregarlo a Claude (web o escritorio)

  1. En Claude, abre Configuración → Conectores (Settings → Connectors).
  2. Agregar conector personalizado (Add custom connector).
  3. Pega la URL de tu espacio y confirma con Agregar.
  4. Para usarlo en una conversación: botón + del cuadro de mensaje → Conectores → activa noxxa.
  5. La primera vez se abre el login de noxxa. Inicia sesión y aprueba el acceso.

Planes Claude: el plan Free permite 1 conector personalizado; Pro y Max no tienen límite. En Team/Enterprise, el owner agrega el conector desde la configuración de la organización y luego cada miembro entra a Conectores → Conectar para iniciar su propia sesión.

Agregarlo a Claude Code (terminal)

Un solo comando, reemplazando la URL por la de tu espacio:

claude mcp add --transport http noxxa https://app.noxxa.cl/api/mcp/tu-espacio/mcp

Después, dentro de Claude Code:

/mcp

Selecciona noxxa → Authenticate. Se abre el navegador para iniciar sesión en noxxa; al aprobar, el estado pasa a Connected. Desde ahí ya puedes pedirle que consulte la wiki.

Agregarlo a ChatGPT

ChatGPT soporta conectores MCP en modo desarrollador (Developer mode).

  1. Configuración → Apps → Configuración avanzada y activa Modo desarrollador.
  2. Crear app (Create app).
  3. Completa Nombre (noxxa), una Descripción breve (ej: "Wiki corporativa de mi empresa") y en URL del conector pega la URL de tu espacio.
  4. Crear. Si conecta bien, verás la herramienta ask_wiki disponible.
  5. Para usarlo: botón + → Más → selecciona noxxa.

Planes ChatGPT: el modo desarrollador está disponible en Plus, Pro, Business, Enterprise y Education. La primera vez que el asistente use ask_wiki, ChatGPT puede pedirte que confirmes ejecutar la herramienta — es normal, apruébalo. Es una función en beta de OpenAI, así que los nombres de menú pueden cambiar.

Activar o desactivar (admin)

Desde Admin → Conector MCP ves el estado actual y un botón para activarlo o desactivarlo:

Conector MCPActivado
Conector MCPDesactivado

Antes de activarlo. Al encenderlo, cualquier miembro podrá consultar desde su asistente externo todo el contenido al que ya tiene acceso en el espacio, y ese contenido se envía al cliente (Claude/ChatGPT) para construir la respuesta. Revisa que las áreas sensibles estén marcadas como restringidas antes de habilitar. Ver Seguridad y privacidad.

Desactivarlo corta el acceso de inmediato para todos: las consultas desde asistentes externos dejan de funcionar al instante.

Si algo no conecta

MensajeQué significaQué hacer
No autorizado / 401No iniciaste sesión, o tu token de acceso venció o es inválido.Inicia sesión de nuevo; en Claude Code, corre /mcp → Authenticate.
El asistente pide login una y otra vezLa sesión OAuth no se completó.Reintenta el inicio de sesión; en Claude Code, corre /mcp → Authenticate de nuevo.
forbidden: no eres miembro de este espacioTu sesión es válida, pero esa cuenta no pertenece al espacio que apuntas en la URL.Entra con la cuenta que sí es miembro, o revisa que la URL tenga el identificador correcto de tu espacio.
forbidden: el conector MCP no está habilitado para este espacioEl admin aún no encendió el conector.Pídele al admin que lo active en Admin → Conector MCP.
quota_exceeded: alcanzaste tu límite de consultas vía conectorLlegaste a tu tope personal de 50 consultas por conector en las últimas 24 horas.Espera a que la ventana de 24 h libere cupo, o usa el chat de noxxa mientras tanto.
quota_exceeded: cuota mensual del espacio alcanzadaEl espacio agotó su presupuesto mensual de consumo.Pídele al admin que revise o suba el límite de gasto en Admin → Uso.
Tu misma consulta ya se está procesando; reintenta en unos segundos.Hiciste la misma pregunta dos veces seguidas y la primera todavía corre.Espera unos segundos y vuelve a preguntar.

Límites y cuotas

  • Tope personal: cada miembro puede hacer hasta 50 consultas vía conector cada 24 horas (ventana móvil). Es un límite por persona, para que un asistente que llame ask_wiki en cada turno no se coma el presupuesto del espacio sin que nadie lo vea. Al pasarte, el conector responde quota_exceeded: alcanzaste tu límite de consultas vía conector.
  • Presupuesto del espacio: las consultas por conector consumen la misma cuota mensual que el chat web (tokens y gasto en USD). Si el espacio agota su presupuesto del mes, el conector responde quota_exceeded: cuota mensual del espacio alcanzada. El admin lo revisa o ajusta en Admin → Uso.
  • Pregunta repetida: si haces exactamente la misma pregunta mientras la anterior todavía se procesa, el conector te avisa que ya está en curso. Si la respuesta acaba de generarse, puede devolverte el resultado en caché sin volver a correr el agente.

El conector usa el mismo modelo que el chat web (Sonnet 4.6) y responde exactamente lo mismo que verías ahí, porque por dentro corre el agente de noxxa con tus permisos.

Lo que el conector no hace

  • No escribe en tu wiki — solo consulta.
  • No salta tus permisos: si no puedes ver un área en noxxa, tampoco la verás desde tu asistente.
  • No expone el espacio a desconocidos: sin tu sesión de noxxa, la URL no responde nada útil.
  • No está disponible en espacios demo: en los espacios de prueba (sandbox) el conector está deshabilitado y el admin no puede encenderlo.

WhatsApp

Vincula tu teléfono al número de noxxa y hazle preguntas a tu wiki desde WhatsApp.

Mantenimiento

Lint nocturno, contexto de empresa, miembros y acceso — para que la wiki no envejezca.

En esta página

Cómo funcionaLa URL de tu espacioAgregarlo a Claude (web o escritorio)Agregarlo a Claude Code (terminal)Agregarlo a ChatGPTActivar o desactivar (admin)Si algo no conectaLímites y cuotasLo que el conector no hace