← Todas as conexões

Conectar no Claude Code

Claude Code no terminal ou no VS Code — login OAuth ou API Key.

Antes de começar, crie a sua conta gratuita.Criar conta

Qual MCP você vai conectar? Os comandos abaixo mudam conforme a escolha.

  1. 1

    Instale o Claude Code

    No VS Code, instale a extensão “Claude Code” pelo marketplace e faça login na sua conta Claude. Para o terminal, instale o CLI:

    Instalação do CLI
    macOS / Linux:  curl -fsSL https://claude.ai/install.sh | bash
    Windows:        irm https://claude.ai/install.ps1 | iex
  2. 2

    Confirme a instalação

    Feche e abra o terminal para recarregar o PATH, e confira:

    claude --version

    Esperado: Se retornar uma versão, o CLI está instalado corretamente.

  3. 3

    Cadastre o NewAlgorithm

    O --scope user deixa o NewAlgorithm disponível em qualquer projeto. Sem cabeçalho, a autenticação acontece por login OAuth no passo seguinte.

    claude mcp add --transport http --scope user NewAlgorithm-TOTVS https://totvs.mcp.newalgorithm.io/mcp
  4. 4

    Faça login

    Dentro do Claude Code, abra o gerenciador de MCP, escolha o NewAlgorithm e autentique. O navegador abre a autorização do NewAlgorithm (app.newalgorithm.io); entre com a sua conta e autorize.

    /mcp

    Esperado: NewAlgorithm-TOTVS ✔ Connected

  5. 5

    Alternativa: API Key no cabeçalho

    Para ambientes sem navegador, gere uma chave de API em app.newalgorithm.io → Chaves e apps e cadastre o servidor com o cabeçalho, trocando SUA_CHAVE pela chave:

    claude mcp add --transport http --scope user NewAlgorithm-TOTVS https://totvs.mcp.newalgorithm.io/mcp --header "Authorization: Bearer SUA_CHAVE"
  6. 6

    Confirme

    claude mcp list

    Esperado: NewAlgorithm-TOTVS: https://totvs.mcp.newalgorithm.io/mcp (HTTP) - ✔ Connected

Se você configurar o cabeçalho com uma chave inválida, o Claude Code não cai para o login OAuth: ele reporta falha. Corrija a chave ou remova o cabeçalho para usar o login.

Detalhes de autenticação e ferramentas na Documentação.