Persönliches MCP

​

Passende Zugangsdaten wählen

​

Token erstellen und verbinden

1. Unter Dashboard → Agent Personal MCP öffnen.
2. Einen Namen, die benötigten Rechte und 1–365 Tage Gültigkeit wählen; Standard sind 30 Tage.
3. Für models:invoke oder utilities:invoke einen eigenen aktiven API-Schlüssel binden. Modellbeschränkungen, Budget und RPM bleiben wirksam. Kontodaten lassen sich ohne positives Guthaben lesen.
4. Den bei Erstellung angezeigten mcp_user_-Token in den Geheimnis-Einstellungen des Clients speichern. Nicht in Quelltext, Chats oder Logs einfügen. Bei Bedarf im selben Dashboard widerrufen.

​

Werkzeuge vor dem Aufruf prüfen

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_capabilities",
    "arguments": {}
  }
}

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "get_balance",
    "arguments": {
      "input": {}
    }
  }
}

​

Berechtigungen

​

Schreiben, Ergebnisse und sichere Wiederholung

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "update_api_key",
    "arguments": {
      "input": {
        "key_id": "YOUR_KEY_ID",
        "rpmLimit": 60
      },
      "idempotencyKey": "set-key-rpm-20261106-01"
    }
  }
}

{
  "execution_id": "EXECUTION_ID",
  "replayed": false,
  "status": "completed",
  "data": {
    "balance": 100,
    "key": null
  }
}

​

Modelle und Hilfsprogramme verwenden

{
  "jsonrpc": "2.0",
  "id": 4,
  "method": "tools/call",
  "params": {
    "name": "chat_completion",
    "arguments": {
      "input": {
        "body": {
          "model": "PUBLIC_MODEL_ID",
          "messages": [
            {
              "role": "user",
              "content": "Hello"
            }
          ],
          "stream": false
        }
      },
      "idempotencyKey": "chat-example-20261106-01"
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 6,
  "method": "tools/call",
  "params": {
    "name": "run_utility",
    "arguments": {
      "input": {
        "utility": "image-hash",
        "parameters": {},
        "files": {
          "image": [
            "YOUR_FILE_ID"
          ]
        }
      },
      "idempotencyKey": "image-hash-example-01"
    }
  }
}

​

Dateien hochladen und abrufen

1. begin_upload mit Dateiname, MIME-Typ und exakter Bytezahl aufrufen, höchstens 250 MiB.
2. upload_chunk mit nullbasiertem index und Base64-data aufrufen. Dekodierte Teile sind höchstens 1 MiB groß; die Indizes müssen bei null beginnen und lückenlos sein.
3. finish_upload mit file_id und optional kleingeschriebenem SHA-256 aufrufen. Erst bei status: ready verwenden.
4. Die ID an ein geeignetes Werkzeug übergeben. get_artifact liefert Metadaten oder mit offset Base64-Bytes. next_offset bis null folgen. Der Downloadlink verlangt die Website-Anmeldung des Eigentümers.

{
  "jsonrpc": "2.0",
  "id": 5,
  "method": "tools/call",
  "params": {
    "name": "begin_upload",
    "arguments": {
      "input": {
        "name": "example.png",
        "mime_type": "image/png",
        "size": 12345
      },
      "idempotencyKey": "upload-example-begin-01"
    }
  }
}

• upload_media: höchstens 20 Dateien / 250 MiB insgesamt.
• upload_image: eine Datei mit höchstens 50 MiB.
• edit_image: höchstens 20 Dateien über alle Felder, davon höchstens eine mask; 50 MiB pro Datei / 100 MiB insgesamt. Die Array-Grenzen je Feld aus dem Eingabeschema gelten weiterhin.
• run_utility: Datei-, Einzelgrößen- und Gesamtlimits aus get_utility_schema gelten. Die feste Obergrenze beträgt 250 MiB insgesamt, auch wenn der Katalog mehr zulässt.

​

Website-Bestätigung und Zahlungen

• API-Geheimwert: start_reveal_key_action → Nutzer bestätigt confirmation_url → reveal_api_key mit Aktions-id als action_id. Die Freigabe gilt für diesen Schlüssel und diese Zugangsdaten, läuft 15 Minuten nach Aktionserstellung ab und ist einmal nutzbar. create_api_key liefert nur Metadaten.
• Abo kündigen: cancel_subscription startet die Bestätigung. Der Nutzer führt sie auf der Website aus. Vor einer Erfolgsmeldung get_account_action und Abostatus prüfen.
• Passwort/Kontolöschung: start_account_action mit password_change oder delete_account. Codes und Passwörter gibt der Nutzer auf der Website ein, niemals beim Assistenten. Löschung widerruft den Zugriff und meldet ab; danach MCP nicht weiter abfragen.
• Zahlung: list_billing_products → create_checkout → Nutzer bezahlt → get_payment_status. Ein Link beweist keine Zahlung.
• Echte Nachrichten: resend_invoice und test_credit_alert senden E-Mail oder Webhook. Nur auf ausdrücklichen Wunsch ausführen.

​

Fehler ohne doppelte Arbeit behandeln

{
  "isError": true,
  "structuredContent": {
    "error": {
      "code": "execution_pending",
      "message": "The original execution is pending; inspect its receipt before retrying",
      "status": 409,
      "execution_id": "EXECUTION_ID"
    }
  }
}

​

Nützliche erste Leseabfragen

• Ausgaben prüfen: get_balance → summarize_usage → einzelne Anfragen mit list_usage.
• Fehler erklären: diagnose_request mit task_id; vor erneutem Modellaufruf Fehler und Erstattung prüfen.
• Integration vorbereiten: list_models → get_model_schema → get_api_guide, ohne Modellaufruf.
• Kontosicherheit prüfen: list_api_keys → get_api_key → list_login_records.