Saltar al contenido principal
Krea ofrece un servidor Model Context Protocol (MCP) alojado para agentes y asistentes de programación. Úsalo cuando quieras que un cliente compatible con MCP llame a Krea directamente en lugar de escribir las solicitudes a la API a mano.
No necesitas una clave de API para conectarte. Añade https://api.krea.ai/mcp como URL del servidor MCP y luego inicia sesión con tu cuenta de Krea mediante el flujo de OAuth de tu cliente.

Detalles del servidor

ConfiguraciónValor
TransporteStreamable HTTP
URLhttps://api.krea.ai/mcp
AutenticaciónOAuth
La facturación depende de cómo te autentiques:
Método de autenticaciónOrigen de la facturación
OAuthLas unidades de cómputo de la cuenta de Krea con la que iniciaste sesión
Token de APIEl saldo de API independiente de tu workspace

Autenticación

La mayoría de los clientes MCP usan OAuth automáticamente. Cuando el cliente te pida conectarte, sigue el flujo de inicio de sesión en el navegador y autoriza Krea. El uso con OAuth se factura a la cuenta de Krea con la que iniciaste sesión usando unidades de cómputo. Si tu cliente MCP no admite OAuth, puedes autenticarte con un token de API en su lugar:
Clave del encabezadoValor del encabezado
AuthorizationBearer KREA_API_TOKEN
Reemplaza KREA_API_TOKEN con un token de krea.ai/app/api/tokens. Solo los propietarios y administradores del workspace pueden crear tokens de API. El uso con token de API se factura al saldo de API de tu workspace, igual que las llamadas directas a la API. Consulta Claves de API y facturación para conocer los detalles del saldo de API.
Almacena las credenciales MCP basadas en tokens de API de la misma forma que almacenas las claves de API. No confirmes archivos de configuración MCP que contengan tokens reales.

Claude Code

Ejecuta este comando en tu terminal:
claude mcp add --transport http krea-ai https://api.krea.ai/mcp
Inicia sesión con tu cuenta de Krea cuando Claude Code te pida conectarte. Reinicia Claude Code o recarga tus servidores MCP después de añadir el servidor.

Codex

  1. Abre Settings > MCP servers en Codex.
  2. Añade un nuevo servidor.
  3. Selecciona Streamable HTTP como transporte.
  4. Pega la URL del servidor:
https://api.krea.ai/mcp
  1. Guarda el servidor e inicia sesión con tu cuenta de Krea cuando Codex te pida conectarte.

Cursor

Abre la paleta de comandos, busca Open MCP settings y luego añade esta entrada a mcp.json:
{
  "mcpServers": {
    "krea-ai": {
      "url": "https://api.krea.ai/mcp"
    }
  }
}
Reinicia Cursor después de guardar el archivo y luego inicia sesión con tu cuenta de Krea cuando Cursor te pida conectarte.

Usar Krea a través de MCP

Una vez conectado, pídele a tu agente que liste los modelos de Krea o inspeccione el esquema de un modelo antes de generar. Los ID de modelo coinciden con las rutas de la API utilizadas en el resto de la documentación para desarrolladores, como image/krea/krea-2/medium o video/google/veo-3.1. Por ejemplo:
List the available Krea image models, then generate an image with Krea 2 using a 16:9 aspect ratio.
Si un modelo está obsoleto, Krea devuelve metadatos de obsolescencia a través del descubrimiento de modelos de MCP. Consulta Obsolescencias para obtener orientación sobre la migración.

Solución de problemas

ProblemaSolución
La autenticación fallaVuelve a conectar el servidor MCP y completa el flujo de OAuth de Krea en tu navegador. Si usas un token de API, confirma que el encabezado sea exactamente Authorization: Bearer KREA_API_TOKEN y que el token no haya sido revocado.
El cliente no se puede conectarConfirma que el cliente esté configurado para Streamable HTTP y use https://api.krea.ai/mcp.
La generación se rechaza por facturaciónSi te conectaste con OAuth, revisa las unidades de cómputo de la cuenta de Krea con la que iniciaste sesión. Si te conectaste con un token de API, añade saldo de API en krea.ai/app/api.
La llamada al modelo fallaPide a tu agente que inspeccione el esquema del modelo antes de reintentar. Las solicitudes MCP usan las mismas entradas de modelo que la API.

Siguientes pasos

Claves de API y facturación

Crea tokens de API y gestiona el saldo de API para las solicitudes autenticadas con token.

Playground interactivo

Prueba las solicitudes en la app de Krea antes de pedirle a un agente que las ejecute.

Obsolescencias

Descubre cómo MCP expone los metadatos de migración de modelos.

APIs de modelos

Explora los esquemas de los endpoints y los parámetros de los modelos.