Servidor MCP

Usa los modelos de IA de Atlas Cloud directamente en tu IDE con el servidor MCP oficial. Compatible con Cursor, Claude Desktop, Claude Code, Codex, Gemini CLI y mas.

Que es MCP?

Model Context Protocol (MCP) es un estandar 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 mas alla de la simple autocompletacion de codigo: pueden buscar documentacion, generar imagenes, crear videos, interactuar con LLMs y mucho mas, todo a traves 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 mas de 300 modelos de IA disponibles, incluyendo generadores de imagenes, creadores de video y modelos de lenguaje grande, puedes acceder a todo sin cambiar entre pestanas del navegador ni escribir llamadas a la API manualmente.

Repositorio en GitHub: AtlasCloudAI/mcp-server

Caracteristicas principales

  • Busqueda de documentacion — Busca en la documentacion, modelos y referencias de API de Atlas Cloud directamente desde tu IDE
  • Descubrimiento de modelos — Lista y explora mas de 300 modelos de IA disponibles con precios y capacidades
  • Generacion de imagenes — Genera imagenes usando modelos como Seedream, Qwen-Image, FLUX, etc.
  • Generacion de videos — Genera videos usando modelos como Kling, Vidu, Seedance, Wan, etc.
  • Chat con LLM — Chatea con modelos LLM (compatible con OpenAI) incluyendo DeepSeek, Qwen, GLM, etc.
  • Esquema dinamico — Obtiene automaticamente el esquema de parametros de cada modelo para un uso preciso de la API

Requisitos previos

Antes de configurar el servidor MCP de Atlas Cloud, asegurate de tener:

Configuracion

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 configuracion:

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

Agrega la configuracion 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.

Claude Code

Ejecuta el siguiente comando para agregar el servidor MCP de Atlas Cloud:

claude 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.).

Windsurf

Agrega lo siguiente a tu configuracion MCP de Windsurf:

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

Codex

Abre o crea el archivo de configuracion 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

Abre o crea el archivo de configuracion 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 configuracion 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 configuracion 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"
      }
    }
  }
}

Herramientas disponibles

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

HerramientaDescripcion
atlas_search_docsBuscar en la documentacion y modelos de Atlas Cloud por palabra clave
atlas_list_modelsListar todos los modelos disponibles, opcionalmente filtrados por tipo (Texto/Imagen/Video)
atlas_get_model_infoObtener informacion detallada del modelo incluyendo esquema de API, parametros y ejemplos de uso
atlas_generate_imageGenerar imagenes con cualquier modelo de imagen compatible
atlas_generate_videoGenerar videos con cualquier modelo de video compatible
atlas_chatChatear con modelos LLM (formato compatible con OpenAI)
atlas_get_predictionVerificar el estado y resultado de tareas de generacion de imagen/video

Ejemplos de uso

Una vez configurado, puedes interactuar con Atlas Cloud a traves de lenguaje natural:

Buscar modelos

  • "Busca en Atlas Cloud modelos de generacion de video"
  • "Lista todos los modelos de generacion de imagenes con sus precios"
  • "Muestrame detalles sobre el modelo DeepSeek V3"

Generar una imagen

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

El asistente:

  1. Usara atlas_list_models para encontrar los modelos de imagen de Seedream
  2. Usara atlas_get_model_info para obtener los parametros del modelo
  3. Usara atlas_generate_image con los parametros correctos

Generar un video

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

El asistente:

  1. Encontrara el modelo de video Kling
  2. Obtendra su esquema para entender los parametros requeridos
  3. Usara atlas_generate_video con los parametros adecuados

Chatear con un LLM

"Pidele a DeepSeek V3 que explique la computacion cuantica"

El asistente usara atlas_chat con el modelo DeepSeek.

Solucion de problemas

Problemas comunes

Error "Command not found" al ejecutar npx

Asegurate de que Node.js 18+ este instalado y que npx este 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 este configurada correctamente:

echo $ATLASCLOUD_API_KEY  # Should output your key

Si esta vacio, configuralo de nuevo y asegurate de que no haya espacios ni comillas adicionales.

El servidor MCP no aparece en el IDE

  • Asegurate de haber reiniciado tu IDE despues de agregar la configuracion
  • Verifica la sintaxis JSON en tu archivo de configuracion
  • Confirma que el archivo de configuracion esta en la ubicacion correcta para tu IDE

Obtener ayuda

Preguntas frecuentes

Es gratuito el servidor MCP?

El servidor MCP en si es gratuito y de codigo abierto (licencia MIT). Solo pagas por el uso de la API de Atlas Cloud segun los modelos que utilices. Consulta nuestros precios de modelos para mas detalles.

A que modelos de IA puedo acceder?

Puedes acceder a los mas de 300 modelos disponibles en Atlas Cloud, incluyendo modelos de OpenAI, Anthropic, DeepSeek, Google, Meta, Mistral, ByteDance (Seedream, Kling), Alibaba (Qwen) y mas. Visita nuestra pagina de Modelos para ver la lista completa.

Necesito instalar algo ademas de Node.js?

No. El servidor MCP se distribuye a traves de npm y se ejecuta usando npx, que descarga y ejecuta el paquete automaticamente. No se requiere instalacion global.

Puedo usar el servidor MCP con otros IDEs?

El servidor MCP funciona con cualquier IDE o aplicacion que soporte el Model Context Protocol. Actualmente compatibles: Cursor, Claude Desktop, Claude Code, Windsurf, Codex, Gemini CLI, Kilo Code y OpenCode.

Es segura mi clave de API?

Tu clave de API se almacena localmente en el archivo de configuracion de tu IDE y solo se envia a los endpoints de la API de Atlas Cloud. El servidor MCP no recopila, registra ni transmite tu clave de API a ningun servicio de terceros.