Servidor MCP: imagemns, vídeo e fala em apps de IA

Use os modelos de imagemm, vídeo e voz da Zurelay no Claude, ChatGPT, Cursor, VS Code e outros apps de IA. Conecte o servidor MCP uma vez, entre na sua conta e peça uma imagem, um clipe ou uma narração no chat: o conteúdo é gerado com Nano Banana, GPT Image, Seedance, Kling, Wan ou Gemini TTS e pago com seu saldo da Zurelay, pelos mesmos preços da API.

https://api.zurelay.com/mcp

É um servidor remoto (Streamable HTTP), então não há nada para instalar. Entre pelo app ou envie uma chave de API. Ele está listado no MCP Registry oficial como com.zurelay/mcp.

O que faz

Modelos de chat não são ferramentas aqui: um app que usa um modelo já tem o seu. Para usar Claude Code, Cursor ou qualquer outro app com os modelos de chat da Zurelay, altere a URL base do app (veja Integrações).

Conecte seu app

Todos os apps abaixo permitem entrar na conta: você autoriza uma vez em zurelay.com e nunca precisa colar uma chave. Apps que não permitem login, ou configurações que não devem abrir um navegador (servidores, CI), enviam uma chave de API.

Claude (web, desktop e celular)

Adicionar Zurelay ao Claude abre o formulário já preenchido. Ou faça manualmente:

1. Vá para Personalizar, depois Conectores, escolha Adicionar e então Adicionar conector personalizado.
2. Use o nome Zurelay e cole https://api.zurelay.com/mcp como a URL do servidor MCP. As duas opções de cliente OAuth funcionam: Usar a identidade publicada do Claude ou Registrar automaticamente. Adicione o conector.
3. Escolha Conectar. A Zurelay será aberta: entre na conta, defina um limite de gastos diário e escolha Permitir.
4. Em um chat, abra +, depois Conectores, ative a Zurelay e peça o que quiser: “Crie um pôster em 16:9 de…”, “Anime isto em um clipe de 5 segundos”, “Leia isto em voz alta com uma voz calma”.

Os conectores funcionam na web, no app para desktop e no celular, em todos os planos (o Free permite um conector personalizado). Nos planos Team e Enterprise, um proprietário adiciona a Zurelay em Configurações da organização, Conectores (Adicionar, Personalizado, Web); depois, cada membro conecta sua própria conta Zurelay.

Claude Code

claude mcp add --scope user --transport http zurelay https://api.zurelay.com/mcp

Depois, digite /mcp no Claude Code, escolha zurelay e entre na conta pelo navegador que abrir (ou execute claude mcp login zurelay). Se preferir uma chave de API, não precisa de navegador:

claude mcp add --scope user --transport http zurelay https://api.zurelay.com/mcp \
  --header "Authorization: Bearer $ZURELAY_API_KEY"

--scope user adiciona o servidor para todas as pastas. Sem essa opção, ele só aparece quando o Claude Code é executado na pasta em que você o adicionou; use --scope project para compartilhá-lo pelo .mcp.json do projeto (não coloque chaves em arquivos compartilhados: .mcp.json lê ${ZURELAY_API_KEY} do ambiente). Execute o comando em um terminal comum, não dentro do Claude Code, e reinicie o Claude Code se ele já estiver aberto.

ChatGPT

1. Em Configurações, Segurança e login, ative o Modo de desenvolvedor (Plus, Pro, Business, Enterprise e Edu; talvez um administrador do espaço de trabalho precise permitir).
2. Abra Plugins do ChatGPT e pressione +. Use o nome Zurelay e insira https://api.zurelay.com/mcp como URL de conexão, com OAuth.
3. Entre na Zurelay e escolha Permitir. Em um chat, abra +, escolha Modo de desenvolvedor e selecione Zurelay.

O ChatGPT só permite entrar na conta: ele não pode enviar uma chave de API.

Cursor

Adicionar Zurelay ao Cursor e, depois, escolha Conectar ao lado dela nas configurações de MCP do Cursor para entrar na conta. Ou adicione a configuração a ~/.cursor/mcp.json (todos os projetos) ou .cursor/mcp.json (um projeto):

{
  "mcpServers": {
    "zurelay": {
      "url": "https://api.zurelay.com/mcp"
    }
  }
}

VS Code

Adicionar Zurelay ao VS Code, ou adicione a configuração a .vscode/mcp.json no seu projeto (ou execute MCP: Add Server na Paleta de Comandos e escolha HTTP). O VS Code pede que você entre na conta na primeira vez que o modo agente do Copilot usar o servidor. Com uma chave de API, ele solicita a chave uma vez e a armazena criptografada:

{
  "servers": {
    "zurelay": {
      "type": "http",
      "url": "https://api.zurelay.com/mcp"
    }
  }
}

Agentes de IA

Agentes pessoais e agentes sempre ativos adicionam o servidor da mesma forma: Grok Bot e Meta Muse quando você cola uma mensagem pedindo isso, OpenAI dots pelos plugins do ChatGPT, Gemini Spark, Manus e Perplexity nas configurações de conectores. OpenClaw e Hermes Agent também podem usá-lo, ou usar a skill da Zurelay, que fornece uma chave própria a eles por um link que você autoriza. As instruções para cada agente estão em Agentes de IA.

Codex, Gemini CLI e outros apps

Qualquer app compatível com MCP via Streamable HTTP funciona. O Codex permite entrar na conta com codex mcp login zurelay e o Gemini CLI com /mcp auth zurelay; para usar uma chave, a maioria dos apps aceita um cabeçalho Authorization:

# or: codex mcp add zurelay --url 'https://api.zurelay.com/mcp' --bearer-token-env-var ZURELAY_API_KEY
[mcp_servers.zurelay]
url = "https://api.zurelay.com/mcp"
bearer_token_env_var = "ZURELAY_API_KEY"

Login ou chave de API

Entrar na conta é a forma mais fácil e segura. O app abre zurelay.com, onde você entra com um código enviado por e-mail, escolhe o workspace que vai pagar pelo uso e um limite de gasto diário, e autoriza o acesso. O Zurelay então adiciona à sua página de Chaves uma chave com o nome do app, como “Claude (MCP)”, com esse limite. O app nunca vê uma chave de API: ele recebe um token que dura uma hora e um token de atualização que muda a cada uso, e ambos funcionam apenas no servidor MCP, nunca no restante da API. Altere o limite na página de Chaves ou revogue a chave por lá para desconectar o app.

API Uma chave de vai no cabeçalho Authorization: Bearer zr_live_…. Todas as configurações da chave se aplicam: orçamentos, limite de requisições, modelos permitidos e endereços IP permitidos. Crie uma chave só para o app, com um orçamento diário, para que um agente com muita atividade não gaste mais do que você planejou (veja Limites e regras das chaves). Apps como Claude e ChatGPT fazem chamadas dos próprios servidores, então deixe os endereços IP permitidos em branco nas chaves destinadas a eles.

Preços, links e espera

• Os mesmos preços da API: consulte cada modelo na página de modelos ou peça à IA para chamar list_models. Requisições que falham não são cobradas, e vídeos só são cobrados quando ficam prontos.
• Uma ferramenta responde em cerca de 35 segundos. Imagens e áudios de fala geralmente ficam prontos nesse tempo; o que demora mais (a maioria dos vídeos) retorna um id, e a IA chama get_result, que espera até mais 45 segundos a cada chamada.
• Os resultados são links para o nosso armazenamento, válidos por 24 horas. Imagens e vídeos ficam na sua Biblioteca por 30 dias, e cada requisição aparece na sua página de Requisições como qualquer outra.
• As imagens também retornam como uma pequena prévia, para que a IA possa ver o que criou e fazer ajustes. Peça para não incluir prévias para economizar contexto.

Arquivos do seu computador

Para editar uma imagem ou animar um quadro, o modelo precisa de um link para o arquivo. Arquivos que já estão online podem ser enviados pelos seus links https. Para arquivos no seu computador, apps que podem executar comandos (Claude Code, Cursor, Codex) usam create_upload_link: um arquivo PNG, JPEG, WebP, MP4, MOV, MP3 ou WAV de até 20 MB, enviado em até 15 minutos. O link retornado funciona por 2 horas, e o arquivo é excluído após 2 dias. É preciso ter crédito na conta para usar links de upload.

# 1. The agent calls create_upload_link and gets a one-time URL.
# 2. It uploads the file with curl:
curl -sS -T ./product-photo.png 'https://api.zurelay.com/mcp/uploads/…'
# {"url":"https://…/inputs/2026-10-05/….png","type":"image/png","bytes":482113,…}
# 3. It passes that url to generate_image's reference_images or generate_video's first_frame.

Segurança

• O login segue a especificação MCP: OAuth 2.1 com PKCE (somente S256), apenas endereços de redirecionamento registrados e códigos de uso único que duram 5 minutos. Usar um código duas vezes invalida tudo o que foi obtido com ele.
• Os tokens são aleatórios e armazenados apenas como hashes SHA-256. Os tokens de acesso duram uma hora e funcionam apenas no servidor MCP. Os tokens de atualização mudam a cada uso; se um deles for reutilizado mais de um minuto depois, isso indica que foi copiado, então a conexão é encerrada e a chave é revogada.
• Cada conexão é uma chave na sua página de Chaves, com seu próprio limite diário, visível aos membros do seu workspace. Revogar a chave ou sair do workspace desconecta o app.
• A página de consentimento não pode ser exibida dentro de outro site e informa quando um app não é reconhecido pelo Zurelay e para onde ele vai redirecionar você.
• Os links de upload são assinados, aceitam um arquivo e expiram em 15 minutos; os arquivos enviados são excluídos após 2 dias.
• Cada chave e workspace tem seu próprio limite de requisições para chamadas MCP, e cada chamada em um lote conta.

Para desenvolvedores

O servidor usa MCP 2025-11-25 (e 2025-06-18, 2025-03-26 e 2024-11-05) via Streamable HTTP: envie JSON-RPC por POST para https://api.zurelay.com/mcp e receba JSON de volta. Ele não mantém sessões, então não há eventos enviados pelo servidor e GET responde com 405. Sem um token, responde com 401 e WWW-Authenticate apontando para https://api.zurelay.com/.well-known/oauth-protected-resource/mcp; os metadados do servidor de autorização ficam em https://api.zurelay.com/.well-known/oauth-authorization-server, com registro dinâmico de clientes.

curl https://api.zurelay.com/mcp \
  -H "Authorization: Bearer $ZURELAY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "generate_image",
      "arguments": { "prompt": "A lighthouse at dusk, oil painting", "model": "nano-banana-pro" }
    }
  }'

Solução de problemas

• zurelay não aparece no /mcp do Claude Code: ele foi adicionado em outra pasta ou o Claude Code já estava em execução. Feche o Claude Code, execute o comando acima (com --scope user) em um terminal comum e abra o Claude Code novamente. claude mcp list indica que ele precisa de autenticação até você entrar na conta.
• O app continua pedindo para entrar na conta: a chave criada por ele foi revogada ou o login não foi usado por um ano. Conecte o app novamente.
• “Seu saldo no Zurelay está zerado” ou “atingiu o orçamento diário”: adicione crédito na página de Faturamento ou aumente o limite da chave na página de Chaves.
• “Este token pertence a um app conectado pelo servidor MCP do Zurelay”: você enviou o token de um app para a API. Use uma chave de API nela.
• Um vídeo parece travado: peça à IA para chamar get_result novamente; vídeos levam de 1 a 5 minutos, às vezes mais quando um modelo está ocupado.