Ligar Claude e Claude Code à TEISENDA
Ligue Claude ou Claude Code à sua conta e escolha os Spaces.
Nesta página
Ligue Claude à sua conta TEISENDA e escolha os Spaces para acesso. Claude Code tem um procedimento próprio. Um Space é uma área de trabalho partilhada na app.
Nota
Precisa de uma conta TEISENDA; saiba mais em O que precisa antes de ligar.
As instruções da Anthropic indicam que planos do Claude permitem Connectors personalizados. Em Team e Enterprise, um Owner tem de adicionar primeiro o Connector (como proceder).
A TEISENDA ainda não está publicada no diretório do Claude. Adicione o Connector manualmente.
Adicione o Connector manualmente
Copie este endereço para o campo do URL do servidor:
https://mcp.teisenda.com/mcp
-
Abra os conectores
Os rótulos observados abaixo estão em alemão. Na barra lateral do Claude, clique em «Anpassungen» e depois em «Konnektoren».
-
Adicione um Connector personalizado
Clique em «Hinzufügen» e escolha «Benutzerdefinierten Connector hinzufügen». Introduza um nome à sua escolha em «Name» e o endereço em «MCP-Server-URL»; depois clique em «Weiter».
-
Escolha a autorização
Em «Authentifizierung», escolha «Jetzt anmelden» e, em «OAuth-Client», «Claudes veröffentlichte Identität verwenden». Deixe vazios os campos de ID e segredo de cliente. Segundo as instruções da Anthropic, não pode alterar estas definições mais tarde.
-
Inicie sessão na TEISENDA
O Claude encaminha o navegador para a TEISENDA; siga os passos de início de sessão e seleção de Spaces.
-
Ative o Connector na conversa
Segundo as instruções da Anthropic em inglês, na conversa escolha «+», «Connectors» e ative o Connector.
Inicie sessão e escolha os Spaces
-
Inicie sessão na TEISENDA
Inicie sessão como habitualmente. Com e-mail e palavra-passe, introduza também o código se a autenticação de dois fatores estiver ativada (Iniciar e terminar sessão). Se já tiver sessão iniciada, vê diretamente a página de consentimento.
-
Escolha os Spaces e confirme
Verifique Conta, Aplicação e, se existir, Regresso a; a própria aplicação indica o seu nome. Todos os Spaces disponíveis e Também para os Spaces a que me juntar mais tarde estão assinalados: desmarque o que não pretende e clique em Ligar.
O Claude mostra o Connector em «Meine» como «Verbunden». A TEISENDA mostra-o em Gerir ligações.
Convém saber
- Com Também para os Spaces a que me juntar mais tarde, todos os Spaces a que adira mais tarde passam a pertencer à ligação sem confirmação.
- Conclua a autorização dentro de 10 minutos e no mesmo navegador.
- A ligação só pode trabalhar em Spaces a que pertence.
Se algo não funcionar
O Claude indica que a ligação foi recusada
Clicou em Cancelar na página de consentimento e não foi criada nenhuma ligação. Recomece a ligação no Claude e confirme na página de consentimento.
Não é membro de nenhum Space.
Esta frase aparece na página de consentimento em vez dos Spaces. A ligação só pode trabalhar em Spaces a que pertence; saiba como aderir em Aceitar um convite.
O Connector mostra a página de autorização expirada
O regresso ao Connector falhou: passaram mais de 10 minutos desde o início no Claude, concluiu a autorização noutro navegador ou esta já estava concluída. Recomece a ligação no Claude e conclua-a dentro de 10 minutos no mesmo navegador.
A página de início de sessão ou de consentimento da TEISENDA mostra uma mensagem
As causas e soluções destas mensagens estão em Resolver problemas do Connector.
Outras questões sobre ligar no Claude
Como adiciona um Owner o Connector em Team ou Enterprise?
Segundo as instruções da Anthropic em inglês, um membro sem a função Owner não pode adicionar um Connector personalizado nestes planos; os rótulos abaixo também vêm dessas instruções.
Abra «Organization settings > Connectors», escolha «Add» e «Custom» (se o Claude perguntar o tipo, «Web»), introduza o endereço https://mcp.teisenda.com/mcp e clique em «Add». Depois, cada membro clica em «Connect» no Connector assinalado como «Custom», em «Customize > Connectors», e inicia sessão como acima.
Que outras definições de autorização existem?
«Bei Bedarf anmelden» inicia mais tarde a mesma autorização que «Jetzt anmelden». «Keine Anmeldung» não funciona porque o Connector não pode ser utilizado sem autorização. Em «OAuth-Client», «Automatisch registrieren» também pode funcionar; «Eigenen OAuth-Client verwenden» não é uma opção porque a TEISENDA não fornece IDs de cliente.
Bloqueie ferramentas individuais ou remova o Connector no Claude
Em «Anpassungen» e «Konnektoren», abra o Connector. Em «Tool-Berechtigungen», escolha para cada ferramenta (título em inglês, por exemplo «List projects») «Immer erlauben», «Genehmigung erforderlich» ou «Blockiert».
Atenção
Se remover o Connector no Claude («Entfernen»), a ligação na TEISENDA pode manter-se. Para garantir o fim, termine-a aí em Aplicações ligadas, conforme Gerir ligações.
Se a autorização expirou, ligue novamente a aplicação.
Ligue Claude Code
Nota
Claude Code está instalado no seu computador e tem um navegador para a autorização.
Adicione o Connector no Claude Code com este comando:
claude mcp add --transport http teisenda https://mcp.teisenda.com/mcp
A fonte são as instruções da Anthropic.
-
Adicione o Connector
Execute o comando num terminal.
teisendaé o nome do Connector no Claude Code. -
Inicie sessão na TEISENDA
No Claude Code, introduza
/mcpou executeclaude mcp login teisendae siga os passos no navegador (Inicie sessão e escolha os Spaces). A página de consentimento mostra como hostlocalhostou127.0.0.1.
Depois, o navegador regressa ao Claude Code e a TEISENDA apresenta a ligação com o nome Claude Code na página das suas ligações.
Se algo não funcionar no Claude Code
Claude Code indica que a ligação foi recusada
Clicou em Cancelar na página de consentimento e não foi criada nenhuma ligação. Recomece a autorização com /mcp ou claude mcp login teisenda e confirme na página de consentimento.
O Connector mostra a página de autorização expirada
Passaram mais de 10 minutos desde o início no Claude Code, concluiu a autorização noutro navegador ou esta já estava concluída. Recomece a autorização e conclua-a dentro de 10 minutos no mesmo navegador.
O navegador não abre automaticamente
Copie o endereço mostrado pelo Claude Code e abra-o manualmente. Conclua a autorização dentro de 10 minutos no mesmo navegador.
Depois da autorização, o navegador mostra um erro de ligação
O navegador não consegue alcançar Claude Code no seu computador. Cole o endereço completo da barra de endereços do navegador no campo apresentado pelo Claude Code.
claude mcp add indica que o servidor já existe na configuração
Já existe uma entrada com este nome no mesmo âmbito. Mantenha a entrada ou remova-a primeiro com claude mcp remove teisenda.
Claude Code mostra um aviso que remete para /mcp
A TEISENDA já não aceita a autorização guardada e esta não pode ser renovada: a ligação terminou na TEISENDA ou a autorização expirou. Abra /mcp e escolha «Re-authenticate» para o Connector. É criada uma nova ligação na TEISENDA; escolha os Spaces na página de consentimento.
Outras questões sobre Claude Code
A que projetos se aplica a entrada?
Segundo as instruções da Anthropic, sem a opção --scope, a entrada só se aplica ao projeto em que executou o comando. Com --scope user, fica disponível em todos os seus projetos.
Como termino sessão ou removo o Connector no Claude Code?
No menu de /mcp, escolha «Clear authentication» para o Connector ou execute claude mcp logout teisenda. Com claude mcp remove teisenda, remova o Connector; segundo as instruções da Anthropic, Claude Code também elimina a autorização guardada. Para garantir o fim da ligação, termine-a na TEISENDA conforme Gerir ligações.
Os Connectors de claude.ai também estão disponíveis no Claude Code?
As instruções da Anthropic indicam que sim, se Claude Code tiver sessão iniciada com uma conta claude.ai. /mcp identifica-os como provenientes de claude.ai. Um Connector adicionado diretamente no Claude Code tem prioridade se o endereço for igual.
A seguir
Saiba o que passa pelo Connector em Dados; se tiver questões, contacte o suporte.