Claude Code

Claude Code no VS Code — extensão + CLI. O caminho mais direto.

Como conectar

O endpoint é sempre o mesmo. O que muda de sistema para sistema é só onde a configuração entra.

1
Instale a extensão Claude Code no VS Code
Procure por “Claude Code” no marketplace do VS Code, instale e faça login na sua conta Claude. A extensão é a interface gráfica dentro do editor.
2
Abra o terminal do VS Code
Atalho padrão: Ctrl + ` (crase).
3
Instale o Claude Code CLI
No Windows, pelo PowerShell:
irm https://claude.ai/install.ps1 | iex
4
Feche e abra novamente o terminal
É o que faz o PATH ser recarregado e o comando claude ficar disponível.

Confirme a instalação

claude --version

Esperado

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

6
Gere sua SEA API Key
Entre em searchitect.pro com sua conta, vá em Minha Conta → SEA API Keys e gere uma chave. Ela aparece uma única vez: copie e guarde em local seguro.
Formato da chave
sea_live_xxxxxxxxxxxxxxxxx

Conecte o SEA

No terminal, trocando SUA_CHAVE_SEA pela chave gerada:

claude mcp add --transport http --scope user SEA-Systems-Enterprise-Architect https://mcp.searchitect.pro/mcp --header "Authorization: Bearer SUA_CHAVE_SEA"

Esperado

O --scope user deixa o MCP disponível para o seu usuário em qualquer projeto do Claude Code.

Confirme

claude mcp list

Esperado

SEA-Systems-Enterprise-Architect: https://mcp.searchitect.pro/mcp (HTTP) - ✔ Connected

9
No painel do Claude Code, execute
É por ali que a extensão permite visualizar e gerenciar os MCPs configurados.
/mcp

Verifique

Esperado

SEA-Systems-Enterprise-Architect
✔ Connected

Precisa da chave? Ela é exibida uma única vez ao ser gerada, e pode ser rotacionada ou revogada a qualquer momento.

Gerar minha API Key

Caso de uso

Escrever uma integração sem inventar assinatura de serviço

A situação

Você vai implementar a sincronização de pedidos entre um e-commerce e o Sankhya. O modelo sozinho acerta a forma do código e erra o nome dos serviços.

O que você pede no Claude Code

Implemente o cliente de integração que cria pedidos de venda no Sankhya a partir do payload do e-commerce, com tratamento de erro e reprocessamento.

O que volta

O Claude Code chama o SEA por conta própria antes de escrever, recebe o contrato real do serviço e gera código que compila contra a API que existe. O ganho não é velocidade — é não descobrir o erro no homologação.

Teste se está funcionando

Primeiro um teste explícito, para confirmar que a ferramenta responde:

Use o SEA - Systems Enterprise Architect para analisar CRUDServiceProvider.loadRecords no Sankhya. Consulte o SEA antes de responder.

Depois o teste real, sem mencionar o SEA nem o Expert esperado. A ideia é verificar se o agente decide consultar o SEA automaticamente: ele deve chamar o servidor por conta própria, receber o roteamento do Core e responder com a evidência do Specialist.

Preciso consultar registros no Sankhya usando CRUDServiceProvider.loadRecords, retornando apenas alguns campos e aplicando critérios. Como devo estruturar essa chamada?

Deu 401 Unauthorized?

Confira, nesta ordem:

A chave foi copiada inteira, sem espaços nas pontas.
A chave não foi revogada nem rotacionada depois de configurada.
Sua conta Searchitect está ativa.
O acesso MCP está habilitado para a conta (mcp_enabled).
A chave não expirou.
O cliente realmente está enviando o header Authorization: Bearer.
No Claude web: o aplicativo não foi desconectado em Minha Conta → SEA API Keys. Se foi, refaça a conexão pelo próprio Claude.

Chaves revogadas e contas bloqueadas param de funcionar imediatamente. Se a chave se perdeu, rotacione-a em SEA API Keys — a antiga é invalidada na hora.