APIMart MCP

npx add-mcp 'https://mcp.apimart.ai/mcp'

agent — Simulación de demostración de tareas de APIMart

“Ayúdame a encontrar un modelo adecuado para la imagen principal del producto, genera un anuncio de perfume y dime el resultado de la tarea.”

1. 01 Entender la necesidad Identificar la tarea de generación de imágenes
2. 02 Seleccionar el modelo Comparar capacidades y parámetros
3. 03 Enviar la tarea Llamar a la API de APIMart
4. 04 Devolver el resultado Obtener estado y archivos

Ejemplo de tarea completada

El agente prepara los parámetros según la documentación del modelo, envía la tarea y obtiene el resultado. Aquí solo se muestra el flujo, no se envían solicitudes ni se consume crédito. Ver más ejemplos de conversación

Usa list_models de APIMart MCP para listar 5 modelos disponibles, sin generar contenido.

→ APIMart / list_models
  {"limit": 5}

模型展示名称（示例，非 API 模型 ID）：
01  GPT Image 2.5
02  Nano Banana Pro
03  Seedream 5.0 Pro
04  Z-Image Turbo
05  Midjourney

✓ 示例数据。实际数量与模型 ID 以当前 Key 的返回结果为准。

Tres formas de integrar según tu necesidad

Elige documentación, herramientas remotas o habilidades locales según tu hábito de uso. Las operaciones específicas compatibles dependen de la interfaz, herramienta y cliente correspondientes.

Sigue los pasos para completar la integración

Elige una forma y sigue los pasos para completar la configuración. Los comandos se pueden copiar directamente y los prompts de prueba ya están preparados.

APIMart Agent Tools

macOS · zsh · Codex de escritorio · entorno de producción

Configuración segura de la API Key

Disponible en producción

Primero crea una API Key válida en APIMart, luego ejecuta el siguiente comando en la terminal zsh de macOS e ingresa la Key de forma oculta según las indicaciones.

Obtener API Key

Comando de terminal

read -s "APIMART_API_KEY?APIMart API Key: "
echo
launchctl setenv APIMART_API_KEY "$APIMART_API_KEY"
unset APIMART_API_KEY

La Key real solo se pega cuando la terminal lo solicite. No la escribas en comandos, chats o capturas de pantalla; si una Key se ha filtrado, revócala y crea una nueva.

Más detalles y alcance

Esta configuración se aplica a las aplicaciones de escritorio que se reinicien en la sesión de inicio de sesión actual. Después de configurarla, cierra y vuelve a abrir completamente Codex de escritorio. Si usas la versión de terminal, ejecuta export APIMART_API_KEY después de ingresar la Key de forma oculta y luego inicia Codex desde la misma terminal; no ejecutes el unset de aquí. Lo siguiente es solo un ejemplo del formato de la clave, no es necesario ejecutarlo ni reemplazarlo.

Ejemplo de formato de clave · No es necesario ejecutar sk-••••••••••••••••

Cómo elegir depende de tu hábito de uso

Consulta rápidamente la documentación con AI Docs, elige MCP para llamadas de herramientas diarias, y Skill para scripts locales y flujos fijos.

Forma de integración	Más adecuada para	Instalación y configuración	Ubicación de ejecución de capacidades	Ventaja principal	A tener en cuenta	Inicio rápido
AI Docs llms.txt	Consultas puntuales, generación de código de llamada	Sin instalación, copiar el prompt	El agente lee la documentación y ejecuta código	Ligero y fácil de usar, llamadas flexibles a la interfaz	Requiere capacidad de lectura web, la ejecución de código aún necesita credenciales	Ver pasos de integración
MCP Recomendado	Interacciones frecuentes, creación diaria	Configurar servicio remoto y Key	MCP remoto de APIMart	Herramientas estructuradas, sin paquete MCP local	Depende de la red y soporte del cliente, limitado a las herramientas proporcionadas	Ver pasos de integración
Agent Skill Paquete de habilidades local	Flujos fijos, estandarización de equipos	Instalar el directorio completo vía GitHub	Scripts locales que llaman a la API de APIMart	Flujos reutilizables, independiente de MCP	Requiere Node.js, puede necesitar reinstalación al actualizar	Ver pasos de integración

Qué puede hacer el agente por ti

Se centra en el descubrimiento de modelos, comprensión de documentación y tareas comunes de imagen y video. Antes de usarlo, confirma que el modelo, herramienta o cliente local seleccionado admita la operación correspondiente.

Descubrimiento de modelos

Busca modelos disponibles según el objetivo de la tarea y confirma la capacidad y versión adecuadas para la necesidad actual.

Parámetros y documentación

Lee parámetros de entrada, instrucciones de uso y limitaciones para comprender cómo se llama al modelo.

Generación de imágenes

Completa selección de modelo, preparación de parámetros, envío de tarea, consulta de estado y obtención de resultados.

Generación de video

Llama a modelos de video, obtén continuamente el progreso de la tarea, el estado de ejecución y el resultado final.

La API Key no aparece en los comandos de instalación

Transmite las credenciales mediante variables de entorno para reducir el riesgo de que la Key se guarde accidentalmente en el historial de terminal, capturas de pantalla o registros de chat.

• Primero lee la documentación, luego configura las credenciales La documentación de IA ayuda al agente a comprender la interfaz, sin iniciar llamadas de modelo automáticamente.
• Lee mediante variables de entorno MCP y Skill leen la Key desde variables de entorno; no escribas la Key en prompts ni comandos de instalación.
• Primero consulta el modelo para verificar la conexión La generación real se factura según las reglas de la cuenta de APIMart. Después de la integración, usa primero la consulta de modelos para verificar la configuración.

Preguntas frecuentes

Elige una forma y comienza a usar

MCP y Skill están disponibles de forma independiente; AI Docs no requiere instalación y puedes copiar el prompt directamente.