Erste Schritte

Verbindungswege

Vier Wege, von einer eingefügten URL bis zur Kommandozeile. Alle vier führen zu denselben Tools, mit denselben Berechtigungen.

Welcher Weg passt

Deine App kann einen Konnektor oder einen Remote-MCP-Server hinzufügen: Nimm die URL und melde dich an. Die meisten Apps können das.
Niemand ist da, um auf Erlauben zu klicken, etwa bei einem Skript, einem Server oder einem geplanten Job: Nimm einen API-Schlüssel.
Deine App startet MCP-Server nur auf deinem Rechner: Starte die stdio-Brücke der CLI.
Dein Agent arbeitet im Terminal und nutzt Skills: Installiere die CLI und den Agent Skill.

Deine App spricht mit SPREVA über Streamable HTTP von MCP und meldet dich mit OAuth an. Es gibt keinen Schlüssel, den du kopieren oder sicher aufbewahren musst: Du wählst den Workspace auf der eigenen Seite von SPREVA und kannst die App jederzeit trennen.

URL

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

1
Füge die URL dort ein, wo deine App einen Konnektor oder einen MCP-Server hinzufügt.
2
Deine App öffnet SPREVA. Melde dich an, wähle den Workspace und klicke auf Erlauben.
3
Was Agenten allein tun dürfen, legst du in SPREVA unter Einstellungen, dann Agenten fest. Dort kannst du auch jede App trennen.

Empfohlen. Das funktioniert in Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini CLI, Kimi CLI und den meisten Apps, die MCP-Server per URL hinzufügen.

2. API-Schlüssel im Header

Für Automatisierungen, die ohne eine Person laufen, und für Apps, die sich nicht mit OAuth anmelden können. Erstelle in SPREVA unter Entwicklung, dann API-Schlüssel einen Schlüssel und sende ihn als Bearer-Token:

Header

Authorization: Bearer POST_API_KEY_...

Die meisten Apps nehmen ihn in ihrer JSON-Konfiguration auf. Ein Schlüssel funktioniert mit beiden Konnektoren.

JSON

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

Ein Schlüssel gehört zu einem Workspace, und wer ihn hat, kann dort handeln. Halte ihn aus geteilten Dateien und Repositorys heraus und widerrufe ihn, wenn du ihn nicht mehr brauchst.

3. Die stdio-Brücke der CLI

Manche Apps starten MCP-Server nur auf deinem eigenen Rechner, über stdio. spreva mcp ist so ein Server: Er läuft lokal, liest deinen API-Schlüssel aus SPREVA_API_KEY und leitet jeden Aufruf an SPREVA weiter.

JSON

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

Er braucht Node.js 20 oder neuer. Tools, Antworten und Berechtigungen sind dieselben wie über die URL.

4. Die CLI und der Agent Skill

Agenten, die im Terminal arbeiten, wie OpenClaw, Hermes Agent, Claude Code und Codex, können SPREVA als Kommandozeile nutzen. Der Agent Skill sagt ihnen, wann und wie sie darauf zurückgreifen.

1
Installiere die CLI:
Terminal
```
npm i -g @spreva/cli
```

Gib ihr deinen API-Schlüssel:

Terminal

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

3
Installiere den Skill für deinen Agenten. Die Ziele sind claude, codex, openclaw, hermes und agents, für jeden anderen Agenten, der Skills unterstützt:
Terminal
```
spreva skill install --target claude
```
4
Prüfe, ob alles bereit ist:
Terminal
```
spreva doctor
```

Mehr unter CLI und Agent Skill.

Welcher Weg passt

1. Konnektor-URL und Anmeldung

2. API-Schlüssel im Header

3. Die stdio-Brücke der CLI

4. Die CLI und der Agent Skill