Integrações

Servidor MCP

Dê ao seu agente o poder de criar. Conecte por URL — sem download, sem npx, sem arquivo de config — e gere imagens, vídeos e edições por tool-calling, com a sua conta e seus créditos.

Conecte em 3 passos

O endpoint MCP hospedado do Caranguejo é o mesmo pra qualquer cliente:

url

https://mcp.caranguejo.art/mcp

Copie a URL

O bloco acima — é o mesmo endpoint pra qualquer cliente MCP.

Adicione o conector

No Claude, abra Configurações → Conectores, adicione um conector personalizado chamado “Caranguejo” e cole a URL. No Cursor: Settings → MCP → Add, mesma URL. Abrir conectores no Claude

Conecte e entre

Clique em Conectar e faça login na sua conta Caranguejo (OAuth) — pronto. É só pedir pro agente gerar.

Avançado: agentes headless

Claude Code, agentes de terminal e outros clientes sem UI de conectores usam a mesma URL com um header de autenticação:

http

https://mcp.caranguejo.art/mcp
Authorization: Bearer ck_live_xxxxxxxx

Um comando só, com transporte remoto:

bash

claude mcp add --transport http caranguejo https://mcp.caranguejo.art/mcp \
  --header "Authorization: Bearer ck_live_xxxxxxxx"

Clientes sem suporte a MCP remoto ainda podem rodar o pacote localmente via stdio:

claude_desktop_config.json

{
  "mcpServers": {
    "caranguejo": {
      "command": "npx",
      "args": ["-y", "@caranguejo/mcp"],
      "env": { "CARANGUEJO_API_KEY": "ck_live_xxxxxxxx" }
    }
  }
}

Pegue sua chave ck_live_… em Conta → Apps & API. Opcional: CARANGUEJO_BASE_URL para apontar a outra API no caminho legado.

Tools disponíveis

Tool	O que faz	Principais args
`generate`	Geração genérica com qualquer modelo (imagem, vídeo ou tool). Aguarda o resultado por padrão.	`model`, `prompt`, `image_urls`, `params`
`generate_image` image	Atalho texto→imagem / edição.	`prompt`, `quality`, `resolution`, `size`, `image_urls`
`generate_video` video	Atalho texto→vídeo / imagem→vídeo.	`model`, `prompt`, `image_url`, `duration_seconds`, `aspect_ratio`
`run_tool` tool	Upscale / relight / enhance / inpaint sobre uma mídia.	`model`, `input_url`, `params`
`get_generation_status`	Consulta um job e retorna as URLs de saída.	`id`
`upload_file`	Hospeda um arquivo local e devolve uma URL pública para referência.	`path`
`list_models`	Lista o catálogo de modelos e suas capacidades.	`type` (opcional)
`list_generations`	Lista suas gerações via API.	`limit`, `cursor`
`get_balance`	Saldo de créditos da conta.	—

Recursos navegáveis: caranguejo://models (capacidades ao vivo) e caranguejo://pricing (matriz de créditos).

Na prática

Depois de configurar, é só pedir em linguagem natural. Exemplos:

“Gere um mockup de app de delivery, estilo iOS, 3:2, alta qualidade.” → o agente chama generate_image.
“Anime esta foto girando 360°, 5s, 9:16.” (anexe a imagem) → upload_file + generate_video.
“Dá um upscale 4× nesta imagem.” → run_tool com o modelo de upscale.