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.
1. URL del conector e inicio de sesión
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.
https://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 Agentes, donde también puedes desconectar cada app.
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:
Authorization: Bearer spreva_sk_...La mayoría de las apps la aceptan en su configuración JSON.
{
"mcpServers": {
"spreva": {
"type": "http",
"url": "https://app.spreva.ai/api/mcp",
"headers": {
"Authorization": "Bearer spreva_sk_..."
}
}
}
}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.
{
"mcpServers": {
"spreva": {
"command": "npx",
"args": [
"-y",
"@spreva/cli",
"mcp"
],
"env": {
"SPREVA_API_KEY": "spreva_sk_..."
}
}
}
}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 - 2
Dale tu clave de API:
Terminal export SPREVA_API_KEY=spreva_sk_... - 3
Instala la skill para tu agente. Los destinos son
claude,codex,openclaw,hermesyagents, 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.