Ir para o conteúdo

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.

URL
https://app.spreva.ai/api/mcp
  1. 1

    Cole o URL onde o seu app adiciona um conector ou um servidor MCP.

  2. 2

    O seu app abre o SPREVA. Entre na sua conta, escolha o espaço de trabalho e clique em Permitir.

  3. 3

    Você decide o que os agentes podem fazer sozinhos no SPREVA, em 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 spreva_sk_...

A maioria dos apps recebe a chave na configuração JSON.

JSON
{
  "mcpServers": {
    "spreva": {
      "type": "http",
      "url": "https://app.spreva.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer spreva_sk_..."
      }
    }
  }
}
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": "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. 1

    Instale a CLI:

    Terminal
    npm i -g @spreva/cli
  2. 2

    Informe a sua chave de API:

    Terminal
    export SPREVA_API_KEY=spreva_sk_...
  3. 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. 4

    Confira se está tudo no lugar:

    Terminal
    spreva doctor

Mais em CLI e Agent Skill.