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.

Tarifvoraussetzung

Der MCP-Server ist ab dem Starter-Tarif verfügbar. Jedes Adkumo-Konto kann sich authentifizieren und verbinden — dein Client zeigt den Server als verbunden mit der vollständigen Tool-Liste an — aber im Free-Tarif gibt jeder Tool-Aufruf eine Upgrade-Aufforderung zurück, statt ausgeführt zu werden. Führe unter app.adkumo.com/settings/billing ein Upgrade durch, um die Tools freizuschalten.

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.

Verbindung von einem entfernten oder SSH-Rechner

OAuth öffnet einen Browser und leitet an einen localhost-Callback auf dem Rechner weiter, der den Client ausführt. Läuft Claude Code auf einem entfernten oder SSH-Rechner, während dein Browser auf deinem Laptop ist, erreicht dieser Callback die CLI nicht und die Anmeldung scheint zu hängen. Zwei Lösungen:

Callback-Port weiterleiten. Lege ihn mit claude --callback-port 8765 ... fest, führe dann auf deinem Laptop ssh -L 8765:localhost:8765 <host> aus und schließe die Anmeldung im lokalen Browser ab.
Callback-URL einfügen. Schlägt die Browser-Weiterleitung nach der Freigabe fehl, kopiere die vollständige Callback-URL aus der Adressleiste und füge sie in die Eingabeaufforderung von Claude Code ein.

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	Token abgelaufen oder widerrufen — du bist abgemeldet	Auth-Flow neu starten: in Claude Code `claude mcp remove adkumo` und neu hinzufügen; in anderen Clients trennen und neu verbinden.
Tools antworten „Upgrade deinen Tarif"	Dein Tarif enthält keinen MCP-Zugriff	Der MCP-Server erfordert den Starter-Tarif oder höher. Die Verbindung funktioniert weiterhin, aber die Tools bleiben gesperrt, bis du unter app.adkumo.com/settings/billing ein Upgrade durchführst.
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.