> ## 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.

# Claude Desktop

> Ovra in Claude Desktop nutzen mit einem JSON-Config-Block.

Claude Desktop spricht MCP nativ. Füg Ovra hinzu und das Chat-Fenster bekommt 19 `ovra_*` Tools.

<Note>
  Heute Sandbox-only. `sk_sandbox_*` oder `sk_test_*` Key verwenden.
</Note>

## Wo die Config liegt

| OS      | Pfad                                                              |
| ------- | ----------------------------------------------------------------- |
| macOS   | `~/Library/Application Support/Claude/claude_desktop_config.json` |
| Windows | `%APPDATA%\Claude\claude_desktop_config.json`                     |
| Linux   | `~/.config/Claude/claude_desktop_config.json`                     |

## Streamable HTTP (empfohlen)

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

## Stdio (lokaler Subprozess)

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

Claude Desktop neu starten. Das Tool-Menü sollte 19 `ovra_*` Tools listen.

## Beispiele

<AccordionGroup>
  <Accordion title="Spending prüfen">
    > „Zeig mir meine Agents und was sie in den letzten 30 Tagen ausgegeben haben."

    Claude ruft `ovra_agent { action: "get" }` und `ovra_transaction { action: "get" }`, antwortet mit einer Summary.
  </Accordion>

  <Accordion title="Einen Kauf tätigen">
    > „Kauf eine Domain auf namecheap.com für my-project.dev"

    Claude ruft `ovra_pay { action: "checkout", agentId, purpose, amount, merchant }` und reportet die Transaction-ID.
  </Accordion>

  <Accordion title="Policy inspizieren">
    > „Wäre ein Kauf über EUR 500 bei amazon.de für meinen Procurement-Agent erlaubt?"

    Claude ruft `ovra_policy { action: "get", agentId }` und erklärt das Limit.
  </Accordion>

  <Accordion title="Dispute filen">
    > „Öffne einen Dispute auf tx\_abc — Paket nie angekommen."

    Claude ruft `ovra_dispute { action: "file", transactionId: "tx_abc", reason: "not_received" }`. Plan-tier-gated (Business+).
  </Accordion>
</AccordionGroup>

## Empfohlene Tools

| Tool               | Zweck                                       |
| ------------------ | ------------------------------------------- |
| `ovra_pay`         | Voller Payment-Flow                         |
| `ovra_agent`       | Agents listen, Status prüfen                |
| `ovra_intent`      | Deklarieren und verifizieren                |
| `ovra_credential`  | Feingranulare Credential-Lifecycle          |
| `ovra_transaction` | History + Memo                              |
| `ovra_policy`      | Spend-Limits lesen                          |
| `ovra_config`      | API-Keys + Webhooks inspizieren (read-only) |

## Troubleshooting

* **Tools erscheinen nicht:** Claude Desktop voll beenden und neu starten — Re-Loading aus dem Menü refreshed MCP-Server nicht.
* **Auth-Errors:** `GET /keys` zur Bestätigung dass Key nicht revoked ist. Nach Rotate Config updaten.
* **Sandbox-Verwirrung:** Jede Ovra-Response trägt `X-Ovra-Mode: test|live`. In Sandbox immer `test`.

## Weiter

<CardGroup cols={2}>
  <Card title="MCP-Setup" icon="terminal" href="/de/mcp/setup">
    Andere Clients und erweiterte Config.
  </Card>

  <Card title="MCP-Tools" icon="book" href="/de/mcp/tools">
    Jede Action und Parameter.
  </Card>

  <Card title="Quickstart" icon="play" href="/de/quickstart">
    Fünf-Minuten End-to-End-Run.
  </Card>
</CardGroup>