Ir al contenido principal

MCP y agentes

Deja que tu asistente de IA cree imágenes y video

El servidor MCP oficial da a Claude, Cursor, Codex, VS Code y otros asistentes acceso al catálogo actualizado de modelos, cotizaciones exactas y creación de tareas. Tú pides con tus palabras y el asistente se detiene a pedirte confirmación antes de cobrar nada.

Crear una clave de APIGuía completa en la documentación

¿Qué es un servidor MCP?

MCP (Model Context Protocol) es un estándar para darle herramientas nuevas a un asistente de IA. Añade el servidor de SpicyAPI y tu asistente podrá explorar modelos, consultar precios y crear imágenes o video por ti.

  1. Tú y tu asistenteClaude, Cursor, Codex, VS Code…
  2. Servidor MCP de SpicyAPISe ejecuta en tu computadora con npx
  3. Modelos de imagen y videoCatálogo en vivo, precios exactos
El asistente decide qué herramienta llamar. Todo lo que cuesta dinero se detiene y espera tu confirmación.

Ideal para

  • Recursos mientras programasPide una imagen de portada o un clip de producto sin salir del editor.
  • Explorar modelosPregunta qué modelo encaja con un trabajo y cuánto costará.
  • Lotes sin tocar nadaDeja que el agente cree, espere y recoja varias tareas.

Qué ocurre cuando lo pides

  1. Paso 1Busca un modelo adecuado en el catálogo en vivo y lee qué parámetros acepta
  2. Paso 2Sube tu archivo local, si lo hay
  3. Paso 3Obtiene una cotización exacta en dólares estadounidenses y te pregunta antes de cobrar nada
  4. Paso 4Inicia la tarea, espera a que termine y te entrega el enlace del resultado
Sesión de ejemplo

  1. Tú: Convierte beach.jpg en un clip de seis segundos con olas al atardecer.

  2. spicyapi_models_listspicyapi_model_get
    Asistente: Encontré un modelo de video que acepta imagen inicial
  3. spicyapi_upload_file
    Subí beach.jpg
  4. spicyapi_task_quote

    Este es el precio exacto en dólares. ¿Creo la tarea?

  5. spicyapi_task_createspicyapi_task_wait
    Listo. Aquí tienes tu enlace de descarga.
Ilustración de una sesión típica. No se cobra nada hasta que apruebes.

Añádelo a tu asistente

Todos los clientes ejecutan el mismo servidor local mediante npx. Elige el tuyo para ver el comando o el bloque de configuración exacto.

{
  "mcpServers": {
    "spicyapi": {
      "command": "npx",
      "args": ["--yes", "--package=@spicyapi/mcp", "spicyapi-mcp"],
      "env": { "SPICY_API_KEY": "YOUR_SERVER_SIDE_KEY" }
    }
  }
}

Un solo servidor stdio para todos los clientes MCP. Pega el bloque en el archivo de configuración de ese cliente.

Los clientes de terceros cambian el formato de su configuración entre versiones. Si un fragmento de aquí deja de coincidir, prevalece la documentación del propio cliente.

¿Usas Claude? Generar imágenes y vídeo desde Claude →

Herramientas que expone

Las herramientas de solo lectura son gratis. Las dos que gastan dinero y la que borra contenido siempre te piden confirmación.

GratisGratis y de solo lectura12

  • spicyapi_service_statusComprobación de estado pública, sin clave
  • spicyapi_docs_searchBuscar en la documentación incluida
  • spicyapi_models_listModelos activos y tus precios
  • spicyapi_model_getUn modelo y su esquema de entrada
  • spicyapi_balance_getSaldo disponible, retenido y total
  • spicyapi_usage_getLo que ha gastado la clave actual
  • spicyapi_tasks_listTareas recientes de la clave actual
  • spicyapi_task_getUna tarea, con los enlaces de resultado listos
  • spicyapi_task_waitEsperar hasta 5 minutos a que termine una tarea
  • spicyapi_task_quoteCalcular el precio de una solicitud exacta sin crearla
  • spicyapi_upload_fileSubir un archivo local para usarlo como entrada
  • spicyapi_download_url_createUn enlace de descarga nuevo para un resultado

Pide confirmación antes de cobrarPide confirmación antes de ejecutarse3

  • spicyapi_task_createIniciar una tarea de generación
  • spicyapi_task_retryRepetir una tarea fallida o caducada
  • spicyapi_task_purgeBorrar de forma permanente el contenido de una tarea terminada
Abrir paqueteVer código fuente

Añade el Agent Skill para el orden de las llamadas

El servidor MCP da capacidades al agente; el Agent Skill le explica cómo usarlas: leer el esquema, confirmar la cotización y reutilizar una sola clave de idempotencia por intento. Claude Code y Codex admiten ambos.

Abrir paqueteVer código fuente
npx skills add spicyapi-ai/spicy-skill \
  --agent claude-code

Archivos que tu agente puede leer

Estos archivos llevan a asistentes y herramientas de integración a la descripción, el catálogo y la documentación oficial.

agent.md

Contrato compacto de integración y límites de seguridad para agentes.

/agent.md →

llms.txt

Índice seleccionado del sitio y los modelos para recuperación por IA.

/llms.txt →

llms-full.txt

Contexto ampliado de producto, flujos, endpoints y descubrimiento.

/llms-full.txt →

Manifiesto de agente

Descubrimiento JSON estructurado para herramientas y clientes autónomos.

/api/agent →

Soluciona errores comunes

Casi todos los problemas del principio son uno de estos tres. Cada tarjeta muestra lo que ves y lo único que debes cambiar.

  • tools

    No aparecen las herramientas

    Reinicia el asistente tras editar su configuración y comprueba que el JSON sea válido.

  • clave

    Falta la clave de API

    Pon SPICY_API_KEY en el bloque env de la configuración del servidor. Las apps de escritorio no ven una clave exportada en tu shell.

  • pedir

    No se pueden crear tareas

    Tu cliente no puede mostrar mensajes de confirmación. Las herramientas gratuitas siguen funcionando; para crear tareas usa un cliente compatible con la elicitación de MCP.

Preguntas frecuentes