Clipia MCP

Servidor MCP remoto hospedado para geração de imagens e vídeos por IA a partir de um endpoint HTTP Streamable.

Documentação

Clipia MCP

Crie imagens, vídeos, fala, música e apresentações com IA dentro do Claude, Cursor e ChatGPT — mais de 60 modelos em um único endpoint MCP.

Clipia é uma plataforma de criação com IA. Este servidor remoto e hospedado de Model Context Protocol (MCP) permite que qualquer agente compatível com MCP gere imagens, vídeos, fala e música; converse com modelos de texto; planeje e componha vídeos; crie e edite apresentações; consulte resultados; navegue por modelos; pesquise modelos de prompts; e leia seu saldo de créditos — sem SDK e sem necessidade de código.

Endpoint: https://mcp.clipia.ai/mcp — Streamable HTTP sem estado, autenticado com uma chave de API da Clipia.

Início rápido

Conecte o Clipia ao Claude Code em um único comando (substitua o espaço reservado pela sua chave):

claude mcp add --transport http clipia https://mcp.clipia.ai/mcp \
  --header "Authorization: Bearer <CLIPIA_API_KEY>"

Depois é só pedir no chat: "Gere uma imagem de cidade neon com Clipia" — a prévia aparece direto no terminal.

Onde obter uma chave: crie uma no Console do Desenvolvedor Clipia. A chave é exibida apenas uma vez.

Sandbox sem cobranças: chaves com o prefixo clipia_test_ rodam em um sandbox — resultados simulados instantâneos, sem gastar créditos. Use uma chave clipia_test_* para validar sua integração antes de ir para produção.

Conecte-se de qualquer cliente

O endpoint é o mesmo em todos os lugares: https://mcp.clipia.ai/mcp. IDEs e CLIs autenticam com uma chave de API do Console do Desenvolvedor; claude.ai e ChatGPT conectam-se fazendo login na sua conta Clipia via OAuth (sem necessidade de chave).

Configurações prontas para copiar estão em examples/.

Cliente	Como conectar	Autenticação
Claude Code	`claude mcp add --transport http clipia …` (veja Início rápido)	Chave de API
Claude Desktop	Ponte `mcp-remote` em `claude_desktop_config.json`	Chave de API
claude.ai (web/desktop/mobile)	Configurações → Conectores → Adicionar conector personalizado	OAuth
Cursor	`~/.cursor/mcp.json` (ou `.cursor/mcp.json` do projeto)	Chave de API
VS Code	`.vscode/mcp.json` (`servers` + `inputs`)	Chave de API
Cline	`cline_mcp_settings.json` (`mcpServers`)	Chave de API
Windsurf	`~/.codeium/windsurf/mcp_config.json` (`serverUrl`)	Chave de API
Codex CLI	`~/.codex/config.toml` (`bearer_token_env_var`)	Chave de API (env)
Gemini CLI	`gemini mcp add --transport http clipia …`	Chave de API
ChatGPT	Modo desenvolvedor → Apps e Conectores → Criar	OAuth

Claude Code

claude mcp add --transport http clipia https://mcp.clipia.ai/mcp \
  --header "Authorization: Bearer <CLIPIA_API_KEY>"

Claude Desktop

O Claude Desktop faz ponte para servidores HTTP remotos através de mcp-remote. Adicione em claude_desktop_config.json (Configurações → Desenvolvedor → Editar Configuração) e reinicie o Claude Desktop:

{
  "mcpServers": {
    "clipia": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.clipia.ai/mcp",
        "--header",
        "Authorization: Bearer <CLIPIA_API_KEY>"
      ]
    }
  }
}

claude.ai (web / desktop / mobile)

Abra Configurações → Conectores.
Clique em Adicionar conector personalizado e cole a URL: https://mcp.clipia.ai/mcp
Clique em Conectar e faça login na sua conta Clipia — sem necessidade de chave (OAuth).
Em um novo chat, peça uma imagem ou um vídeo: um card Clipia ao vivo com progresso e o resultado aparece dentro da mensagem.

Os créditos são cobrados na conta Clipia conectada.

Cursor

Adicione em ~/.cursor/mcp.json (global) ou .cursor/mcp.json (projeto) e reinicie o Cursor:

{
  "mcpServers": {
    "clipia": {
      "url": "https://mcp.clipia.ai/mcp",
      "headers": { "Authorization": "Bearer <CLIPIA_API_KEY>" }
    }
  }
}

VS Code

Crie .vscode/mcp.json no seu workspace (ou use o comando MCP: Adicionar Servidor). O VS Code solicita a chave na primeira execução e a armazena com segurança:

{
  "servers": {
    "clipia": {
      "type": "http",
      "url": "https://mcp.clipia.ai/mcp",
      "headers": { "Authorization": "Bearer ${input:clipia_api_key}" }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "clipia_api_key",
      "description": "Clipia API Key",
      "password": true
    }
  ]
}

Cline

O Cline lê mcpServers de seu cline_mcp_settings.json (Servidores MCP → Configurar Servidores MCP no painel do Cline):

{
  "mcpServers": {
    "clipia": {
      "url": "https://mcp.clipia.ai/mcp",
      "headers": { "Authorization": "Bearer <CLIPIA_API_KEY>" }
    }
  }
}

O Cline também pode instalar este servidor por conta própria — veja llms-install.md.

Windsurf

Adicione em ~/.codeium/windsurf/mcp_config.json (observe o campo serverUrl específico do Windsurf) e atualize Cascade → MCPs:

{
  "mcpServers": {
    "clipia": {
      "serverUrl": "https://mcp.clipia.ai/mcp",
      "headers": { "Authorization": "Bearer <CLIPIA_API_KEY>" }
    }
  }
}

Codex CLI

Adicione um bloco em ~/.codex/config.toml e exporte a chave para o seu ambiente — o Codex injeta Authorization: Bearer da variável automaticamente:

# ~/.codex/config.toml
[mcp_servers.clipia]
url = "https://mcp.clipia.ai/mcp"
bearer_token_env_var = "CLIPIA_API_KEY"

# in your environment:
# export CLIPIA_API_KEY=<CLIPIA_API_KEY>

Gemini CLI

gemini mcp add --transport http clipia https://mcp.clipia.ai/mcp \
  --header "Authorization: Bearer <CLIPIA_API_KEY>"

Verifique a conexão com gemini mcp list.

ChatGPT (Modo Desenvolvedor)

No ChatGPT (web): Configurações → Apps e Conectores → Configurações avançadas → ative o Modo desenvolvedor (Plus, Pro, Business, Enterprise).
De volta em Apps e Conectores → Criar. Dê o nome Clipia, URL do servidor MCP: https://mcp.clipia.ai/mcp.
Autenticação — OAuth, marque "Confio neste aplicativo", clique em Criar.
Faça login na sua conta Clipia no pop-up. Em um chat, pressione + → Mais → Clipia e peça em texto simples.

Esquemas de cabeçalho de autenticação suportados: Authorization: Bearer clipia_* (recomendado), Authorization: Key <key> ou X-Api-Key: <key>.

Ferramentas

O servidor sempre expõe 10 ferramentas principais ao agente. Em 26/07/2026, a produção expõe 15 ferramentas de agente: as 10 ferramentas principais mais chat, planejamento de cenários, composição de vídeo no servidor, geração de apresentações e edição de apresentações. Sete auxiliares exclusivos de aplicativo ficam ocultos do agente de IA. Esquemas compactos mantêm a janela de contexto do agente leve.

Ferramenta	O que faz
`generate_image`	Gera imagem(ns) a partir de um prompt de texto, opcionalmente com imagens de referência (edição / imagem-para-imagem). Aguarda brevemente e geralmente retorna a imagem finalizada inline (URL + pequena prévia). O custo em créditos é retornado.
`generate_video`	Inicia uma geração de vídeo a partir de um prompt de texto (texto-para-vídeo) ou de uma imagem inicial (imagem-para-vídeo, passe `image_url`). Retorna `request_id` e o custo em créditos imediatamente — as renderizações levam de 1 a 10 min, consulte com `wait_generation`.
`generate_audio`	Gera fala a partir de texto com uma voz e idioma selecionados. Retorna um MP3 quando concluído.
`generate_music`	Gera música de fundo ou trilha sonora a partir de uma descrição de clima, gênero e andamento.
`wait_generation`	Aguarda uma geração terminar (long-poll até `wait_seconds`, depois retorna o status atual). Chame repetidamente até `COMPLETED`, `FAILED` ou `CANCELED`. Retorna URLs de saída (e uma prévia inline) quando concluído.
`get_generation`	Obtém o status/resultado atual de uma geração sem esperar. Quando `COMPLETED`, `output.images[].url` é a prévia webp inline e `output.images[].original_url` é o PNG/JPG em qualidade total.
`list_models`	Lista modelos de IA disponíveis com tipo (texto/imagem/vídeo/áudio), capacidades e preços em créditos. Modelos de texto expõem taxas por 1K de entrada/saída; modelos de geração expõem um preço base. Filtre por `type` / `search`.
`get_model`	Obtém detalhes do modelo e preços: `input_schema` para modelos de geração; limites de contexto e taxas por 1K de entrada/saída para modelos de texto.
`get_balance`	Obtém o saldo de créditos da conta Clipia conectada e o uso de 30 dias da chave de API atual.
`search_templates`	Pesquisa mais de 3500 modelos de prompts selecionados (busca híbrida texto+semântica, consulta em russo ou inglês). Cada resultado tem um prompt pronto para uso e um modelo recomendado.
`chat`	Atualmente habilitado, com recurso controlado: converse com um LLM de texto usando um prompt ou matriz de mensagens; retorna texto de resposta, uso de tokens e custo em créditos.
`generate_scenario`	Atualmente habilitado, com recurso controlado: transforma um briefing em prompts de vídeo por cena e um prompt de trilha sonora.
`compose_video`	Atualmente habilitado, com recurso controlado: une de 2 a 20 cenas concluídas em um MP4 final com narração, trilha sonora e legendas opcionais.
`generate_presentation`	Atualmente habilitado, com recurso controlado: renderiza um PPTX editável, PDF e prévias a partir de uma especificação estruturada de apresentação.
`edit_presentation`	Atualmente habilitado, com recurso controlado: edita uma apresentação existente, reordena ou substitui slides, altera texto e tema, e reutiliza ilustrações inalteradas.
`app_get_generation`	Interno / somente aplicativo: consulta de status usada pelo card de visualização de geração do Clipia (MCP Apps). Oculto do modelo; prefira `get_generation`.

Modelos padrão (usados quando nenhum slug é passado): nano-banana-2 para imagens, seedance-2-fast-t2v / seedance-2-fast-i2v para vídeo. Substitua com um slug de modelo de list_models.

Por que Clipia

Pague da Rússia e CEI — cartões bancários russos, SBP, MIR, sem necessidade de VPN. Processadores ocidentais rejeitam esses; a Clipia é feita para este mercado (e funciona internacionalmente também).
Mais de 60 modelos principais, um endpoint — modelos ocidentais e chineses lado a lado: Veo 3.1, Sora, Kling 3, Seedance 2, Hailuo, Wan 2.7, Nano Banana, FLUX, Midjourney V7, Imagen 4 e mais. Sem precisar gerenciar várias assinaturas estrangeiras.
Sandbox sem cobranças — chaves clipia_test_* retornam resultados simulados instantâneos sem gastar créditos, perfeito para configurar uma integração ou CI.
Prévia ao vivo no chat (MCP Apps) — no claude.ai (web/desktop/mobile), cada geração renderiza um card interativo com progresso ao vivo, a mídia finalizada e um botão "Original". No Claude Code, a prévia aparece inline no terminal para iteração baseada em visão.
Mais de 3500 modelos de prompts — search_templates dá ao agente prompts selecionados e prontos para uso (busca híbrida, RU/EN), cada um com um modelo recomendado.
Custo em cada resposta — cada geração retorna seu custo exato em créditos, e get_balance mostra o saldo restante. Sem markup oculto de MCP.
Superfície de ferramentas compacta — 10 ferramentas principais com esquemas enxutos mantêm a janela de contexto do agente leve; capacidades habilitadas adicionam apenas as ferramentas necessárias.

SDK

Prefere chamar o Clipia do seu próprio código em vez de um agente? Use os SDKs oficiais contra a mesma API pública (fila estilo fal.ai submit → status → result, cobrança baseada em créditos):

TypeScript / Node: clipia-ai — npm install clipia-ai (também inclui uma CLI clipia).
Python: clipia — pip install clipia (clientes síncronos e assíncronos).

Ambos suportam webhooks com verificação de assinatura HMAC-SHA256 e as mesmas chaves de sandbox clipia_test_*.

Runtime do servidor Glama

O repositório inclui um runtime Docker mínimo para que o Glama possa iniciar a entrada do servidor público e inspecionar suas definições de ferramentas MCP. O contêiner é uma ponte stdio para o endpoint hospedado; ele não contém o aplicativo Clipia nem quaisquer credenciais.

Configure CLIPIA_API_KEY como um segredo no Glama. Use uma chave de sandbox com o prefixo clipia_test_ para que a validação nunca gaste créditos. A configuração opcional CLIPIA_MCP_URL tem como padrão https://mcp.clipia.ai/mcp e só aceita URLs HTTPS.

docker build -t clipia-mcp-glama .
docker run --rm -i \
  -e CLIPIA_API_KEY='<CLIPIA_TEST_API_KEY>' \
  clipia-mcp-glama

Preços

A cobrança é feita em créditos da sua conta Clipia conectada — o mesmo saldo do site. Cada geração retorna seu custo exato em créditos, e get_balance mostra o que resta. Modelos diferentes custam créditos diferentes dependendo da resolução, duração e qualidade.

Novas contas recebem um pequeno pacote de créditos de boas-vindas para avaliar a plataforma; depois disso, é necessária uma assinatura. Quatro planos mensais (Basic / Standard / Pro / Ultima) — veja clipia.ai/tariffs.

Chaves de sandbox clipia_test_* retornam resultados simulados sem cobrança de créditos — use-as para desenvolver e testar sem gastar.

🇷🇺 Para a Rússia e CEI

Clipia — plataforma de IA para geração de imagens, vídeos, fala, música e apresentações, além de chats de IA de texto e montagem de vídeos prontos. Para usuários da Rússia e CEI, estão disponíveis pagamento com cartão russo, SBP e MIR, sem VPN. Mais de 60 modelos ocidentais e chineses (Veo 3.1, Sora, Kling 3, Seedance 2, Nano Banana, FLUX, Midjourney V7) funcionam através de um único endpoint MCP diretamente do Claude, Cursor e ChatGPT.

Conexão em um único comando (chave — no console do desenvolvedor):

claude mcp add --transport http clipia https://mcp.clipia.ai/mcp \
  --header "Authorization: Bearer <CLIPIA_API_KEY>"

Chaves clipia_test_* — sandbox sem débito de créditos para depuração. Cobrança em créditos, o custo de cada geração é retornado na resposta. Tarifas: clipia.ai/tariffs.

Suporte e legal

Site: clipia.ai
Documentação: clipia.ai/en/docs/mcp
Política de Privacidade: clipia.ai/privacy
Termos: clipia.ai/terms
Suporte: support@clipia.ai

Clipia MCP

Documentação

Clipia MCP

Início rápido

Conecte-se de qualquer cliente

Claude Code

Claude Desktop

claude.ai (web / desktop / mobile)

Cursor

VS Code

Cline

Windsurf

Codex CLI

Gemini CLI

ChatGPT (Modo Desenvolvedor)

Ferramentas

Por que Clipia

SDK

Runtime do servidor Glama

Preços

🇷🇺 Para a Rússia e CEI

Links

Suporte e legal

Licença