MCP-Integration

PicRenew bietet einen Model Context Protocol (MCP)-Server, mit dem Sie die Fotorestaurierung direkt in KI-Clients wie Claude Desktop, Cursor und anderen MCP-kompatiblen Tools nutzen können — ohne Code zu schreiben. Model Context Protocol (MCP).

Endpoint

https://picrenew.com/api/mcp

Der MCP-Server verwendet Streamable HTTP-Transport (zustandslos). Derselbe Bearer-API-Schlüssel wie für die REST-API authentifiziert MCP-Anfragen. Siehe die Seite Authentifizierung für Schlüsselformat und Sicherheitsempfehlungen.

Claude Desktop konfigurieren

Fügen Sie PicRenew zur Claude Desktop MCP-Konfigurationsdatei hinzu ( ~/Library/Application Support/Claude/claude_desktop_config.json unter macOS):

{
  "mcpServers": {
    "picrenew": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://picrenew.com/api/mcp",
        "--header",
        "Authorization: Bearer pk_live_YOUR_KEY_HERE"
      ]
    }
  }
}

Starten Sie Claude Desktop nach dem Speichern neu. Die PicRenew-Tools sollten im Tool-Picker verfügbar sein.

Cursor konfigurieren

Fügen Sie Folgendes zu Ihrer Cursor- settings.json hinzu (oder im MCP-Panel in den Cursor-Einstellungen):

{
  "mcp": {
    "servers": {
      "picrenew": {
        "url": "https://picrenew.com/api/mcp",
        "headers": {
          "Authorization": "Bearer pk_live_YOUR_KEY_HERE"
        }
      }
    }
  }
}

Verfügbare Tools

restore_photo

Stellt ein Foto von einer öffentlichen URL wieder her und verbessert es.

Parameter	Typ	Erforderlich	Beschreibung
`image_url`	string	Yes	Öffentliche HTTPS-URL des wiederherzustellenden Fotos
`preset`	string	No	`standard \| enhance \| colorize \| upscale` (default: `standard`)
`resolution`	string	No	`1k \| 2k \| 4k` (default: `1k`)
`remove_frame`	boolean	No	Remove photo border before restoring (default: `false`)
`colorize`	boolean	No	Apply AI colorization (default: `false`)
`callback_url`	string	No	HTTPS-Webhook-URL zum Empfangen des abgeschlossenen Ergebnisses

Gibt ein JSON-Objekt zurück mit id, status, Verwenden Sie die id zum Abfragen mit get_restoration.

get_restoration

Gibt den aktuellen Status eines Wiederherstellungsauftrags zurück.

Parameter	Typ	Erforderlich	Beschreibung
`id`	string (UUID)	Yes	Von restore_photo zurückgegebene Wiederherstellungs-ID `restore_photo`

Gibt ein JSON-Objekt zurück mit status, output_url. Fragen Sie dieses Tool ab, bis status oder complete oder failed.

Beispielgespräch

You: Restore this old photo and colorize it:
     https://example.com/grandpa-1945.jpg

Claude: I'll restore and colorize that photo for you using PicRenew.
[calls restore_photo with preset="colorize"]

Restoration job started! ID: a1b2c3d4-...
Checking the status...
[calls get_restoration]

Your restored, colorized photo is ready:
https://public.blob.vercel-storage.com/...

Credits und Abrechnung

MCP-Anfragen verbrauchen Credits aus Ihrem PicRenew-Konto, identisch zur REST-API. Credits werden bei der Auftragserstellung abgebucht. Sehen Sie Ihr Guthaben und Ihre Nutzung auf der Kontoseite oder der Abrechnungsseite.

Hinweise

Der MCP-Server ist zustandslos — zwischen Anfragen wird keine Sitzung aufrechterhalten. Jeder Tool-Aufruf ist unabhängig.
Ratenlimits werden mit der REST-API geteilt (60 Anfragen/Minute pro API-Schlüssel).
Bilder werden von der angegebenen URL abgerufen und vor der Verarbeitung in den PicRenew-Speicher hochgeladen.