Primeiros passos
Formas de conectar
Quatro formas de entrar, de colar um URL a rodar uma linha de comando. Todas as quatro chegam às mesmas ferramentas, com as mesmas permissões.
Qual usar
- O seu app consegue adicionar um conector ou um servidor MCP remoto: use o URL e entre na sua conta. A maioria dos apps consegue.
- Não tem ninguém para clicar em Permitir, como em um script, um servidor ou uma tarefa agendada: use uma chave de API.
- O seu app só inicia servidores MCP na sua máquina: rode a ponte stdio da CLI.
- O seu agente trabalha em um terminal e usa skills: instale a CLI e a Agent Skill.
1. URL do conector e login
O seu app se comunica com o SPREVA pelo Streamable HTTP do MCP e faz o seu login com OAuth. Não há chave para copiar nem guardar em segurança: você escolhe o espaço de trabalho na própria página do SPREVA e pode desconectar o app a qualquer momento.
https://app.spreva.ai/api/mcp- 1
Cole o URL onde o seu app adiciona um conector ou um servidor MCP.
- 2
O seu app abre o SPREVA. Entre na sua conta, escolha o espaço de trabalho e clique em Permitir.
- 3
Você decide o que os agentes podem fazer sozinhos no SPREVA, em Agentes, onde também pode desconectar cada app.
2. Chave de API em um cabeçalho
Para automações que rodam sem uma pessoa e para apps que não conseguem entrar com OAuth. Crie uma chave no SPREVA em Desenvolvimento, depois Chaves de API, e envie como token Bearer:
Authorization: Bearer spreva_sk_...A maioria dos apps recebe a chave na configuração JSON.
{
"mcpServers": {
"spreva": {
"type": "http",
"url": "https://app.spreva.ai/api/mcp",
"headers": {
"Authorization": "Bearer spreva_sk_..."
}
}
}
}3. A ponte stdio da CLI
Alguns apps só iniciam servidores MCP na sua própria máquina, por stdio. spreva mcp é um servidor assim: roda localmente, lê a sua chave de API de SPREVA_API_KEY e repassa cada chamada ao SPREVA.
{
"mcpServers": {
"spreva": {
"command": "npx",
"args": [
"-y",
"@spreva/cli",
"mcp"
],
"env": {
"SPREVA_API_KEY": "spreva_sk_..."
}
}
}
}Ele precisa do Node.js 20 ou mais recente. As ferramentas, as respostas e as permissões são as mesmas que pelo URL.
4. A CLI e a Agent Skill
Agentes que trabalham em um terminal, como OpenClaw, Hermes Agent, Claude Code e Codex, podem usar o SPREVA como linha de comando. A Agent Skill diz a eles quando recorrer a ela e como.
- 1
Instale a CLI:
Terminal npm i -g @spreva/cli - 2
Informe a sua chave de API:
Terminal export SPREVA_API_KEY=spreva_sk_... - 3
Instale a skill para o seu agente. Os destinos são
claude,codex,openclaw,hermeseagents, para qualquer outro agente compatível com skills:Terminal spreva skill install --target claude - 4
Confira se está tudo no lugar:
Terminal spreva doctor
Mais em CLI e Agent Skill.