Ligar o Claude ao Nordlet

Este guia destina-se a utilizadores que pretendem que o Claude trabalhe com a sua contabilidade no Nordlet. O Claude liga-se ao servidor MCP do Nordlet em https://api.nordlet.com/mcp. A autorização da ligação é feita uma única vez, numa página do Nordlet, sem necessidade de copiar quaisquer chaves.

1. Criar uma conta no Nordlet

1. Aceda a app.nordlet.com e introduza o seu endereço de correio eletrónico.
2. Aceite os Termos de Serviço, a Política de Privacidade e o Acordo de Processamento de Dados. O Nordlet enviar-lhe-á um link de início de sessão, válido por 15 minutos e de utilização única. Não são utilizadas palavras-passe.
3. Abra o link recebido. Escolha um plano: a tarifa fixa, que inclui um período de teste gratuito, ou o pagamento por pedido (pay per request) com um primeiro carregamento (top-up).
4. Crie a sua empresa: nome, país, código de registo e número de IVA (VAT code). Se pretender apenas testar a aplicação, selecione a opção Empresa em modo de testes (sandbox company). O modo de testes armazena dados de teste e pode ser eliminado a qualquer momento.

Pode pertencer a várias empresas: a sua própria empresa e outras a cujos proprietários tenha sido convidado a aceder. O seu papel em cada empresa (proprietário, administrador, contabilista, gestor, programador ou visualizador) determina as ações que pode efetuar. O Claude herda exatamente os mesmos privilégios.

2. Ligar o Claude

1. No Claude, adicione um conector personalizado com o endereço https://api.nordlet.com/mcp. Deixe os campos de autenticação em branco.
2. O Claude abrirá uma página do Nordlet. Caso não tenha sessão iniciada, o Nordlet solicitará o seu endereço de correio eletrónico e enviará um link de acesso. Abra o link no mesmo navegador para regressar à página.
3. A página indicará o nome da aplicação que solicita o acesso, bem como o endereço de retorno. Confirme ambos os dados e clique em Permitir. A opção Recusar faz regressar à aplicação sem conceder acesso.
4. Ao regressar ao Claude, o conector estará estabelecido.

O Claude renova o seu acesso de forma autónoma. Um token de acesso é válido por uma hora, sendo substituído por um novo automaticamente, sem necessidade de intervenção do utilizador.

3. Ligar o Claude Code

Execute o seguinte comando:

claude mcp add --transport http nordlet https://api.nordlet.com/mcp

Em seguida, execute /mcp no Claude Code e selecione a opção para autenticar o servidor nordlet. O seu navegador abrirá a mesma página do Nordlet descrita no passo 2. Após selecionar Permitir, o navegador redirecioná-lo-á para o Claude Code no seu computador.

4. Trabalhar nas suas empresas

Uma única ligação é válida para todas as empresas de que seja membro. O Claude começará por listar as suas empresas e identificará a empresa em causa em cada chamada subsequente. Indique a empresa pelo respetivo nome, por exemplo, "emite esta fatura na UAB Pavyzdys". Quando for adicionado a uma nova empresa, o Claude poderá aceder-lhe de imediato. Caso seja removido de uma empresa, o acesso do Claude cessará de imediato.

Todas as chamadas efetuadas pelo Claude constituem pedidos de API regulares e são contabilizadas como tal. As alterações efetuadas ficam registadas no registo de auditoria (audit log).

5. Desligar

1. No Nordlet, aceda a Conta (Account) → Programadores (Developers). A ligação surge listada juntamente com as suas chaves de API, sob o nome da aplicação, por exemplo, "Claude".
2. Selecione Revogar (Revoke). O acesso do Claude será imediatamente revogado em todas as empresas.

Para restabelecer a ligação, repita o passo 2.

Utilizar uma chave de API em alternativa

Os proprietários, administradores e programadores podem gerar uma chave de API em Conta (Account) → Programadores (Developers) e transmiti-la no cabeçalho (header). Consulte a secção Servidor MCP.