API pública

Conectar un asistente de IA (MCP)

Crea una clave de API solo con los permisos que el asistente necesita y dale al cliente la dirección https://api.mosaqo.app/v1/mcp con esa clave como token bearer. El asistente puede hacer exactamente lo que la clave permite y nada más, y puedes desconectarlo cuando quieras en Bulk & API.

Revisado 20 de agosto de 2026

Pasos

1. Abre Bulk & API → API keys y crea una clave. Concede primero permisos de solo lectura; emitirás otra con escritura cuando sepas qué hace el asistente.
2. Copia la dirección desde el bloque AI assistants (MCP) de esa misma pantalla.
3. En el asistente, añade un servidor con esa dirección y envía la clave en la cabecera Authorization: Bearer. La mayoría de los clientes acepta un bloque JSON con url y headers.
4. Algunos conectores te piden iniciar sesión en Mosaqo en lugar de pegar una clave. Ese camino muestra quién pide, a qué espacio afectaría y qué podría hacer, antes de conceder nada — solo un propietario o administrador puede aprobarlo.
5. Pregúntale al asistente qué puede hacer. Listará las herramientas que tu clave permite, que es la confirmación más rápida de que la conexión está tan acotada como querías.

Cómo comprobar el resultado

Pregunta algo que solo este espacio sepa: cuántos códigos tienes, o cómo va una encuesta. Una respuesta con tus nombres y cifras reales significa que la conexión funciona; una negativa que nombra un permiso significa que la clave es más estrecha que la pregunta.

Lo que suele salir mal

• Dar escritura ya en la primera clave. Empieza en solo lectura y amplía cuando sepas qué hace con ella.
• Esperar que lea lo que la gente escribió en una encuesta. Esas respuestas no se entregan ni a una clave ni a un asistente — las puntuaciones y los recuentos sí, las frases se quedan en la bandeja.
• Esperar que borre un código. No puede: destruir la redirección de un código impreso es irreversible, así que se le ofrece archivar, que sí se revierte.
• Olvidar una conexión. Un asistente conectado por inicio de sesión mantiene el acceso hasta que se desconecta en Bulk & API, igual que una clave vale hasta que se revoca.