MCP-Server

Adkumo stellt einen Model-Context-Protocol-Server bereit, sodass jeder MCP-Client — Claude Code, Claude Desktop, Cursor, ChatGPT — Adkumo steuern kann, ohne die native Chat-Oberfläche zu verlassen. Suche Unternehmen, durchstöbere Anzeigen, liste und erstelle Creatives und veröffentliche auf deinen verbundenen Ad-Plattformen, alles aus deinem Assistenten heraus.

Endpunkt

https://<project-ref>.supabase.co/functions/v1/mcp-server/mcp

Die genaue <project-ref> für deinen Workspace findest du in deiner Konto-URL. Beim Self-Hosting ersetze den Host durch deinen eigenen.

Authentifizierung

Die Authentifizierung läuft über OAuth 2.1 — du meldest dich einmal mit deinem Adkumo-Konto an, der Client speichert ein Refresh-Token und die Verbindung bleibt bestehen. Es gibt keine API-Keys zum Erzeugen oder Einfügen.

Beim ersten Verbinden eines Clients öffnet sich dein Browser zur Adkumo-Anmeldung. Nach der Freigabe erhält der Client ein kurzlebiges Access-Token plus ein Refresh-Token. Die Aktualisierung erfolgt automatisch — du meldest dich nur einmal an.

Claude Code verbinden

Ein Befehl in deinem Terminal:

claude mcp add adkumo \
  --transport http \
  --url https://<project-ref>.supabase.co/functions/v1/mcp-server/mcp

Claude Code öffnet einen Browser-Tab, du meldest dich bei Adkumo an, und die Verbindung steht. Prüfe mit claude mcp list.

Claude Desktop verbinden

Bearbeite ~/Library/Application Support/Claude/claude_desktop_config.json (macOS — passe den Pfad unter Windows / Linux an):

{
  "mcpServers": {
    "adkumo": {
      "type": "http",
      "url": "https://<project-ref>.supabase.co/functions/v1/mcp-server/mcp"
    }
  }
}

Starte Claude Desktop neu. Bei der ersten Nutzung öffnet sich dein Browser zur Anmeldung, danach erscheinen die Adkumo-Tools in jeder Unterhaltung im Tool-Picker.

Cursor verbinden

Füge denselben Server zu ~/.cursor/mcp.json (oder einer projektbezogenen .cursor/mcp.json) hinzu:

{
  "mcpServers": {
    "adkumo": {
      "url": "https://<project-ref>.supabase.co/functions/v1/mcp-server/mcp"
    }
  }
}

Lade Cursor neu und bestätige die Anmeldung bei Aufforderung.

Fehlerbehebung

Symptom	Wahrscheinliche Ursache	Lösung
401 Unauthorized bei jedem Aufruf	Refresh-Token abgelaufen oder widerrufen	Auth-Flow neu starten: in Claude Code `claude mcp remove adkumo` und neu hinzufügen; in anderen Clients trennen und neu verbinden.
405 Method Not Allowed	Der Client hat `GET` / `DELETE` an `/mcp` gesendet	Der Transport ist zustandslos und nur POST — meist eine Client-Fehlkonfiguration.
Tools wirken auf die falsche Marke	Eine andere Marke ist aktiv	Bitte den Client, die Marke zu wechseln — siehe Beispiele.

Sobald du verbunden bist, findest du im Beispiele-Abschnitt den vollständigen Tool-Katalog und Prompts zum Ausprobieren.