Servidor MCP

O que é MCP?

O Model Context Protocol (MCP) é um padrão aberto desenvolvido pela Anthropic que permite que assistentes de IA interajam com ferramentas externas e fontes de dados de forma padronizada. Pense no MCP como um adaptador universal — ele permite que IDEs com IA, como Cursor, Claude Desktop e Claude Code, se conectem perfeitamente a serviços, APIs e dados de terceiros.

Ao usar o MCP, os desenvolvedores podem estender as capacidades do seu assistente de IA muito além da simples conclusão de código: eles podem pesquisar documentação, gerar imagens, vídeos, áudio e modelos 3D, interagir com LLMs e muito mais — tudo através de comandos em linguagem natural dentro do seu ambiente de desenvolvimento.

Servidor MCP do Atlas Cloud

O Atlas Cloud fornece um Servidor MCP oficial (atlascloud-mcp no npm) que traz todo o poder da plataforma de API de IA do Atlas Cloud diretamente para o seu IDE. Com mais de 400 modelos de IA disponíveis — abrangendo imagem, vídeo, 3D, áudio (TTS) e modelos de linguagem de grande escala — você pode acessar tudo sem alternar entre abas do navegador ou escrever chamadas de API manualmente.

Repositório GitHub: AtlasCloudAI/mcp-server

Modelos Suportados

• 🎬 Vídeo — Seedance 2.0 · Kling 3 · Sora 2 · Veo 3.1 · HappyHorse 1 · Grok Imagine 1.5 · Wan 2.7
• 🎨 Imagem — Nano Banana 2/Pro · GPT Image 2 · Flux 2 · Seedream 5
• 🧊 3D — Hunyuan 3D imagem-para-3D / texto-para-3D
• 💬 LLM — Claude · GPT · DeepSeek · MiniMax · Kimi · GLM · Qwen
• 🔊 Áudio (TTS) — Seed Audio · xAI/Grok TTS · ElevenLabs

Explore o catálogo completo na nossa página de Modelos.

Principais Recursos

• Pesquisa de Documentação — Pesquise documentação, modelos e referências de API do Atlas Cloud diretamente do seu IDE
• Descoberta de Modelos — Liste e explore mais de 400 modelos de IA disponíveis com preços e capacidades, filtráveis por tipo (Texto/Imagem/Vídeo/Áudio)
• Geração de Imagens — Gere imagens usando modelos como Nano Banana, GPT Image 2, Flux 2, Seedream, etc.
• Geração de Vídeos — Gere vídeos usando modelos como Seedance, Kling, Sora, Veo, Wan, etc.
• Geração 3D — Transforme texto ou fotos em modelos 3D (GLB/OBJ/USDZ) com o Hunyuan 3D
• Geração de Áudio (TTS) — Sintetize fala com Seed Audio, xAI/Grok TTS, ElevenLabs, etc.
• Geração Rápida — Geração de imagem/vídeo/áudio em uma única etapa que encontra automaticamente o modelo certo por palavra-chave e monta os parâmetros
• Upload de Mídia — Envie arquivos locais para obter uma URL para fluxos de edição de imagem ou imagem-para-vídeo
• Chat com LLM — Converse com modelos LLM (compatível com OpenAI) incluindo Claude, GPT, DeepSeek, Qwen, Kimi, GLM, etc.
• Saldo e Uso — Consulte o saldo da sua conta, o uso diário e o detalhamento de custos via Public API do Atlas Cloud
• Esquema Dinâmico — Busca automaticamente o esquema de parâmetros de cada modelo e valida os parâmetros antes do envio, fazendo com que requisições inválidas falhem rapidamente sem gastar créditos

Pré-requisitos

Antes de configurar o Servidor MCP do Atlas Cloud, certifique-se de ter:

• Node.js 18 ou superior — Baixar Node.js
• Chave de API do Atlas Cloud — Cadastre-se e obtenha sua chave em atlascloud.ai

Configuração

Agentes CLI (instalação com um único comando)

O caminho mais rápido — estes agentes de codificação com IA adicionam o servidor com um único 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

Em seguida, defina sua chave de API como variável de ambiente:

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

Para persistir a chave de API entre sessões do terminal, adicione o comando export ao perfil do seu shell (~/.bashrc, ~/.zshrc, etc.).

Cursor

Abra ou crie o arquivo ~/.cursor/mcp.json e adicione o seguinte:

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

Reinicie o Cursor para aplicar as alterações.

Claude Desktop

Abra o arquivo de configuração:

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

Adicione a configuração do servidor MCP:

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

Reinicie o Claude Desktop para aplicar as alterações.

Windsurf

Adicione o seguinte à configuração MCP do seu Windsurf:

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

Codex

Prefira a instalação com um único comando acima, ou abra/crie o arquivo de configuração do Codex ~/.codex/config.toml e adicione:

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

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

Gemini CLI

Prefira a instalação com um único comando acima, ou abra/crie o arquivo de configurações do Gemini ~/.gemini/settings.json e adicione:

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

Kilo Code

Abra ou crie a configuração a nível de projeto .kilocode/mcp.json e adicione:

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

OpenCode

Abra ou crie o arquivo de configuração do OpenCode opencode.json e adicione:

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

Outros Clientes MCP

A mesma configuração JSON funciona com qualquer cliente compatível com MCP:

Ferramentas Disponíveis

O Servidor MCP do Atlas Cloud fornece 13 ferramentas que seu assistente de IA pode usar:

Nota: As ferramentas de saldo, uso e custo são alimentadas pela Public API do Atlas Cloud (https://api.atlascloud.ai/public/v1), permitindo que você audite gastos e cotas sem sair do seu IDE.

Exemplos de Uso

Uma vez configurado, você pode interagir com o Atlas Cloud através de linguagem natural:

Pesquisar Modelos

• "Pesquise no Atlas Cloud por modelos de geração de vídeo"
• "Liste todos os modelos de geração de imagem com seus preços"
• "Mostre-me detalhes sobre o modelo DeepSeek V3"

Gerar uma Imagem

"Gere uma imagem de um gato no espaço usando Seedream"

O assistente irá:

1. Usar atlas_list_models para encontrar modelos de imagem Seedream
2. Usar atlas_get_model_info para obter os parâmetros do modelo
3. Usar atlas_generate_image com os parâmetros corretos

Gerar um Vídeo

"Crie um vídeo do lançamento de um foguete usando Kling v3"

O assistente irá:

1. Encontrar o modelo de vídeo Kling
2. Obter seu esquema para entender os parâmetros necessários
3. Usar atlas_generate_video com os parâmetros apropriados

Enviar uma Imagem Local para Edição ou Geração de Vídeo

"Edite esta imagem /Users/me/photos/cat.jpg para adicionar um chapéu"

O assistente irá:

1. Usar atlas_upload_media para enviar o arquivo local e obter uma URL
2. Encontrar um modelo de edição de imagem
3. Usar atlas_generate_image com a URL do arquivo enviado

Nota: Os arquivos enviados destinam-se apenas a uso temporário com tarefas de geração do Atlas Cloud. Os arquivos podem ser removidos periodicamente. Não use este recurso como hospedagem permanente de arquivos — o abuso pode resultar na suspensão da chave de API.

Gerar Fala (TTS)

"Leia esta frase em voz alta com o Seed Audio: Bem-vindo ao Atlas Cloud"

O assistente irá:

1. Usar atlas_list_models com type="Audio" para encontrar o modelo TTS
2. Usar atlas_generate_audio com o texto a ser sintetizado
3. Usar atlas_get_prediction para recuperar a URL do áudio gerado

Gerar um Modelo 3D

"Transforme esta foto de produto em um modelo 3D com o Hunyuan 3D"

Os modelos 3D são modelos do tipo Imagem, então o assistente usa atlas_generate_image com o parâmetro image e recupera um arquivo GLB/OBJ/USDZ via atlas_get_prediction.

Conversar com um LLM

"Peça ao DeepSeek V3 para explicar computação quântica"

O assistente usará atlas_chat com o modelo DeepSeek.

Verificar Saldo e Uso

"Quanto crédito do Atlas Cloud ainda tenho e quanto gastei este mês?"

O assistente usará atlas_get_balance para o saldo atual e atlas_get_model_costs para o detalhamento dos gastos.

Solução de Problemas

Problemas Comuns

Erro "Command not found" ao executar npx

Certifique-se de que o Node.js 18+ está instalado e que o npx está disponível no seu PATH:

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

Erro "Invalid API Key"

Verifique se sua chave de API está configurada corretamente:

echo $ATLASCLOUD_API_KEY  # Should output your key

Se estiver vazio, defina novamente e certifique-se de que não há espaços extras ou aspas.

O Servidor MCP não aparece no IDE

• Certifique-se de que reiniciou o IDE após adicionar a configuração
• Verifique novamente a sintaxe JSON no seu arquivo de configuração
• Confirme que o arquivo de configuração está no local correto para o seu IDE

Obter Ajuda

• Issues no GitHub: AtlasCloudAI/mcp-server/issues
• Suporte Atlas Cloud: Fale conosco

Mais Ferramentas do Atlas Cloud

Prefere uma integração diferente? O Atlas Cloud também oferece:

• CLI — use o Atlas Cloud a partir do terminal: atlascloud-cli
• Skills — um pacote de Skills para Claude Code e outros agentes compatíveis com skills: atlas-cloud-skills
• Nós para ComfyUI — atlascloud_comfyui
• Nós para n8n — n8n-nodes-atlascloud

Perguntas Frequentes

O Servidor MCP é gratuito?

O Servidor MCP em si é gratuito e de código aberto (licença MIT). Você paga apenas pelo uso da API do Atlas Cloud com base nos modelos que utiliza. Confira nossos preços de modelos para mais detalhes.

Quais modelos de IA posso acessar?

Você pode acessar todos os mais de 400 modelos disponíveis no Atlas Cloud, incluindo modelos de vídeo (Seedance, Kling, Sora, Veo, Wan), modelos de imagem (Nano Banana, GPT Image, FLUX, Seedream), modelos 3D (Hunyuan 3D), modelos TTS (Seed Audio, xAI/Grok TTS, ElevenLabs) e LLMs (Claude, GPT, DeepSeek, Qwen, Kimi, GLM, MiniMax). Visite nossa página de Modelos para uma lista completa.

Preciso instalar algo além do Node.js?

Não. O Servidor MCP é distribuído via npm e executado usando npx, que baixa e executa o pacote automaticamente. Nenhuma instalação global é necessária.

Posso usar o Servidor MCP com outros IDEs?

O Servidor MCP funciona com qualquer IDE ou aplicativo que suporte o Model Context Protocol, incluindo 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 e Roo Code.

Minha chave de API está segura?

Sua chave de API é armazenada localmente no arquivo de configuração do seu IDE e é enviada apenas para os endpoints da API do Atlas Cloud. O Servidor MCP não coleta, registra ou transmite sua chave de API para serviços de terceiros.