Claude Desktop

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

Heute Sandbox-only. sk_sandbox_* oder sk_test_* Key verwenden.

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)

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

Stdio (lokaler Subprozess)

{
  "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

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.

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.

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.

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+).

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

MCP-Setup

Andere Clients und erweiterte Config.

MCP-Tools

Jede Action und Parameter.

Quickstart

Fünf-Minuten End-to-End-Run.

​Wo die Config liegt

​Streamable HTTP (empfohlen)

​Stdio (lokaler Subprozess)

​Beispiele

​Empfohlene Tools

​Troubleshooting

​Weiter

MCP-Setup

MCP-Tools

Quickstart

Wo die Config liegt

Streamable HTTP (empfohlen)

Stdio (lokaler Subprozess)

Beispiele

Empfohlene Tools

Troubleshooting

Weiter