> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getovra.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP-Setup

> @ovra/mcp mit jedem MCP-kompatiblen Client in unter einer Minute verbinden.

Zwei Transports, drei Schritte, eine Minute. Mit Streamable HTTP für Production starten und stdio für Desktop-Dev.

<Note>
  `sk_sandbox_*` oder `sk_test_*` Key verwenden. Der Server validiert deinen Key beim Startup und beendet sich bei Ungültigkeit oder Revocation.
</Note>

## Streamable HTTP (empfohlen)

Keine lokale Installation. Zur Client-Config hinzufügen:

```json theme={}
{
  "mcpServers": {
    "ovra": {
      "type": "streamable-http",
      "url": "https://api.getovra.com/api/mcp",
      "headers": {
        "Authorization": "Bearer sk_sandbox_..."
      }
    }
  }
}
```

## Stdio (lokaler Subprozess)

Startet den Server via npx — keine globale Installation nötig.

```json theme={}
{
  "mcpServers": {
    "ovra": {
      "command": "npx",
      "args": ["@ovra/mcp@latest"],
      "env": {
        "OVRA_API_KEY": "sk_sandbox_..."
      }
    }
  }
}
```

## Wo die Config liegt

| Client                   | Pfad                                                              |
| ------------------------ | ----------------------------------------------------------------- |
| Claude Desktop (macOS)   | `~/Library/Application Support/Claude/claude_desktop_config.json` |
| Claude Desktop (Windows) | `%APPDATA%\Claude\claude_desktop_config.json`                     |
| Claude Desktop (Linux)   | `~/.config/Claude/claude_desktop_config.json`                     |
| Cursor                   | `~/.cursor/mcp.json`                                              |
| Andere                   | Siehe Client-Doku                                                 |

## Umgebungsvariablen

| Variable           | Required   | Default                   | Beschreibung                                               |
| ------------------ | ---------- | ------------------------- | ---------------------------------------------------------- |
| `OVRA_API_KEY`     | Ja (stdio) | –                         | `sk_sandbox_*` / `sk_test_*` / `sk_live_*` (live in v1.3+) |
| `OVRA_AGENT_TOKEN` | Optional   | –                         | `at_*` Agent-scoped Token statt API-Key                    |
| `OVRA_API_URL`     | Nein       | `https://api.getovra.com` | Base-URL überschreiben                                     |

Du kannst **entweder** `OVRA_API_KEY` (org-weit) **oder** `OVRA_AGENT_TOKEN` (single-Agent) verwenden. Agent-Tokens geben dem LLM strikte Isolation — es sieht nur dieses einen Agents Karten, Intents und Transaktionen.

## Verifizieren

Nach Restart sollte dein Client 19 `ovra_*` Tools exposen. Smoke-Test mit:

```text theme={}
List my agents using ovra_agent action "get".
```

Wenn Tool-Liste leer ist:

1. Check dass `Authorization` Header / `OVRA_API_KEY` env-Wert korrekt gesetzt ist.
2. Bestätigen dass Key nicht revoked ist (`GET /keys` returnt aktive Liste).
3. MCP-Logs deines Clients tailen — Auth-Failures surface als `401` vom Bootstrap-Call.

## Startsequenz

<Steps>
  <Step title="Credentials lesen">
    Server liest `OVRA_API_KEY` oder `OVRA_AGENT_TOKEN` aus env (stdio) oder `Authorization`-Header (HTTP).
  </Step>

  <Step title="Health-Check">
    Boot ruft `GET /health` mit der Credential zur Validierung.
  </Step>

  <Step title="Tools registrieren">
    Valide Credential → registriert alle 19 Tools mit Schemas. Invalid → exit mit klarem Error.
  </Step>

  <Step title="Bereit">
    Client beginnt Tools zu discovern.
  </Step>
</Steps>

## Sicherheit in MCP

* Jede Tool-Response geht durch `redact()` bevor sie das Modell erreicht.
* Destruktive Aktionen verlangen `confirm: true`.
* IDs gegen Path-Traversal sanitized.
* Webhook- und Execute-URLs müssen HTTPS und SSRF-safe sein.

## Weiter

<CardGroup cols={2}>
  <Card title="Tool-Referenz" icon="book" href="/de/mcp/tools">
    Jede Action und Parameter.
  </Card>

  <Card title="MCP-Übersicht" icon="info" href="/de/mcp/overview">
    Architektur, Sicherheit, unterstützte Clients.
  </Card>

  <Card title="Claude Desktop" icon="comments" href="/de/integrations/claude-desktop">
    Step-by-Step Desktop-Setup.
  </Card>
</CardGroup>