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

Quer consultar e atualizar seus projetos, atividades e apontamentos do Artia sem sair do Cursor? Neste artigo, mostramos como conectar os dois. A configuração é feita uma vez só e vale tanto para o app desktop quanto para a CLI do Cursor (agent), que compartilham a mesma configuração.


Neste artigo:

  1. O que você precisa antes de começar?
  2. Como conectar o Artia ao Cursor?
  3. Como entrar pela CLI do Cursor?


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 Cursor até conecta, mas as consultas são recusadas com um aviso

URL do conector

https://mcp.artia.com/mcp

Client ID

artia-mcp-cursor

Cursor

App desktop ou CLI do Cursor (agent)


Bom saber: o Cursor ainda não suporta a conexão automática. Por isso, ele usa um Client ID fixo do Artia, que já está neste artigo.

Dica: copie e cole a configuração deste artigo em vez de digitar. Um caractere diferente já faz a conexão falhar.

2. Como conectar o Artia ao Cursor?

  1. Abra o arquivo ~/.cursor/mcp.json, que vale para todos os projetos. Se ele não existir, crie-o.
  2. Adicione o Artia dentro de mcpServers. Se o arquivo já tiver outros servidores, acrescente só o bloco "artia":
{
"mcpServers": {
"artia": {
"url": "https://mcp.artia.com/mcp",
"auth": {
"CLIENT_ID": "artia-mcp-cursor",
"scopes": ["read", "write"]
}
}
}
}
  1. Salve o arquivo.
  2. Em Cursor Settings, na lista de servidores MCP, clique para conectar o artia. O navegador abre o login do Artia: entre e clique em Autorizar.


Importante: não preencha CLIENT_SECRET. O Client ID do Artia é público.

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 pela CLI do Cursor?

A CLI usa a mesma configuração do passo anterior. Para fazer o login, rode:

agent mcp login artia


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

Isso respondeu a sua pergunta?