Servidor MCP

Usa los modelos de IA de Atlas Cloud directamente en tu IDE con el servidor MCP oficial. Genera imágenes, videos, audio (TTS) y modelos 3D, chatea con LLMs y consulta tu saldo y uso. Compatible con Cursor, Claude Desktop, Claude Code, Codex, Gemini CLI y más.

¿Qué es MCP?

Model Context Protocol (MCP) es un estándar abierto desarrollado por Anthropic que permite a los asistentes de IA interactuar con herramientas externas y fuentes de datos de manera estandarizada. Piensa en MCP como un adaptador universal: permite que IDEs impulsados por IA como Cursor, Claude Desktop y Claude Code se conecten sin problemas con servicios de terceros, APIs y datos.

Al usar MCP, los desarrolladores pueden extender las capacidades de su asistente de IA mucho más allá de la simple autocompletación de código: pueden buscar documentación, generar imágenes, videos, audio y modelos 3D, interactuar con LLMs y mucho más, todo a través de comandos en lenguaje natural dentro de su entorno de desarrollo.

Servidor MCP de Atlas Cloud

Atlas Cloud proporciona un servidor MCP oficial (atlascloud-mcp en npm) que lleva toda la potencia de la plataforma de API de IA de Atlas Cloud directamente a tu IDE. Con más de 400 modelos de IA disponibles — abarcando imagen, video, 3D, audio (TTS) y modelos de lenguaje grande — puedes acceder a todo sin cambiar entre pestañas del navegador ni escribir llamadas a la API manualmente.

Repositorio en GitHub: AtlasCloudAI/mcp-server

Modelos compatibles

🎬 Video — Seedance 2.0 · Kling 3 · Sora 2 · Veo 3.1 · HappyHorse 1 · Grok Imagine 1.5 · Wan 2.7
🎨 Imagen — Nano Banana 2/Pro · GPT Image 2 · Flux 2 · Seedream 5
🧊 3D — Hunyuan 3D image-to-3D / text-to-3D
💬 LLM — Claude · GPT · DeepSeek · MiniMax · Kimi · GLM · Qwen
🔊 Audio (TTS) — Seed Audio · xAI/Grok TTS · ElevenLabs

Explora el catálogo completo en nuestra página de Modelos.

Características principales

Búsqueda de documentación — Busca en la documentación, modelos y referencias de API de Atlas Cloud directamente desde tu IDE
Descubrimiento de modelos — Lista y explora más de 400 modelos de IA disponibles con precios y capacidades, filtrables por tipo (Texto/Imagen/Video/Audio)
Generación de imágenes — Genera imágenes usando modelos como Nano Banana, GPT Image 2, Flux 2, Seedream, etc.
Generación de videos — Genera videos usando modelos como Seedance, Kling, Sora, Veo, Wan, etc.
Generación 3D — Convierte texto o fotos en modelos 3D (GLB/OBJ/USDZ) con Hunyuan 3D
Generación de audio (TTS) — Sintetiza voz con Seed Audio, xAI/Grok TTS, ElevenLabs, etc.
Generación rápida — Generación de imagen/video/audio en un solo paso que encuentra automáticamente el modelo adecuado por palabra clave y construye los parámetros
Subida de medios — Sube archivos locales para obtener una URL para flujos de edición de imágenes o de imagen a video
Chat con LLM — Chatea con modelos LLM (compatible con OpenAI) incluyendo Claude, GPT, DeepSeek, Qwen, Kimi, GLM, etc.
Saldo y uso — Consulta el saldo de tu cuenta, el uso diario y los desgloses de costos a través de la Public API de Atlas Cloud
Esquema dinámico — Obtiene automáticamente el esquema de parámetros de cada modelo y valida los parámetros antes de enviarlos, de modo que las solicitudes inválidas fallan rápido sin gastar créditos

Requisitos previos

Antes de configurar el servidor MCP de Atlas Cloud, asegúrate de tener:

Node.js 18 o superior — Descargar Node.js
Clave de API de Atlas Cloud — Regístrate y obtén tu clave en atlascloud.ai

Configuración

Agentes CLI (instalación en una línea)

La vía más rápida — estos agentes de codificación con IA agregan el servidor con un solo comando:

# Claude Code
claude mcp add atlascloud -- npx -y atlascloud-mcp

# OpenAI Codex CLI
codex mcp add atlascloud -- npx -y atlascloud-mcp

# Gemini CLI
gemini mcp add atlascloud -- npx -y atlascloud-mcp

# Goose CLI
goose mcp add atlascloud -- npx -y atlascloud-mcp

Luego establece tu clave de API como variable de entorno:

export ATLASCLOUD_API_KEY="your-api-key-here"

Para que la clave de API persista entre sesiones de terminal, agrega el comando export a tu perfil de shell (~/.bashrc, ~/.zshrc, etc.).

Cursor

Abre o crea el archivo ~/.cursor/mcp.json y agrega lo siguiente:

{
  "mcpServers": {
    "atlascloud": {
      "command": "npx",
      "args": ["-y", "atlascloud-mcp"],
      "env": {
        "ATLASCLOUD_API_KEY": "your-api-key-here"
      }
    }
  }
}

Reinicia Cursor para aplicar los cambios.

Claude Desktop

Abre el archivo de configuración:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Agrega la configuración del servidor MCP:

{
  "mcpServers": {
    "atlascloud": {
      "command": "npx",
      "args": ["-y", "atlascloud-mcp"],
      "env": {
        "ATLASCLOUD_API_KEY": "your-api-key-here"
      }
    }
  }
}

Reinicia Claude Desktop para aplicar los cambios.

Windsurf

Agrega lo siguiente a tu configuración MCP de Windsurf:

{
  "mcpServers": {
    "atlascloud": {
      "command": "npx",
      "args": ["-y", "atlascloud-mcp"],
      "env": {
        "ATLASCLOUD_API_KEY": "your-api-key-here"
      }
    }
  }
}

Codex

Preferiblemente usa la instalación en una línea de arriba, o abre/crea el archivo de configuración de Codex ~/.codex/config.toml y agrega:

[mcp_servers.atlascloud]
command = "npx"
args = ["-y", "atlascloud-mcp"]

[mcp_servers.atlascloud.env]
ATLASCLOUD_API_KEY = "your-api-key-here"

Gemini CLI

Preferiblemente usa la instalación en una línea de arriba, o abre/crea el archivo de configuración de Gemini ~/.gemini/settings.json y agrega:

{
  "mcpServers": {
    "atlascloud": {
      "command": "npx",
      "args": ["-y", "atlascloud-mcp"],
      "env": {
        "ATLASCLOUD_API_KEY": "your-api-key-here"
      }
    }
  }
}

Kilo Code

Abre o crea la configuración a nivel de proyecto .kilocode/mcp.json y agrega:

{
  "mcpServers": {
    "atlascloud": {
      "command": "npx",
      "args": ["-y", "atlascloud-mcp"],
      "env": {
        "ATLASCLOUD_API_KEY": "your-api-key-here"
      }
    }
  }
}

OpenCode

Abre o crea el archivo de configuración de OpenCode opencode.json y agrega:

{
  "mcp": {
    "atlascloud": {
      "type": "local",
      "command": ["npx", "-y", "atlascloud-mcp"],
      "enabled": true,
      "environment": {
        "ATLASCLOUD_API_KEY": "your-api-key-here"
      }
    }
  }
}

Otros clientes MCP

La misma configuración JSON funciona con cualquier cliente compatible con MCP:

Cliente	Dónde agregarla
Cline	MCP Marketplace → Add Server
Continue	`config.yaml` → MCP
VS Code (Copilot)	`.vscode/mcp.json` o Settings → MCP
Trae	Settings → MCP → Add Server
JetBrains IDEs	Settings → Tools → AI Assistant → MCP
ChatGPT Desktop	Settings → MCP
Amazon Q Developer	MCP Configuration
Roo Code	Settings → MCP → Add Server

Herramientas disponibles

El servidor MCP de Atlas Cloud proporciona 13 herramientas que tu asistente de IA puede usar:

Herramienta	Descripción
`atlas_search_docs`	Buscar en la documentación y modelos de Atlas Cloud por palabra clave
`atlas_list_models`	Listar todos los modelos disponibles, opcionalmente filtrados por tipo (Texto/Imagen/Video/Audio)
`atlas_get_model_info`	Obtener información detallada del modelo incluyendo esquema de API, parámetros y ejemplos de uso
`atlas_generate_image`	Generar imágenes y modelos 3D (image-to-3D / text-to-3D) con cualquier modelo de imagen compatible
`atlas_generate_video`	Generar videos con cualquier modelo de video compatible
`atlas_generate_audio`	Generar audio / voz (TTS) con cualquier modelo de audio compatible
`atlas_quick_generate`	Generación de imagen/video/audio en un solo paso — encuentra automáticamente el modelo por palabra clave, construye los parámetros y envía la tarea
`atlas_upload_media`	Subir archivos locales para obtener una URL y usarla con modelos de edición de imagen / imagen a video
`atlas_chat`	Chatear con modelos LLM (formato compatible con OpenAI)
`atlas_get_prediction`	Verificar el estado y resultado de tareas de generación de imagen/video/audio/3D
`atlas_get_balance`	Obtener el saldo de la cuenta y el resumen de créditos de tu clave de API
`atlas_get_model_usage`	Obtener el uso diario de modelos (solicitudes, tokens, cantidad de imágenes/videos) en un rango de fechas
`atlas_get_model_costs`	Obtener los costos diarios por modelo (gasto) en un rango de fechas

Nota: Las herramientas de saldo, uso y costos funcionan con la Public API de Atlas Cloud (https://api.atlascloud.ai/public/v1), por lo que puedes auditar el gasto y la cuota sin salir de tu IDE.

Ejemplos de uso

Una vez configurado, puedes interactuar con Atlas Cloud a través de lenguaje natural:

Buscar modelos

"Busca en Atlas Cloud modelos de generación de video"
"Lista todos los modelos de generación de imágenes con sus precios"
"Muéstrame detalles sobre el modelo DeepSeek V3"

Generar una imagen

"Genera una imagen de un gato en el espacio usando Seedream"

El asistente:

Usará atlas_list_models para encontrar los modelos de imagen de Seedream
Usará atlas_get_model_info para obtener los parámetros del modelo
Usará atlas_generate_image con los parámetros correctos

Generar un video

"Crea un video de un cohete despegando usando Kling v3"

El asistente:

Encontrará el modelo de video Kling
Obtendrá su esquema para entender los parámetros requeridos
Usará atlas_generate_video con los parámetros adecuados

Subir una imagen local para edición o generación de video

"Edita esta imagen /Users/me/photos/cat.jpg para agregarle un sombrero"

El asistente:

Usará atlas_upload_media para subir el archivo local y obtener una URL
Encontrará un modelo de edición de imágenes
Usará atlas_generate_image con la URL subida

Nota: Los archivos subidos son solo para uso temporal con las tareas de generación de Atlas Cloud. Los archivos pueden eliminarse periódicamente. No lo uses como alojamiento permanente de archivos — el abuso puede resultar en la suspensión de tu clave de API.

Generar voz (TTS)

"Lee esta frase en voz alta con Seed Audio: Bienvenido a Atlas Cloud"

El asistente:

Usará atlas_list_models con type="Audio" para encontrar el modelo TTS
Usará atlas_generate_audio con el texto a sintetizar
Usará atlas_get_prediction para obtener la URL del audio generado

Generar un modelo 3D

"Convierte esta foto de producto en un modelo 3D con Hunyuan 3D"

Los modelos 3D son modelos de tipo Imagen, por lo que el asistente usa atlas_generate_image con el parámetro image y obtiene un archivo GLB/OBJ/USDZ a través de atlas_get_prediction.

Chatear con un LLM

"Pídele a DeepSeek V3 que explique la computación cuántica"

El asistente usará atlas_chat con el modelo DeepSeek.

Consultar saldo y uso

"¿Cuánto crédito de Atlas Cloud me queda y cuánto gasté este mes?"

El asistente usará atlas_get_balance para el saldo actual y atlas_get_model_costs para el desglose del gasto.

Solución de problemas

Problemas comunes

Error "Command not found" al ejecutar npx

Asegúrate de que Node.js 18+ esté instalado y que npx esté disponible en tu PATH:

node --version  # Should be 18.x or higher
npx --version   # Should output a version number

Error "Invalid API Key"

Verifica que tu clave de API esté configurada correctamente:

echo $ATLASCLOUD_API_KEY  # Should output your key

Si está vacío, configúralo de nuevo y asegúrate de que no haya espacios ni comillas adicionales.

El servidor MCP no aparece en el IDE

Asegúrate de haber reiniciado tu IDE después de agregar la configuración
Verifica la sintaxis JSON en tu archivo de configuración
Confirma que el archivo de configuración está en la ubicación correcta para tu IDE

Obtener ayuda

Problemas en GitHub: AtlasCloudAI/mcp-server/issues
Soporte de Atlas Cloud: Contáctanos

Más herramientas de Atlas Cloud

¿Prefieres una integración diferente? Atlas Cloud también ofrece:

CLI — usa Atlas Cloud desde la terminal: atlascloud-cli
Skills — un paquete de Skills para Claude Code y otros agentes compatibles con skills: atlas-cloud-skills
Nodos de ComfyUI — atlascloud_comfyui
Nodos de n8n — n8n-nodes-atlascloud

Preguntas frecuentes

¿Es gratuito el servidor MCP?

El servidor MCP en sí es gratuito y de código abierto (licencia MIT). Solo pagas por el uso de la API de Atlas Cloud según los modelos que utilices. Consulta nuestros precios de modelos para más detalles.

¿A qué modelos de IA puedo acceder?

Puedes acceder a los más de 400 modelos disponibles en Atlas Cloud, incluyendo modelos de video (Seedance, Kling, Sora, Veo, Wan), modelos de imagen (Nano Banana, GPT Image, FLUX, Seedream), modelos 3D (Hunyuan 3D), modelos TTS (Seed Audio, xAI/Grok TTS, ElevenLabs) y LLMs (Claude, GPT, DeepSeek, Qwen, Kimi, GLM, MiniMax). Visita nuestra página de Modelos para ver la lista completa.

¿Necesito instalar algo además de Node.js?

No. El servidor MCP se distribuye a través de npm y se ejecuta usando npx, que descarga y ejecuta el paquete automáticamente. No se requiere instalación global.

¿Puedo usar el servidor MCP con otros IDEs?

El servidor MCP funciona con cualquier IDE o aplicación que soporte el Model Context Protocol, incluyendo Cursor, Claude Desktop, Claude Code, Codex, Gemini CLI, Goose, Windsurf, Kilo Code, OpenCode, Cline, Continue, VS Code (Copilot), Trae, JetBrains IDEs, ChatGPT Desktop, Amazon Q Developer y Roo Code.

¿Es segura mi clave de API?

Tu clave de API se almacena localmente en el archivo de configuración de tu IDE y solo se envía a los endpoints de la API de Atlas Cloud. El servidor MCP no recopila, registra ni transmite tu clave de API a ningún servicio de terceros.

En esta página