Zum Hauptinhalt springen

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.

Das OpenAI Agents SDK spricht MCP nativ. Plugge Ovra ein und deine Agents picken alle 19 Tools auf — ovra_pay, ovra_card, ovra_intent, der Rest — ohne Tool-Wrapper schreiben zu müssen.
Heute Sandbox-only. sk_sandbox_* oder sk_test_* Key verwenden.

​
Installation

pip install openai-agents

​
Hosted MCP (empfohlen)

OpenAI ruft Ovra direkt — kein lokaler Subprozess. 
from agents import Agent, HostedMCPTool, Runner

agent = Agent(
    name="Procurement Agent",
    instructions=(
        "Du kaufst Bürobedarf unter EUR 100. "
        "Immer einen Intent deklarieren bevor Credentials angefordert werden. "
        "Niemals den User nach Kartennummern fragen — Ovra handled das."
    ),
    model="gpt-4.1",
    tools=[
        HostedMCPTool(
            tool_config={
                "type": "mcp",
                "server_label": "ovra",
                "server_url": "https://api.getovra.com/api/mcp",
                "headers": {"Authorization": "Bearer sk_sandbox_..."},
                "require_approval": "never",
            }
        )
    ],
)

​
Streamable HTTP (Self-hosted)

from agents import Agent
from agents.mcp import MCPServerStreamableHttp

ovra = MCPServerStreamableHttp(
    url="https://api.getovra.com/api/mcp",
    headers={"Authorization": "Bearer sk_sandbox_..."},
)

agent = Agent(
    name="Procurement Agent",
    instructions="Du kaufst Bürobedarf unter EUR 100.",
    model="gpt-4.1",
    mcp_servers=[ovra],
)

​
Ausführen

result = await Runner.run(
    agent,
    "Kauf einen USB-C Hub unter EUR 30 auf amazon.de"
)
print(result.final_output)

​
Payment-Flow den der Agent ausführt

1

Intent deklarieren

ovra_intent { action: "declare", agentId, purpose, expectedAmountEuros, expectedMerchant }
2

Credential minten

ovra_pay { action: "checkout", ... } (oder handle_402 für MPP-Merchants)
3

Beim Merchant zahlen

Entweder MPP (server-zu-server) oder CUA (Browser-Autofill).
4

Verifizieren + schließen

ovra_intent { action: "verify", ... } um Actual-Amount aufzuzeichnen.

​
Empfohlene Tools

ToolZweck
ovra_payVoller Flow in einem Call
ovra_intentDeklarieren und verifizieren
ovra_credentialFeingranulare Credential-Lifecycle
ovra_transactionHistory lesen
ovra_policySpend-Limits vor Deklaration inspizieren

​
Menschliche Freigabe

Für Policies mit enforcementLevel: "approve" landen Intents in pending_approval. Das OpenAI Agents SDK supports Human-in-the-Loop Checkpoints; pausieren bis deine Approval-Surface den Intent auf approved flippt.

​
Weiter

MCP-Übersicht

Architektur und volle 19-Tool-Liste.

LangGraph

Stateful Agent-Graphs.

CrewAI

Multi-Agent-Teams mit Rollen-Trennung.