Descubra tutoriais, melhores práticas e respostas rápidas sobre o Artia!
Configurações
Como conectar o Artia ao Codex

Quer acessar seus projetos, atividades e apontamentos do Artia enquanto trabalha no Codex? Neste artigo, mostramos como conectar os dois. A conexão é automática e pede um único comando.


Neste artigo:

  1. O que você precisa antes de começar?
  2. Como conectar o Artia ao Codex?
  3. Como entrar de novo ou trocar de usuário?
  4. E se a conexão 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 Codex até conecta, mas as consultas são recusadas com um aviso

URL do conector

https://mcp.artia.com/mcp

Codex

Instalado no seu computador

Bom saber: a configuração feita no terminal vale também para a extensão do Codex no editor, porque as duas usam o mesmo arquivo. Você só precisa conectar uma vez.


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 Codex?

  1. No terminal, rode:
codex mcp add artia --url https://mcp.artia.com/mcp
  1. O Codex detecta o login e abre o navegador. Entre no Artia e clique em Autorizar.
  2. O terminal mostra Successfully logged in. Pronto! O Artia 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. Como entrar de novo ou trocar de usuário?

Situação

Comando

Entrar de novo (por exemplo, com outro usuário)

codex mcp login artia

Computador sem navegador

codex mcp login artia --no-browser (o Codex mostra o link para você abrir em outro lugar)

4. E se a conexão não funcionar?

O Codex não tem a opção de conectar com Client ID: a conexão é sempre automática. Se ela falhar, atualize o Codex e tente de novo.


Ficou com alguma dúvida? Nosso time de suporte está pronto para ajudar.

Isso respondeu a sua pergunta?