IA by DNACX

#8 no GitHub · Agir no código

Como instalar e usar o Serena: passo a passo

Um servidor MCP que dá à IA ferramentas parecidas com as de uma IDE: achar símbolos, ver quem usa cada função, renomear e editar código no nível do símbolo, em vez de buscar texto e linhas.

Para quem
Quem programa em projetos médios ou grandes e quer que o assistente navegue e altere código com mais precisão.
Estrelas (07/11/2026)
31.180, #8 no ranking
Licença
O repositório não declara uma licença única. Confira a licença antes de usar na empresa.
Repositório
oraios/serena

Passo a passo

Antes de começar: uv instalado (o README diz que é o único pré-requisito obrigatório); Python 3.13 gerenciado pelo uv, conforme o comando de instalação do README; Para algumas linguagens, dependências extras (a lista está na página Language Support); Um cliente MCP, como o Claude Code.

  1. Instale o uv

    O uv é o gerenciador que instala e roda o Serena. O README manda seguir o guia oficial de instalação do uv.

  2. Instale o Serena

    Cole o comando no terminal. Ao terminar, o comando 'serena' deve estar disponível.

    Comando
    uv tool install -p 3.13 serena-agent

  3. Inicialize e confira

    Rode o comando de inicialização. Ele verifica se a configuração está certa e mostra uma mensagem de sucesso. Por padrão usa os servidores de linguagem (a opção gratuita).

    Comando
    serena init

  4. Conecte ao Claude Code

    O README não traz o comando de conexão para o Claude Code. Ele manda seguir a página de configuração de clientes, que tem instruções específicas para o Claude Code. Abra essa página e siga o passo dela.

  5. Leia o fluxo de trabalho por projeto

    O README recomenda ler o guia do usuário, em especial sobre o fluxo de trabalho por projeto e sobre a configuração.

Primeiro teste

O README não traz um pedido de teste. Peça uma tarefa simples e confira se o servidor entra em ação.

Cuidados

  • O README manda não instalar o Serena por loja de MCP ou de plugins, porque elas têm comandos de instalação desatualizados e piores.
  • Entre as ferramentas básicas do Serena está execute_shell_command, que roda comandos de shell. O README diz que, dentro de agentes como o Claude Code, essas ferramentas básicas costumam vir desligadas por padrão.
  • O Serena tem um sistema de memória para fluxos longos, que pode ser desligado se você preferir outra solução.
  • A licença é por componente: SolidLSP sob MIT e o restante sob GPL-3.0 ou posterior. O plugin para JetBrains é pago, com teste gratuito.

Como desfazer

O README não traz um passo de remoção.

O que o README não confirma

Esta página foi montada lendo o README. Estes pontos não estão escritos lá:

  • O comando exato para conectar ao Claude Code: está na página de clientes do guia, fora do README.
  • Quais dependências extras sua linguagem exige.
  • Como remover o Serena.
  • Se o plugin para JetBrains vale o preço: o README não informa valores.

Dúvidas

Quais linguagens funcionam?

O README diz que o modo de servidores de linguagem suporta mais de 40 linguagens, incluindo Python, JavaScript, TypeScript, Java, Go, Rust e C#.

Preciso pagar?

O modo padrão usa servidores de linguagem gratuitos e de código aberto. O plugin para JetBrains é pago, com teste gratuito, segundo o README.

Serve só para o Claude Code?

Não. O README cita vários clientes, como Codex, Gemini CLI, VS Code, Cursor, JetBrains e Claude Desktop.

O que mudou na versão 2?

O README anuncia o Serena v2 com uma nova interface de agente baseada em REPL e remete a uma página de detalhes.

A DNACX usa o Serena?

Esta página foi montada a partir do README oficial. A DNACX não rodou cada passo, então confira a saída de cada comando e, se algo falhar, volte ao README do repositório.

Próximo da lista

← #7 Code Review Graph · #9 n8n-mcp →

Ver os 15 MCPs

Por Diogo Kammers, da DNACX. Passo a passo montado a partir do README oficial de oraios/serena, lido em . A DNACX não rodou cada passo desta página. O servidor é de terceiros e a DNACX não o criou.