Pular para o conteúdo principal
O Krea expõe um servidor Model Context Protocol (MCP) hospedado para agentes e assistentes de programação. Use-o quando quiser que um cliente compatível com MCP chame o Krea diretamente, em vez de escrever requisições de API manualmente.
Você não precisa de uma chave de API para se conectar. Adicione https://api.krea.ai/mcp como a URL do servidor MCP e, em seguida, faça login com sua conta Krea através do fluxo OAuth do seu cliente.

​
Detalhes do servidor

ConfiguraçãoValor
TransporteStreamable HTTP
URLhttps://api.krea.ai/mcp
AutenticaçãoOAuth
A cobrança depende de como você se autentica:
Método de autenticaçãoOrigem da cobrança
OAuthUnidades de computação da conta Krea conectada
Token de APISaldo de API separado do seu workspace

​
Autenticação

A maioria dos clientes MCP usa OAuth automaticamente. Quando o cliente pedir para você se conectar, siga o fluxo de login no navegador e autorize o Krea. O uso via OAuth é cobrado da conta Krea conectada usando unidades de computação. Se o seu cliente MCP não oferece suporte a OAuth, você pode se autenticar com um token de API:
Chave do headerValor do header
AuthorizationBearer KREA_API_TOKEN
Substitua KREA_API_TOKEN por um token de krea.ai/app/api/tokens. Apenas proprietários e administradores do workspace podem criar tokens de API. O uso via token de API é cobrado do saldo de API do seu workspace, da mesma forma que chamadas diretas à API. Veja Chaves de API e cobrança para detalhes sobre o saldo de API.
Armazene credenciais MCP com token de API da mesma forma que você armazena chaves de API. Não faça commit de arquivos de configuração MCP que contenham tokens reais.

​
Claude Code

Execute este comando no seu terminal: 
claude mcp add --transport http krea-ai https://api.krea.ai/mcp
Faça login com sua conta Krea quando o Claude Code pedir para você se conectar. Reinicie o Claude Code ou recarregue seus servidores MCP após adicionar o servidor.

​
Codex

  1. Abra Settings > MCP servers no Codex.
  2. Adicione um novo servidor.
  3. Selecione Streamable HTTP como transporte.
  4. Cole a URL do servidor:
https://api.krea.ai/mcp
  1. Salve o servidor e faça login com sua conta Krea quando o Codex pedir para você se conectar.

​
Cursor

Abra a paleta de comandos, busque por Open MCP settings e adicione esta entrada ao mcp.json: 
{
  "mcpServers": {
    "krea-ai": {
      "url": "https://api.krea.ai/mcp"
    }
  }
}
Reinicie o Cursor após salvar o arquivo e faça login com sua conta Krea quando o Cursor pedir para você se conectar.

​
Usando o Krea através do MCP

Uma vez conectado, peça ao seu agente para listar os modelos do Krea ou inspecionar o schema de um modelo antes de gerar. Os IDs dos modelos correspondem aos caminhos da API usados no restante da documentação para desenvolvedores, como image/krea/krea-2/medium ou video/google/veo-3.1. Por exemplo: 
List the available Krea image models, then generate an image with Krea 2 using a 16:9 aspect ratio.
Se um modelo estiver obsoleto, o Krea retorna metadados de descontinuação através da descoberta de modelos via MCP. Veja Descontinuações para orientação sobre migração.

​
Solução de problemas

ProblemaSolução
Falha na autenticaçãoReconecte o servidor MCP e conclua o fluxo OAuth do Krea no seu navegador. Se você usa um token de API, confirme se o header é exatamente Authorization: Bearer KREA_API_TOKEN e se o token não foi revogado.
O cliente não consegue conectarConfirme se o cliente está configurado para Streamable HTTP e usa https://api.krea.ai/mcp.
Geração rejeitada por cobrançaSe você conectou via OAuth, verifique as unidades de computação da conta Krea conectada. Se conectou via token de API, adicione saldo de API em krea.ai/app/api.
Falha na chamada ao modeloPeça ao seu agente para inspecionar o schema do modelo antes de tentar novamente. Requisições MCP usam as mesmas entradas dos modelos que a API.

​
Próximos passos

Chaves de API e cobrança

Crie tokens de API e gerencie o saldo de API para requisições autenticadas por token.

Playground interativo

Teste requisições no app do Krea antes de pedir para um agente executá-las.

Descontinuações

Veja como o MCP expõe metadados de migração de modelos.

APIs de modelos

Explore schemas de endpoints e parâmetros de modelos.