Primeiros passos

Formas de ligar

Quatro formas de ligar, de colar um URL a usar uma linha de comandos. As quatro chegam às mesmas ferramentas, com as mesmas permissões.

Qual usar

A sua aplicação consegue adicionar um conector ou um servidor MCP remoto: use o URL e inicie sessão. A maioria consegue.
Não há ninguém para clicar em Permitir, como num script, num servidor ou numa tarefa agendada: use uma chave de API.
A sua aplicação só inicia servidores MCP no seu computador: execute a ponte stdio da CLI.
O seu agente trabalha num terminal e usa skills: instale a CLI e a Agent Skill.

A sua aplicação comunica com o SPREVA através do Streamable HTTP do MCP e inicia sessão com OAuth. Não há nenhuma chave para copiar ou guardar em segurança: escolhe a área de trabalho na própria página do SPREVA e pode desligar a aplicação a qualquer momento.

URL

https://dev-app.spreva.ai/api/mcp

1
Cole o URL onde a sua aplicação adiciona um conector ou um servidor MCP.
2
A sua aplicação abre o SPREVA. Inicie sessão, escolha a área de trabalho e clique em Permitir.
3
O que os agentes podem fazer sozinhos é decidido por si no SPREVA, em Definições, depois Agentes, onde também pode desligar cada aplicação.

Recomendado. Funciona no Claude, no ChatGPT, no Cursor, no Claude Code, no Codex, no Gemini CLI, no Kimi CLI e na maioria das aplicações que adicionam servidores MCP através de um URL.

2. Chave de API num cabeçalho

Para automatizações que funcionam sem uma pessoa e para aplicações que não conseguem iniciar sessão com OAuth. Crie uma chave no SPREVA em Desenvolvimento, depois Chaves de API, e envie-a como token Bearer:

Cabeçalho

Authorization: Bearer POST_API_KEY_...

A maioria das aplicações aceita-a na respetiva configuração JSON. Uma chave funciona com os dois conectores.

JSON

{
  "mcpServers": {
    "spreva": {
      "type": "http",
      "url": "https://dev-app.spreva.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer POST_API_KEY_..."
      }
    }
  }
}

Uma chave pertence a uma área de trabalho e qualquer pessoa que a tenha pode agir nela. Mantenha-a fora de ficheiros e repositórios partilhados e revogue-a quando já não precisar dela.

3. A ponte stdio da CLI

Algumas aplicações só iniciam servidores MCP no seu próprio computador, através de stdio. spreva mcp é um desses servidores: é executado localmente, lê a sua chave de API de SPREVA_API_KEY e encaminha cada chamada para o SPREVA.

JSON

{
  "mcpServers": {
    "spreva": {
      "command": "npx",
      "args": [
        "-y",
        "@spreva/cli",
        "mcp"
      ],
      "env": {
        "SPREVA_API_KEY": "POST_API_KEY_...",
        "SPREVA_URL": "https://dev-app.spreva.ai"
      }
    }
  }
}

Precisa do Node.js 20 ou posterior. As ferramentas, as respostas e as permissões são as mesmas que através do URL.

4. A CLI e a Agent Skill

Os agentes que trabalham num terminal, como o OpenClaw, o Hermes Agent, o Claude Code e o Codex, podem usar o SPREVA como linha de comandos. A Agent Skill diz-lhes quando e como recorrer a ele.

1
Instale a CLI:
Terminal
```
npm i -g @spreva/cli
```

Indique a sua chave de API:

Terminal

export SPREVA_API_KEY=POST_API_KEY_...
export SPREVA_URL=https://dev-app.spreva.ai

3
Instale a skill para o seu agente. Os destinos são claude, codex, openclaw, hermes e agents, este último para qualquer outro agente que suporte skills:
Terminal
```
spreva skill install --target claude
```
4
Verifique se está tudo pronto:
Terminal
```
spreva doctor
```

Mais informação em CLI e Agent Skill.

Qual usar

1. URL do conector e início de sessão

2. Chave de API num cabeçalho

3. A ponte stdio da CLI

4. A CLI e a Agent Skill