Agentes de IA

Claude Code

O agente de programação da Anthropic, no terminal, no seu editor e na aplicação Claude para computador.

Liga-se com: Iniciar sessão, Chave de API, CLI e Skill
Conector: SPREVA
Planos: Qualquer plano Claude que inclua o Claude Code, ou uma chave de API da Anthropic.

Antes de começar

O Claude Code instalado e com sessão iniciada.

Configurar

1
Adicione o SPREVA como servidor remoto. --scope user torna-o disponível em todos os projetos:
Terminal
```
claude mcp add --transport http --scope user \
  spreva https://dev-app.spreva.ai/api/mcp
```
2
Inicie o Claude Code, execute /mcp, escolha spreva e inicie sessão. O seu navegador abre o SPREVA.
3
Inicie sessão, escolha a área de trabalho e clique em Permitir. De volta ao Claude Code, o spreva aparece como ligado.

Também funciona com

Chave de API num cabeçalho

Envie uma chave de API do SPREVA como token Bearer, para automatizações que funcionam sem uma pessoa.

Terminal

export SPREVA_API_KEY=POST_API_KEY_...
claude mcp add --transport http --scope user \
  spreva https://dev-app.spreva.ai/api/mcp \
  --header "Authorization: Bearer $SPREVA_API_KEY"

A CLI e a Agent Skill
Instale a linha de comandos spreva e a respetiva Agent Skill, para agentes que trabalham num terminal.
Terminal
```
export SPREVA_API_KEY=POST_API_KEY_...
npx -y @spreva/cli skill install --target claude
```

A ponte stdio da CLI

Execute spreva mcp como servidor MCP local, para aplicações que só iniciam servidores no seu computador.

Terminal

export SPREVA_API_KEY=POST_API_KEY_...
claude mcp add --transport stdio --scope user \
  --env SPREVA_API_KEY=$SPREVA_API_KEY \
  spreva -- npx -y @spreva/cli mcp

Confirmar que funciona

Inicie uma nova conversa e pergunte:

Peça ao seu agente

O que vai ser publicado esta semana no SPREVA?

Claude Code chama a ferramenta overview do SPREVA e responde com o fuso horário da área de trabalho, o que sai a seguir e o que precisa de atenção. Da primeira vez, Claude Code pode pedir-lhe que permita a ferramenta.

A ter em conta

Com uma chave de API num cabeçalho, uma chave rejeitada é indicada como falha: o Claude Code não recorre ao início de sessão.
Com sessão iniciada com uma subscrição Claude, os conectores que adicionou em claude.ai aparecem sozinhos no Claude Code.

Resolução de problemas

O SPREVA não aparece noutro projeto

Foi adicionado sem --scope user, por isso só um projeto o tem. Remova-o com claude mcp remove spreva e adicione-o novamente com o âmbito.

`/mcp` mostra o spreva como falhado

Verifique o URL com claude mcp get spreva. Se estiver correto, volte a iniciar sessão a partir de /mcp: a sessão pode ter expirado.

Outro problema? A Resolução de problemas aborda pedidos de início de sessão repetidos, planos, limites e fusos horários.