Ligar o Claude.ai ao AssinaJá

No fim deste guia, pede ao Claude que envie um documento para assinatura e ele envia.

São dois lados: primeiro cria a chave no AssinaJá, depois aponta o Claude para ela. A ordem importa — a autorização vai pedir-lhe que escolha uma chave, e se não existir nenhuma o processo pára a meio.

Antes de começar

• No AssinaJá: ser Owner ou Admin. É quem pode criar chaves API — ver Papéis e permissões.
• No Claude.ai: um plano que permita conectores personalizados. À data deste guia, os planos Free, Pro, Max, Team e Enterprise permitem-no, com o plano Free limitado a um conector.

1. Criar a chave no AssinaJá

Em Definições → API Keys, escolha Nova API Key.

1. Nome — algo que identifique a ligação, por exemplo Claude.ai. Vai precisar de o reconhecer daqui a seis meses.
2. Data de validade — opcional, mas uma chave com prazo é uma chave que se revê.
3. Acessos — marque só o que quer que o assistente faça.

Comece sem o acesso de publicar

Marque Modelos — consultar, Documentos — consultar e Documentos — criar. Deixe Documentos — publicar de fora.

Com esta combinação o Claude prepara tudo e deixa o documento em rascunho — quem carrega no botão de enviar é você, na aplicação. Depois de perceber como ele se porta, acrescenta o acesso a publicar se quiser.

Escolha Criar chave.

A chave só é mostrada uma vez

Copie e guarde esta chave em local seguro. Não será mostrada novamente.

Para o Claude.ai, na verdade, não vai precisar de a copiar — a ligação é por OAuth e a chave é escolhida numa lista. Guarde-a à mesma: se um dia quiser usar a mesma integração no Claude Code, é aí que ela faz falta.

2. Adicionar o conector no Claude.ai

Os passos abaixo são da interface do Claude.ai em Agosto de 2026. Se os nomes não baterem certo, o guia oficial está em support.claude.com.

Numa conta individual (Free, Pro ou Max):

1. Abra Customize → Connectors.
2. Escolha + e depois Add custom connector.
3. No endereço do servidor, cole:

   https://app.assinaja.pt/mcp

4. Escolha Add.

Numa conta Team ou Enterprise, o conector é adicionado uma vez pelo proprietário, em Organization settings → Connectors → Add, passando por Custom e escolhendo Web. Depois disso, cada membro vai a Customize → Connectors e escolhe Connect para se autenticar com a sua própria conta — e, portanto, com a chave que escolher.

Deixe as “Advanced settings” em branco

O Claude.ai oferece campos opcionais para Client ID e Client Secret de OAuth. Não preencha nada: o servidor do AssinaJá regista o cliente automaticamente. Preencher esses campos com valores inventados faz a ligação falhar.

3. Autorizar

Ao adicionar o conector, o Claude abre a página de autorização do AssinaJá. Chama-se Ligar Claude ao AssinaJá e tem dois passos.

Se ainda não tiver sessão iniciada, inicia-a primeiro.

Passo 1 de 2 — escolha a API Key a usar

Abra a lista — aparece — selecionar uma API Key — — e escolha a chave que criou. Depois, Continuar.

Não tem nenhuma API Key ativa.

Crie uma no backoffice em Definições → API Keys e volte a tentar a ligação.

Se vir esta mensagem, saltou o passo 1 deste guia.

Passo 2 de 2 — confirme os acessos que está a conceder

Aqui vê a lista exata do que a chave permite. É a última oportunidade de reparar que marcou um acesso a mais.

Ao confirmar, fica registado que autorizou Claude a usar esta chave. Pode cortar o acesso a qualquer momento suspendendo ou eliminando a chave em Definições → API Keys.

Escolha Autorizar acesso. Aparece A estabelecer a ligação — “Aguarde — estamos a finalizar e a devolvê-lo ao Claude. Não feche esta janela.” — e volta ao Claude sozinho.

4. Confirmar que ficou a funcionar

Na conversa, peça algo que só resulte com a ligação de pé:

Lista os modelos disponíveis no AssinaJá.

Deve receber os modelos reais da sua organização. Se receber uma resposta genérica sobre o AssinaJá sem lista nenhuma, o conector não está a ser usado — confirme que está ativo em Customize → Connectors.

Um segundo teste, mais útil:

Cria um documento a partir do modelo X para o João Silva (joao@exemplo.pt) e deixa-o em rascunho.

Depois vá à lista de documentos e veja se está lá. É assim que verifica que a chave está ligada à organização certa.

5. Cortar o acesso

Não se desliga um conector destes pelo lado do Claude — desliga-se pelo lado da chave.

Em Definições → API Keys, Suspender a chave: “Suspensa, a chave deixa de autenticar até ser reativada.” O acesso do Claude cai no pedido seguinte.

Suspender é reversível e eliminar não é. Se está só a testar, ou desconfia de algo, suspenda.

Se correr mal

O que vê	O que fazer
Não tem nenhuma API Key ativa.	A chave não existe, está suspensa ou expirou. Crie ou reative uma.
O Claude não mostra ferramentas do AssinaJá	O conector não ficou ativo, ou a chave não tem nenhum acesso marcado.
O Claude vê documentos mas não os cria	Falta Documentos — criar na chave. Edite-a em Definições → API Keys.
O Claude cria mas nada é enviado	É o comportamento esperado sem Documentos — publicar, ou com a política de rascunho ligada.
A ligação falha ao adicionar o conector	Confirme que as Advanced settings de OAuth ficaram vazias.

Uma ferramenta que a chave não permite não aparece ao assistente, em vez de falhar quando é chamada. Por isso a resposta a “o Claude não consegue X” é quase sempre um acesso em falta na chave, e não uma avaria.

Ver também

• O que é o MCP — o modelo de segurança por trás disto
• Ligar o ChatGPT ao AssinaJá
• Criar uma chave API
• Entregar um ficheiro a um assistente