Abyssale

O servidor MCP da Abyssale permite que um assistente de IA atue no seu workspace da Abyssale diretamente de uma conversa: navegue pelos seus designs e projetos, consulte fontes e créditos, gere banners, vídeos e PDFs, e importe novos designs a partir de JSON, sem que você escreva qualquer código contra a API REST. Ele utiliza o protocolo padrão MCP.

Claude Code CLI, Claude.ai, ChatGPT/Codex e Cursor, por enquanto

Claude Code CLI, Claude.ai, ChatGPT/Codex e Cursor são clientes registrados atualmente. Outros clientes MCP (Claude Desktop, e assim por diante) ainda não estão registrados — esta página listará a configuração de cada um conforme for adicionada.

Conectar

Propriedade	Detalhe
Endpoint	https://mcp.abyssale.com/mcp
Transporte	HTTP transmissível
Método	Somente POST
Sessões	Nenhuma — sem estado, então nada para reconectar ou expirar
Autenticação	OAuth (Auth0) — veja Autenticação

Aponte um cliente MCP para o endpoint acima — mas cada cliente ainda precisa do seu próprio ID de cliente registrado para concluir o login OAuth, e a Abyssale registra cada cliente separadamente antes que ele possa se conectar.

Claude Code CLI

claude mcp add --transport http --client-id tpc_iJ7LWqVdzR7c7jf21gMqDQ --callback-port 3418 \
  -s user abyssale_prod https://mcp.abyssale.com/mcp

--client-id e --callback-port são obrigatórios

Ambas as flags são obrigatórias para o Claude Code CLI, exatamente como mostrado — o login OAuth falha sem elas. O ID de cliente acima (tpc_iJ7LWqVdzR7c7jf21gMqDQ) está registrado especificamente para o Claude Code CLI e não funcionará para outro cliente.

Claude.ai

1. No Claude.ai, vá para Configurações → Conectores → Adicionar conector personalizado.
2. Defina Nome como Abyssale e URL do servidor MCP remoto como https://mcp.abyssale.com/mcp, depois clique em Continuar.

3. Em Cliente OAuth, selecione Usar seu próprio cliente OAuth e insira tpc_j2jnfXMh54sdoP7qu4ziEJ como o ID do cliente — deixe o segredo em branco.

4. Clique em Adicionar e conclua a etapa de login e consentimento que se segue.

Enviando arquivos locais ao criar um design

O caminho de upload de arquivos locais de import_design_from_json precisa que o sandbox do Claude.ai alcance o bucket de upload da Abyssale. Um administrador do workspace do Claude.ai precisa adicioná-lo à lista de permissões de domínio primeiro:

1. Vá para claude.ai/admin-settings/capabilities.
2. Em Lista de permissões de domínio → Domínios adicionais permitidos, adicione https://production-templates-imports.s3.eu-west-1.amazonaws.com e clique em Adicionar.

Ignore esta etapa se você sempre fornecer uma URL já hospedada ou dados de imagem base64 inline — apenas o caminho de upload com nome de arquivo simples precisa disso.

Este ID de cliente é específico do Claude.ai

O ID acima (tpc_j2jnfXMh54sdoP7qu4ziEJ) está registrado especificamente para o Claude.ai e não funcionará para o Claude Code CLI, que usa seu próprio ID (veja acima).

ChatGPT/Codex

1. No ChatGPT, vá para Configurações → Segurança e login e ative o Modo desenvolvedor.

2. Vá para Configurações → Plugins (ou chatgpt.com/plugins) e clique em + no canto superior direito.

3. Preencha o formulário Novo plugin: defina Nome como Abyssale e, em Conexão, defina URL do servidor como https://mcp.abyssale.com/mcp. Defina Autenticação como OAuth, depois abra Configurações avançadas de OAuth e, em Registro de cliente, defina Método de registro como Cliente OAuth definido pelo usuário e insira tpc_apBFqj5apvraYP3gX4spTq como o ID do cliente OAuth — deixe o segredo em branco e o método de autenticação do endpoint de token definido como none. Marque Entendo e quero continuar.

4. Clique em Criar e conclua a etapa de login e consentimento que se segue.

Uma configuração, dois aplicativos

Os conectores adicionados no site do ChatGPT são compartilhados com o aplicativo Codex — nenhuma configuração separada é necessária lá.

Este ID de cliente é específico do ChatGPT/Codex

O ID acima (tpc_apBFqj5apvraYP3gX4spTq) está registrado especificamente para o ChatGPT/Codex e não funcionará para o Claude Code CLI ou Claude.ai, que usam seus próprios IDs (veja acima).

Cursor

1. No Cursor, vá para Configurações → MCPs e clique em Novo servidor MCP. Isso abre ~/.cursor/mcp.json no editor.
2. Adicione uma entrada abyssale com o endpoint e o ID de cliente abaixo, depois salve o arquivo.

{
  "mcpServers": {
    "abyssale": {
      "url": "https://mcp.abyssale.com/mcp",
      "auth": {
        "CLIENT_ID": "tpc_rusyFsfRzoeCprRzoumUwS"
      }
    }
  }
}

3. Conclua a etapa de login e consentimento que abre no seu navegador. De volta em Configurações → MCPs, abyssale aparece como Conectado quando estiver concluído.

Este ID de cliente é específico do Cursor

O ID acima (tpc_rusyFsfRzoeCprRzoumUwS) está registrado especificamente para o Cursor e não funcionará para Claude Code CLI, Claude.ai ou ChatGPT/Codex, que usam seus próprios IDs (veja acima).

A porta de retorno de chamada OAuth do Cursor não é configurável

O aplicativo de desktop do Cursor sempre redireciona para http://localhost:8787/callback — não há configuração mcp.json para alterar essa porta, ao contrário da flag --callback-port do Claude Code CLI.

A primeira chamada de ferramenta — ou, para clientes que suportam, a própria conexão — aciona uma etapa de login e consentimento no seu navegador. Veja Autenticação para saber o que isso exige e o que concede.

Para onde ir a seguir

• Autenticação — como você faz login e o que cada escopo de permissão desbloqueia.
• Referência de ferramentas — cada ferramenta, seus parâmetros e um exemplo de chamada.
• Permissões — o que cada ferramenta pode realmente fazer e o que verificar antes de autorizá-la.

Suporte

Algo não está funcionando, ou tem uma pergunta que os documentos não respondem? Entre em contato com a equipe da Abyssale pelo central de ajuda.