Quer trabalhar com seus projetos, atividades e apontamentos do Artia sem sair do terminal? Neste artigo, mostramos como conectar o Artia ao Claude Code. A conexão é automática e leva poucos comandos.
Neste artigo:
- O que você precisa antes de começar?
- Como conectar o Artia ao Claude Code?
- O Artia vale para todos os meus projetos?
- E se a conexão automática não funcionar?
1. O que você precisa antes de começar?
Requisito | Detalhe |
|---|---|
Usuário ativo no Artia | Com acesso ao Artia pelo navegador (e-mail e senha, login social ou SSO) |
Organização no plano Enterprise | Nos demais planos, o Claude Code até conecta, mas as consultas são recusadas com um aviso |
URL do conector |
|
Claude Code | Instalado no seu computador |
Dica: copie e cole os comandos deste artigo em vez de digitar. Um caractere diferente já faz a conexão falhar.
2. Como conectar o Artia ao Claude Code?
- No terminal, rode:
claude mcp add --transport http --scope user artia https://mcp.artia.com/mcp- Abra o Claude Code (
claude), digite/mcp, escolha artia e depois Authenticate. - O navegador abre o login do Artia. Entre com seu usuário e clique em Autorizar.
- Volte ao terminal: o Artia aparece como conectado e fica disponível nas próximas sessões.
Bom saber: a tela de autorização do Artia mostra o nome da ferramenta que está se conectando e aparece em toda conexão nova. Confira o nome antes de autorizar. Se não foi você quem iniciou a conexão, clique em Cancelar.
3. O Artia vale para todos os meus projetos?
Depende de como você adicionou o Artia:
Como foi adicionado | Onde o Artia fica disponível |
|---|---|
Com | Em todos os seus projetos |
Sem essa opção | Só na pasta em que você rodou o comando |
4. E se a conexão automática não funcionar?
Você pode usar o Client ID do Artia como alternativa, com uma porta fixa:
- Remova o servidor e adicione de novo com o Client ID e a porta:
claude mcp remove --scope user artia
claude mcp add --transport http --scope user --client-id artia-mcp-claude-code --callback-port 8976 artia https://mcp.artia.com/mcp
- Autentique de novo pelo
/mcp.
Importante: não informe Client secret. O Client ID do Artia é público.
Ficou com alguma dúvida? Nosso time de suporte está pronto para ajudar.