Saltar para o conteúdo principal
O Krea disponibiliza um servidor Model Context Protocol (MCP) alojado para agentes e assistentes de programação. Utilize-o quando quiser que um cliente compatível com MCP chame o Krea diretamente em vez de escrever pedidos à API manualmente.
Não precisa de uma chave de API para ligar. Adicione https://api.krea.ai/mcp como URL do servidor MCP e, em seguida, inicie sessão com a sua conta Krea através do fluxo OAuth do seu cliente.

​
Detalhes do servidor

DefiniçãoValor
TransporteStreamable HTTP
URLhttps://api.krea.ai/mcp
AutenticaçãoOAuth
A faturação depende da forma como se autentica:
Método de autenticaçãoFonte de faturação
OAuthAs unidades de computação da sua conta Krea em sessão
Token de APIO saldo de API separado da sua workspace

​
Autenticação

A maioria dos clientes MCP utiliza OAuth automaticamente. Quando o cliente pedir para ligar, siga o fluxo de início de sessão no navegador e autorize o Krea. A utilização por OAuth é faturada à conta Krea em sessão, usando unidades de computação. Se o seu cliente MCP não suportar OAuth, pode autenticar-se com um token de API em alternativa:
Chave do cabeçalhoValor do cabeçalho
AuthorizationBearer KREA_API_TOKEN
Substitua KREA_API_TOKEN por um token obtido em krea.ai/app/api/tokens. Apenas os proprietários e administradores da workspace podem criar tokens de API. A utilização com token de API é faturada ao saldo de API da sua workspace, tal como as chamadas diretas à API. Consulte Chaves de API e faturação para mais detalhes sobre o saldo de API.
Armazene as credenciais MCP por token de API da mesma forma que armazena chaves de API. Não faça commit de ficheiros de configuração MCP que contenham tokens reais.

​
Claude Code

Execute este comando no terminal: 
claude mcp add --transport http krea-ai https://api.krea.ai/mcp
Inicie sessão com a sua conta Krea quando o Claude Code pedir para ligar. Reinicie o Claude Code ou recarregue os seus servidores MCP depois de adicionar o servidor.

​
Codex

  1. Abra Settings > MCP servers no Codex.
  2. Adicione um novo servidor.
  3. Selecione Streamable HTTP como transporte.
  4. Cole o URL do servidor:
https://api.krea.ai/mcp
  1. Guarde o servidor e inicie sessão com a sua conta Krea quando o Codex pedir para ligar.

​
Cursor

Abra a paleta de comandos, procure por Open MCP settings e adicione esta entrada a mcp.json: 
{
  "mcpServers": {
    "krea-ai": {
      "url": "https://api.krea.ai/mcp"
    }
  }
}
Reinicie o Cursor após guardar o ficheiro e, em seguida, inicie sessão com a sua conta Krea quando o Cursor pedir para ligar.

​
Utilizar o Krea através de MCP

Depois de ligado, peça ao seu agente para listar modelos do Krea ou inspecionar o esquema de um modelo antes de gerar. Os IDs dos modelos correspondem aos caminhos da API utilizados no resto da documentação para programadores, 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 descontinuado, o Krea devolve metadados de descontinuação através da descoberta de modelos MCP. Consulte Descontinuações para orientações de migração.

​
Resolução de problemas

ProblemaSolução
A autenticação falhaVolte a ligar o servidor MCP e complete o fluxo OAuth do Krea no navegador. Se utilizar um token de API, confirme que o cabeçalho é exatamente Authorization: Bearer KREA_API_TOKEN e que o token não foi revogado.
O cliente não consegue ligar-seConfirme que o cliente está configurado para Streamable HTTP e utiliza https://api.krea.ai/mcp.
A geração é rejeitada por faturaçãoSe ligou via OAuth, verifique as unidades de computação na sua conta Krea em sessão. Se ligou com um token de API, adicione saldo de API em krea.ai/app/api.
A chamada ao modelo falhaPeça ao seu agente para inspecionar o esquema do modelo antes de tentar novamente. Os pedidos MCP usam as mesmas entradas de modelo que a API.

​
Próximos passos

Chaves de API e faturação

Crie tokens de API e faça a gestão do saldo de API para pedidos autenticados por token.

Playground interativo

Experimente pedidos na aplicação Krea antes de pedir a um agente para os executar.

Descontinuações

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

APIs dos modelos

Explore os esquemas de endpoints e os parâmetros dos modelos.