Model Context Protocol

O repositório de marcas angolanas, dentro do teu assistente.

Um servidor MCP que dá o catálogo Nalogoo ao Claude Desktop, ao Claude Code e ao Cursor. Pedes uma marca em português corrente e o ficheiro oficial fica no teu disco, sem abrires o site.

Pesquisa por nome, categoria ou formato, sem tropeçar em acentos
Confirma a marca vendo o logótipo, antes de o usar
Guarda o ficheiro oficial no disco e diz onde ficou

Versão: 1.0.1
Pacote: nalogoo-mcp
Node: 20 ou mais recente

Ligar

Não há instalação à parte. O servidor arranca em stdio, por isso é o teu cliente de IA que o lança, normalmente com npx, que o vai buscar na hora e corre sempre a versão mais recente.

Claude Code

claude mcp add nalogoo -e NALOGOO_LICENSE_KEY=NLG-XXXX-XXXX-XXXX -- npx -y nalogoo-mcp

Claude Desktop, Cursor e outros clientes com JSON

{
  "mcpServers": {
    "nalogoo": {
      "command": "npx",
      "args": ["-y", "nalogoo-mcp"],
      "env": {
        "NALOGOO_LICENSE_KEY": "NLG-XXXX-XXXX-XXXX"
      }
    }
  }
}

A chave é a mesma que usas nos plugins do Photoshop, do Illustrator, do InDesign, do Premiere Pro e do After Effects — a mesma conta, a mesma chave, sem nada para registar outra vez. Preferes uma chave à parte, só para o MCP, ou precisas de mais volume? Usa uma chave de API.

Ferramentas

procurar_logos: Pesquisa por nome, categoria ou formato. Ignora acentos e maiúsculas.
listar_categorias: As categorias que existem, e quantos logótipos tem cada uma.
detalhe_logo: Formatos, variantes, cor, descrição e redes sociais.
ver_logo: Devolve a imagem, para o modelo confirmar que é mesmo a marca certa.
descarregar_logo: Guarda o ficheiro oficial no disco e devolve o caminho.
estado_ligacao: A que servidor estás ligado, como estás autenticado e como está a licença.

Chaves

A tua licença — a chave que puseste em NALOGOO_LICENSE_KEY é a mesma dos plugins - não precisas pedir outra para ligar o MCP.

Tem cota: um tecto de pedidos por janela de tempo, à medida do uso de uma pessoa. Quando esgota, as ferramentas dizem quanto foi gasto e quando renova, em vez de falharem como se a ligação tivesse caído.

E conta como mais um dispositivo da licença — o mesmo número que vês em «Dispositivos» na tua conta. Os plugins dos vários editores contam como um só, porque reconhecem que és a mesma pessoa; um servidor MCP não consegue provar isso a quem está do outro lado.

Uma chave só para o MCP — se quiseres deixar a licença de fora, ou precisares de mais cota, adquire uma chave de API externa e põe-na em NALOGOO_API_KEY, em vez da de licença.

É uma credencial à parte, sem nada a ver com a dos plugins: não ocupa dispositivo, não está presa a uma pessoa e não expira — serve equipas, automações e máquinas que correm sozinhas. Troca só o nome da variável, no mesmo bloco env da configuração acima; se as duas estiverem definidas, manda a de API.

Pede a tua ao suporte.

Em qualquer dos casos, estado_ligacao diz com que chave estás a entrar e quanto da cota já foi gasta em cada janela — pergunta isso ao assistente antes de assumir que algo avariou.

Variáveis

NALOGOO_LICENSE_KEY: A mesma chave de licença que usas nos plugins. Conta como um dispositivo e tem cota.
NALOGOO_API_KEY: Chave de API externa, para quem quer uma chave só para o MCP ou mais cota. Não conta dispositivo e manda à frente da chave de licença.
NALOGOO_DOWNLOAD_DIR: Onde os ficheiros transferidos são guardados. Por omissão, ~/nalogoo-logos.

Há mais duas variáveis, para túneis de desenvolvimento e para mudar onde fica o identificador da instalação. Estão no README do pacote.