CherryDrop logoCherryDrop
Anmelden

Für Entwickler

Bau CherryDrop in dein Produkt.

CherryDrop ist eine offene Inbox für KI-Agenten. Verbinde jeden MCP-Client, sende Drops per REST-API oder route deine eigenen Automationen — mit OAuth oder API-Keys.

Kostenlos startenAPI-Keys verwalten

Zwei Wege in die Inbox

MCP (Model Context Protocol)

Verbinde jeden MCP-Client (ChatGPT, Claude, Cursor, Claude Code, eigene Agenten). Auth läuft über OAuth 2.1 mit dem CherryDrop-Konto des jeweiligen Users — keine geteilten Keys.

REST-API

Für alles, was kein MCP spricht: Zapier, n8n, Cron-Jobs, eigene Server. Ein einzelner Endpoint, Bearer-Token per API-Key, Multipart oder JSON.

Endpoints & Discovery

Alle URLs sind öffentlich und CORS-freigeschaltet.

MCP-Server (Streamable HTTP)
https://cherry-drop.io/mcp
MCP Discovery
https://cherry-drop.io/.well-known/mcp.json
App-Manifest
https://cherry-drop.io/mcp-app.json
OAuth Protected-Resource Metadata
https://cherry-drop.io/.well-known/oauth-protected-resource
REST-Ingest (Drop erstellen)
https://cherry-drop.io/api/public/agent/ingest

MCP-Tools

Diese Tools werden über MCP an den Client ausgeliefert.

  • create_drop

    Speichert einen neuen Drop (Text, Notiz, Link, Code, Zitat, …) in die Inbox des angemeldeten Users.

  • list_recent_drops

    Gibt die zuletzt erstellten Drops zurück.

  • search_drops

    Volltext- und URL-Suche über die Drops des Users.

  • save_context

    Speichert oder aktualisiert einen benannten Context — den aktuellen Gesprächsstand — damit ein anderer Agent dort weitermacht.

  • load_context

    Lädt einen benannten Context (Zusammenfassung plus verknüpfte Drops) in den aktuellen Agenten.

  • list_contexts

    Listet die Contexts des Nutzers, neueste zuerst, inklusive zuletzt schreibendem Agenten.

Authentifizierung

OAuth 2.1 (für MCP)

MCP-Clients bekommen den Zugriff über den regulären OAuth-Flow. Dynamic Client Registration wird unterstützt — es sind keine vorregistrierten Clients nötig. Die Metadata-URL steht in der Well-Known-Datei.

Metadata-URL
https://cherry-drop.io/.well-known/oauth-protected-resource

API-Keys (für REST)

Erzeuge einen API-Key in deinen Einstellungen und sende ihn als Bearer-Token. Ein Key gehört immer genau einem User — Drops landen in dessen Inbox.

Key erzeugen

REST-API — einen Drop erstellen

Ein Endpoint für alles. Sende JSON oder Multipart. Anhänge bis 50 MB als Base64 oder Formdata.

Endpoint
POST https://cherry-drop.io/api/public/agent/ingest
cURL
curl -X POST https://cherry-drop.io/api/public/agent/ingest \
  -H "Authorization: Bearer $CHERRYDROP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "note",
    "content": "Hello from my script",
    "tags": ["ci"]
  }'
JavaScript / Node
const res = await fetch("https://cherry-drop.io/api/public/agent/ingest", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.CHERRYDROP_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    type: "link",
    url: "https://example.com/article",
    tags: ["reading"],
  }),
});
const drop = await res.json();
Python
import os, requests

r = requests.post(
    "https://cherry-drop.io/api/public/agent/ingest",
    headers={"Authorization": f"Bearer {os.environ['CHERRYDROP_API_KEY']}"},
    json={"type": "note", "content": "Hello from Python"},
)
r.raise_for_status()
drop = r.json()
Felder
  • type — optional. text, note, link, image, video, audio, document, pdf, code, quote, location, contact, event, other.
  • content — optional. Text-Inhalt (max. 20.000 Zeichen).
  • url — optional. Nur http(s). Wird automatisch angereichert (Titel, Vorschau).
  • file — optional. { filename, mime_type, data_base64 }. Alternativ Multipart-Feld „file".
  • tags — optional. Bis zu 10 Tags.
  • source_meta — optional. Freie Metadaten (JSON).

Rate-Limit: 60 Requests pro Minute je API-Key.

MCP-Konfig für eigene Clients

Für CLI-Agenten oder eigene Integrationen, die mcp.json lesen.

Cursor / Claude Code (`~/.cursor/mcp.json`)
{
  "mcpServers": {
    "cherrydrop": {
      "type": "http",
      "url": "https://cherry-drop.io/mcp"
    }
  }
}
Gemini CLI (`~/.gemini/settings.json`)
{
  "mcpServers": {
    "cherrydrop": {
      "httpUrl": "https://cherry-drop.io/mcp"
    }
  }
}

Standards, kein Lock-in

MCP ist ein offener Standard. Alles, was Streamable HTTP + OAuth 2.1 spricht, funktioniert direkt mit CherryDrop — auch selbstgebaute Agenten in Python, TypeScript, Go oder Rust.

Fragen?

Schreib uns kurz — wir helfen bei der Integration.

Kontakt aufnehmen