Documentación

Conecta tu agente a OmniAi (MCP)

OmniAi habla MCP (Model Context Protocol), el estándar que usan Claude, Cursor y otros asistentes para conectarse a servicios externos. Con una clave de tu cuenta, tu agente puede preguntar, crear apuntes, traducir y generar imágenes y vídeos por ti.

1. Crea tu clave

Entra en Ajustes → «Integraciones de agentes».
Ponle un nombre a la clave y elige sus permisos (ver abajo).
Pulsa «Crear clave» y cópiala: empieza por omniai_mcp_ y solo se muestra una vez.

Las claves requieren un plan de pago activo. Puedes anular cualquier clave al instante desde la misma página.

2. Conecta el agente

La dirección del servidor es:

https://<tu-dirección-de-OmniAi>/api/public/mcp

Ejemplo de configuración (formato habitual de Claude y Cursor):

{
  "mcpServers": {
    "omniai": {
      "type": "http",
      "url": "https://<tu-dirección-de-OmniAi>/api/public/mcp",
      "headers": {
        "Authorization": "Bearer omniai_mcp_TU_CLAVE"
      }
    }
  }
}

3. Permisos de cada clave

Al crear la clave eliges lo que el agente puede hacer. Si una clave intenta usar una herramienta sin permiso, el servidor la rechaza.

💬 Preguntas, apuntes y traducción — omniai_ask, omniai_study_notes, omniai_translate
🖼️ Imágenes — omniai_generate_image
🎬 Vídeos — omniai_generate_video, omniai_video_status

4. Herramientas disponibles

Herramienta	Qué hace	Parámetros
`omniai_ask`	Responde cualquier pregunta con razonamiento profundo.	`prompt`, `lang?`
`omniai_study_notes`	Convierte un texto en apuntes: resumen, esquema y preguntas de repaso.	`text`, `lang?`
`omniai_translate`	Traduce a cualquier idioma manteniendo tono y formato.	`text`, `lang`
`omniai_generate_image`	Genera una imagen y devuelve su URL.	`prompt`
`omniai_generate_video`	Lanza un vídeo HD de 8 s y devuelve un identificador.	`prompt`, `aspectRatio?`
`omniai_video_status`	Consulta el vídeo; al terminar devuelve la URL de descarga.	`id`

Los vídeos tardan entre 1 y 3 minutos: llama a omniai_generate_video y luego consulta omniai_video_status cada 10 segundos hasta obtener la URL. Descárgala enseguida, porque caduca al cabo de una hora.

5. Probar a mano (opcional)

curl -X POST "https://<tu-dirección-de-OmniAi>/api/public/mcp" \
  -H "Authorization: Bearer omniai_mcp_TU_CLAVE" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"omniai_ask","arguments":{"prompt":"Resume la fotosíntesis","lang":"es"}}}'

¿Problemas? Escríbenos desde el botón de ayuda de la esquina o revisa el estado del servicio.