Servidor MCP: imagemns, vídeo e voz em aplicações de IA

Dê ao Claude, ChatGPT, Cursor, VS Code e a outras aplicações de IA acesso aos modelos de imagemm, vídeo e voz da Zurelay. Ligue o servidor MCP uma vez, inicie sessão e peça uma imagem, um vídeo ou uma narração na conversa: o conteúdo é gerado com Nano Banana, GPT Image, Seedance, Kling, Wan ou Gemini TTS e pago com o seu saldo Zurelay, aos mesmos preços da API.

https://api.zurelay.com/mcp

É um servidor remoto (Streamable HTTP), por isso não há nada para instalar. Inicie sessão a partir da aplicação ou envie uma chave API. Está no registo oficial MCP como com.zurelay/mcp.

O que faz

Os modelos de conversação não são ferramentas aqui: uma aplicação que funciona com um modelo já tem um. Para usar o Claude Code, o Cursor ou outra aplicação com os modelos de conversação da Zurelay, altere antes o URL base (ver Integrações).

Ligue a sua aplicação

Todas as aplicações abaixo permitem iniciar sessão: autoriza o acesso uma vez em zurelay.com e nunca precisa de colar uma chave. As aplicações que não permitem iniciar sessão, ou as configurações que não devem abrir um navegador (servidores, CI), enviam uma chave API.

Claude (web, computador e telemóvel)

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

1. Vá a Personalizar, depois a Conectores, escolha Adicionar e, em seguida, Adicionar conector personalizado.
2. Dê-lhe o nome Zurelay e cole https://api.zurelay.com/mcp como URL do servidor MCP. Ambas as opções de cliente OAuth funcionam: Usar a identidade publicada do Claude ou Registar automaticamente. Adicione o conector.
3. Escolha Ligar. A Zurelay abre: inicie sessão, defina um limite de gastos diário e escolha Permitir.
4. Numa conversa, abra +, depois Conectores, ative a Zurelay e peça o que quiser: “Cria um cartaz 16:9 de…”, “Anima isto num vídeo de 5 segundos”, “Lê isto em voz alta com uma voz calma”.

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

Claude Code

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

Depois, escreva /mcp no Claude Code, escolha zurelay e inicie sessão no navegador que se abre (ou execute claude mcp login zurelay). Se preferir uma chave 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 a todas as pastas. Se omitir esta opção, só aparece quando o Claude Code é executado na pasta a partir da qual o adicionou; use --scope project para o partilhar através do .mcp.json do projeto (não coloque chaves em ficheiros partilhados: .mcp.json lê ${ZURELAY_API_KEY} do ambiente). Execute o comando num terminal normal, não dentro do Claude Code, e reinicie o Claude Code se já estiver aberto.

ChatGPT

1. Em Definições, Segurança e início de sessão, ative o Modo de programador (Plus, Pro, Business, Enterprise e Edu; pode ser necessária a autorização de um administrador do espaço de trabalho).
2. Abra Plugins do ChatGPT e prima +. Dê-lhe o nome Zurelay e introduza https://api.zurelay.com/mcp como URL de ligação, com OAuth.
3. Inicie sessão na Zurelay e escolha Permitir. Numa conversa, abra +, escolha Modo de programador e selecione Zurelay.

O ChatGPT só permite iniciar sessão: não pode enviar uma chave API.

Cursor

Adicionar Zurelay ao Cursor, depois escolha Ligar junto à Zurelay nas definições MCP do Cursor para iniciar sessão. Ou adicione o servidor a ~/.cursor/mcp.json (todos os projetos) ou a .cursor/mcp.json (um projeto):

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

VS Code

Adicionar Zurelay ao VS Code, ou adicione o servidor a .vscode/mcp.json no seu projeto (ou execute MCP: Add Server na Paleta de Comandos e escolha HTTP). O VS Code pede-lhe para iniciar sessão na primeira vez que o modo de agente do Copilot o utiliza. Com uma chave API, pede a chave uma vez e guarda-a encriptada:

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

Agentes de IA

Os agentes sempre ativos e os agentes pessoais adicionam o servidor da mesma forma: Grok Bot e Meta Muse quando cola uma mensagem a pedi-lo, OpenAI dots através dos plugins do ChatGPT, Gemini Spark, Manus e Perplexity nas definições de conectores. O OpenClaw e o Hermes Agent também o podem usar, ou usar a skill da Zurelay, que lhes atribui uma chave própria através de uma ligação que autoriza. Os passos para cada agente estão em Agentes de IA.

Codex, Gemini CLI e outras aplicações

Qualquer aplicação que comunique por MCP através de Streamable HTTP funciona. O Codex inicia sessão com codex mcp login zurelay e o Gemini CLI com /mcp auth zurelay; para usar uma chave, a maioria das aplicações 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"

Início de sessão ou chave API

Iniciar sessão é a forma mais simples e segura. A aplicação abre zurelay.com, onde inicia sessão com um código enviado por email, escolhe o espaço de trabalho a que serão debitados os custos e um limite de gastos diário, e autoriza a ligação. A Zurelay adiciona então à sua página de Chaves uma chave com o nome da aplicação, como “Claude (MCP)”, e esse limite. A aplicação nunca vê uma chave de API: guarda um token válido durante uma hora e um token de renovação que muda sempre que é utilizado, e ambos funcionam apenas no servidor MCP, nunca no resto da API. Altere o limite na página de Chaves ou revogue aí a chave para desligar a aplicação.

API Uma chave de é enviada no cabeçalho Authorization: Bearer zr_live_…. Aplicam-se todas as definições da chave: os orçamentos, o limite de pedidos, os modelos permitidos e os endereços IP permitidos. Crie uma chave exclusiva para a aplicação, com um orçamento diário, para que um agente com muita atividade não gaste mais do que previu (consulte Limites e regras das chaves). Aplicações como o Claude e o ChatGPT fazem chamadas a partir dos seus próprios servidores, por isso deixe os endereços IP permitidos em branco nas chaves destinadas a estas aplicações.

Preços, ligações e tempos de espera

• Os preços são os mesmos da API: consulte cada modelo na página de modelos ou peça à IA para chamar list_models. Não é cobrado qualquer valor por um pedido que falhe, e um vídeo só é cobrado quando estiver concluído.
• Uma ferramenta responde em cerca de 35 segundos. As imagens e a voz costumam ficar prontas nesse prazo; o que demorar mais (a maioria dos vídeos) devolve um identificador, e a IA chama get_result, que aguarda até mais 45 segundos de cada vez.
• Os resultados são ligações para o nosso armazenamento, válidas durante 24 horas. As imagens e os vídeos ficam na sua Biblioteca durante 30 dias, e cada pedido aparece na sua página de Pedidos como qualquer outro.
• As imagens incluem também uma pequena pré-visualização, para que a IA possa ver o que criou e fazer ajustes. Peça-lhe para omitir as pré-visualizações para poupar contexto.

Ficheiros do seu computador

Para editar uma imagem ou animar um fotograma, o modelo precisa de aceder ao ficheiro através de uma ligação. Os ficheiros que já estão online podem ser enviados através das respetivas ligações https. Para ficheiros no seu computador, as aplicações que podem executar comandos (Claude Code, Cursor, Codex) usam create_upload_link: um ficheiro PNG, JPEG, WebP, MP4, MOV, MP3 ou WAV de até 20 MB, carregado no prazo de 15 minutos. A ligação devolvida funciona durante 2 horas, e o ficheiro é eliminado após 2 dias. As ligações de carregamento exigem crédito na conta.

# 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 início de sessão segue a especificação MCP: OAuth 2.1 com PKCE (apenas S256), apenas endereços de redirecionamento registados e códigos de utilização única válidos durante 5 minutos. Se um código for usado duas vezes, tudo o que foi obtido em troca dele é invalidado.
• Os tokens são aleatórios e guardados apenas como hashes SHA-256. Os tokens de acesso são válidos durante uma hora e funcionam apenas no servidor MCP. Os tokens de renovação mudam a cada utilização; se um token voltar a ser usado mais de um minuto depois, é sinal de que foi copiado, pelo que a ligação é terminada e a respetiva chave é revogada.
• Cada ligação corresponde a uma chave na sua página de Chaves, com um limite diário próprio, visível aos membros do seu espaço de trabalho. Revogar a chave ou sair do espaço de trabalho desliga a aplicação.
• A página de consentimento não pode ser apresentada dentro de outro site e informa quando uma aplicação não é reconhecida pela Zurelay e para onde será redirecionado.
• As ligações de carregamento são assinadas, aceitam um único ficheiro e expiram em 15 minutos; os ficheiros carregados são eliminados após 2 dias.
• Cada chave e espaço de trabalho tem o seu próprio limite de pedidos para chamadas MCP, e cada chamada num lote conta.

Para programadores

O servidor usa MCP 2025-11-25 (e 2025-06-18, 2025-03-26 e 2024-11-05) sobre Streamable HTTP: envie JSON-RPC por POST para https://api.zurelay.com/mcp e receba JSON como resposta. Não mantém sessões, pelo que não há eventos enviados pelo servidor e GET responde com 405. Sem um token, responde com 401 e WWW-Authenticate a apontar para https://api.zurelay.com/.well-known/oauth-protected-resource/mcp; os metadados do servidor de autorização estão em https://api.zurelay.com/.well-known/oauth-authorization-server, com registo 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" }
    }
  }'

Resolução de problemas

• zurelay não aparece em /mcp do Claude Code: foi adicionado para outra pasta ou o Claude Code já estava em execução. Feche o Claude Code, execute o comando acima (com --scope user) num terminal normal e volte a iniciar o Claude Code. claude mcp list indica que é necessária autenticação até iniciar sessão.
• A aplicação pede constantemente para iniciar sessão: a chave que criou foi revogada ou o respetivo início de sessão não foi usado durante um ano. Volte a ligar a aplicação.
• “O seu saldo Zurelay está esgotado” ou “atingiu o orçamento diário”: adicione crédito na página de Faturação ou aumente o limite da chave na página de Chaves.
• “Este token pertence a uma aplicação ligada através do servidor MCP da Zurelay”: enviou o token de uma aplicação para a API. Use uma chave de API nesse caso.
• Um vídeo parece estar bloqueado: peça à IA para voltar a chamar get_result; os vídeos demoram entre 1 e 5 minutos, por vezes mais quando um modelo está ocupado.