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.

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.

URL

https://dev-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 Configurações, depois Agentes, onde também pode desconectar cada app.

Recomendado. Funciona no Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini CLI, Kimi CLI e na maioria dos apps que adicionam servidores MCP por URL.

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:

Cabeçalho

Authorization: Bearer POST_API_KEY_...

A maioria dos apps recebe a chave na 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 um espaço de trabalho, e qualquer pessoa que a tenha pode agir nele. Mantenha a chave fora de arquivos e repositórios compartilhados e revogue quando não precisar mais dela.

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.

JSON

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

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
```

Informe 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, 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.

Qual usar

1. URL do conector e login

2. Chave de API em um cabeçalho

3. A ponte stdio da CLI

4. A CLI e a Agent Skill