Server MCP

Adkumo espone un server Model Context Protocol, così qualsiasi client MCP — Claude Code, Claude Desktop, Cursor, ChatGPT — può guidare Adkumo senza lasciare la sua interfaccia di chat nativa. Cerca aziende, sfoglia annunci, elenca e crea creatività e pubblica sulle tue piattaforme pubblicitarie collegate, tutto dal tuo assistente.

Endpoint

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

La <project-ref> esatta del tuo workspace è nell'URL del tuo account. Se fai self-hosting, sostituisci l'host con il tuo.

Autenticazione

L'autenticazione usa OAuth 2.1 — accedi una volta con il tuo account Adkumo, il client memorizza un refresh token e la connessione resta attiva. Nessuna chiave API da generare o incollare.

La prima volta che colleghi un client, il browser si apre sull'accesso ad Adkumo. Dopo l'approvazione, il client riceve un access token a breve durata più un refresh token. Il refresh avviene automaticamente — accedi solo una volta.

Collegare Claude Code

Un comando nel terminale:

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

Claude Code apre una scheda del browser, accedi ad Adkumo e la connessione è attiva. Verifica con claude mcp list.

Collegare Claude Desktop

Modifica ~/Library/Application Support/Claude/claude_desktop_config.json (macOS — adatta il percorso su Windows / Linux):

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

Riavvia Claude Desktop. Al primo utilizzo apre il browser per l'accesso, poi gli strumenti Adkumo compaiono nel selettore di strumenti in ogni conversazione.

Collegare Cursor

Aggiungi lo stesso server a ~/.cursor/mcp.json (o un .cursor/mcp.json a livello di progetto):

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

Ricarica Cursor e approva l'accesso quando richiesto.

Risoluzione dei problemi

Sintomo	Causa probabile	Soluzione
401 Unauthorized a ogni chiamata	Refresh token scaduto o revocato	Riavvia il flusso di auth: in Claude Code usa `claude mcp remove adkumo` e ri-aggiungi; negli altri client disconnetti e riconnetti.
405 Method Not Allowed	Il client ha inviato `GET` / `DELETE` a `/mcp`	Il transport è stateless e solo POST — di solito una configurazione errata del client.
Gli strumenti agiscono sul brand sbagliato	È attivo un brand diverso	Chiedi al client di cambiare brand — vedi Esempi.

Una volta collegato, vedi Esempi per il catalogo completo degli strumenti e prompt da provare.