Primeros pasos

Formas de conectar

Cuatro formas de entrar, desde pegar una URL hasta usar una línea de comandos. Las cuatro llegan a las mismas herramientas, con los mismos permisos.

Cuál usar

Tu app puede añadir un conector o un servidor MCP remoto: usa la URL e inicia sesión. La mayoría de las apps pueden.
No hay nadie para hacer clic en Permitir, como en un script, un servidor o una tarea programada: usa una clave de API.
Tu app solo inicia servidores MCP en tu equipo: ejecuta el puente stdio de la CLI.
Tu agente trabaja en un terminal y usa skills: instala la CLI y la Agent Skill.

Tu app se comunica con SPREVA mediante Streamable HTTP de MCP y te identifica con OAuth. No hay ninguna clave que copiar ni guardar: eliges el espacio de trabajo en la propia página de SPREVA y puedes desconectar la app en cualquier momento.

URL

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

1
Pega la URL donde tu app añade un conector o un servidor MCP.
2
Tu app abre SPREVA. Inicia sesión, elige el espacio de trabajo y haz clic en Permitir.
3
Tú decides en SPREVA qué pueden hacer los agentes por su cuenta, en Ajustes y luego Agentes, donde también puedes desconectar cada app.

Recomendado. Funciona en Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini CLI, Kimi CLI y la mayoría de las apps que añaden servidores MCP por URL.

2. Clave de API en una cabecera

Para automatizaciones que funcionan sin una persona delante y para apps que no pueden iniciar sesión con OAuth. Crea una clave en SPREVA en Desarrollo y luego Claves de API, y envíala como token Bearer:

Cabecera

Authorization: Bearer POST_API_KEY_...

La mayoría de las apps la aceptan en su configuración JSON. Una clave funciona con los dos conectores.

JSON

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

Una clave pertenece a un espacio de trabajo, y cualquiera que la tenga puede actuar en él. No la pongas en archivos compartidos ni en repositorios, y revócala cuando ya no la necesites.

3. El puente stdio de la CLI

Algunas apps solo inician servidores MCP en tu propio equipo, mediante stdio. spreva mcp es un servidor de ese tipo: se ejecuta en local, lee tu clave de API de SPREVA_API_KEY y transmite cada llamada a 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"
      }
    }
  }
}

Necesita Node.js 20 o posterior. Las herramientas, las respuestas y los permisos son los mismos que a través de la URL.

4. La CLI y la Agent Skill

Los agentes que trabajan en un terminal, como OpenClaw, Hermes Agent, Claude Code y Codex, pueden usar SPREVA como línea de comandos. La Agent Skill les indica cuándo recurrir a ella y cómo.

1
Instala la CLI:
Terminal
```
npm i -g @spreva/cli
```

Dale tu clave de API:

Terminal

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

3
Instala la skill para tu agente. Los destinos son claude, codex, openclaw, hermes y agents, para cualquier otro agente compatible con skills:
Terminal
```
spreva skill install --target claude
```
4
Comprueba que todo está en su sitio:
Terminal
```
spreva doctor
```

Más información en CLI y Agent Skill.

Cuál usar

1. URL del conector e inicio de sesión

2. Clave de API en una cabecera

3. El puente stdio de la CLI

4. La CLI y la Agent Skill